JSON returns the JSON representation of the log entry

Info logs at info level

Execution - returns streaming events instead of raw strings

Close shuts down the engine gracefully.

String returns a human-readable representation of the signal.

GetCurrentUser returns the current user's profile information GET /api/users/me

Warn logs at warning level

Error implements the error interface.

Helper: Convert semantic version to string

Set stores a query result in cache

Close shuts down the broadcaster and cleanup goroutine

Helper functions for convenience Debug logs at debug level

Set stores a response in the cache

Done returns a channel that is closed when the subscriber is unsubscribed. SSE handlers can select on this to detect clean shutdown.

Plain text content (computed)

Close releases resources held by the client.

Log writes a log entry at the specified level

Get handles GET /api/v1/sandbox/edit/:id Response: {"sandbox": SandboxEdit}

setupGin switches Gin to test mode and returns a recorder + context.

Register a handler for incoming events.

injectUser plants a BetterAuthUser into a Gin context so handlers that call middleware.GetCurrentUser() succeed without real auth middleware.

Set caches user data for a session token

Pool returns the database pool.

* Parse a transcript into a structured VoiceCommand

Close shuts down the CARRIER client gracefully. Pending synchronous Send calls will receive a FallbackError with ReasonDisconnected.

Error implements the error interface so ResponseError can be used with standard Go error handling idioms.

* Update a record

GenerateTestID generates a unique test identifier

newOAuthHandler creates a handler with no database (pool = nil). Sufficient for tests that only test the redirect/state logic and don't hit storeOAuth

Name returns the unique identifier for this skill

─── JSON encode helpers ──────────────────────────────────────────────────────

* Delete a record

CreateTestActionContext creates a minimal ActionContext for testing

Get retrieves a skill by name

Helper functions

newHandlerNoPool creates an OSAAppsHandler with nil pool/queries — sufficient for testing paths that return before any DB call (auth + ID parse branch

RegisterAction registers an action handler.

─── constructor ────────────────────────────────────────────────────────────

oauthRouter creates a Gin engine for OAuth handler tests. userID is injected into context to simulate an authenticated user.

respondError sends a JSON error response. Internal error details are logged server-side but never exposed to clients.

Error implements the error interface.

Flush flushes the writer if it supports flushing

============================================================================ Helper Functions (table-specific to avoid conflicts) ====================

Close cleanups the container manager and Docker client

Publish broadcasts a build event to all subscribers for the given app. Critical events (generation_complete, error, generation_failed) use a blocking

RunActionTest runs a single action test

newEmptyResult returns a fresh ValidationResult with Allowed=true and no violations.

setupTestDB creates a test database connection In production, this would use testcontainers, but for now we'll use a simple in-memory approach

Get retrieves an agent by ID. Returns an error (not a panic) if not found.

GetUserRole gets a user's role in a workspace

Get retrieves a response from the cache

createIntTestUserWithSession creates a user and session for integration tests

─── constructor ────────────────────────────────────────────────────────────

redirectWithError redirects back to frontend with an error message.

Trigger a synthetic surface push to all listeners of a subscription.

Respond sends the error response and logs it

--------------------------------------------------------------------------- Test helpers -------------------------------------------------------------

newGinContext returns a recorder + context pair wired to the given method, path, and body. Sets Content-Type: application/json.

cleanupWorkflows removes test workflows from database

createTestWorkspace creates a test workspace in the database

newBlock creates a test ContextBlock.

============================================================================ Safe response helpers ===================================================

Subscribe creates a new subscription for build events for a specific app. Returns a subscriber that can receive events via the Events channel. If even

isValidPath validates path parameters to prevent directory traversal attacks