Documentation
¶
Overview ¶
Package wire defines the internal JSON protocol exchanged by agent runtimes and Airlock. It is not the author-facing Agents SDK API.
Index ¶
- Constants
- func AgentDefinitionHash(def AgentDefinition) (string, error)
- func CheckAppRuntimeProtocol(reported string) error
- func EncodeCallerHeader(c Caller) (string, error)
- func ResolveDisplayPart(part *DisplayPart)
- func ValidateAgentDefinitions(manifest AgentManifest) error
- type Access
- type Action
- type AgentBudget
- type AgentCallsRequest
- type AgentCancelResult
- type AgentDefinition
- type AgentManifest
- type AgentReply
- type AgentRunInfo
- type AgentRunResponse
- type AgentToolDefinition
- type AgentWaitRequest
- type AgentWaitResult
- type AuthInjection
- type AuthInjectionType
- type BindingMode
- type Caller
- type CallerOrigin
- type CallerUser
- type Capabilities
- type ConnectionAuth
- type ConnectionDef
- type ConnectorJobInfo
- type ConnectorJobProgress
- type ConnectorNeedDef
- type ConnectorOrchestrationInfo
- type ConnectorOrchestrationRequest
- type ContinueAgentRequest
- type CreateRunRequest
- type CreateRunResponse
- type DirectoryDef
- type DirectoryScope
- type DisplayPart
- type EnqueueJobErrorResponse
- type EnqueueJobRequest
- type EnqueueJobResponse
- type EnvVarDef
- type EnvVarValueResponse
- type FileInfo
- type GetJobResponse
- type HTTPRequest
- type HTTPResponse
- type InstructionDef
- type JobCronDef
- type JobHandlerDef
- type JobInfo
- type JobManifest
- type JobProgress
- type JobRunRequest
- type JobRunResponse
- type LLMProxyRequest
- type ListAgentRunsResponse
- type ListJobsResponse
- type ListMembersResponse
- type LogEntry
- type LogLevel
- type MCPAuth
- type MCPAuthStatus
- type MCPContent
- type MCPDef
- type MCPResourceContent
- type MCPToolCallRequest
- type MCPToolCallResponse
- type MCPToolSchema
- type Member
- type MemberUser
- type ModelProxyRequest
- type ModelSlotDef
- type PrintRequest
- type PromptData
- type PromptInput
- type ProxyRequest
- type RouteDef
- type RunCompleteRequest
- type RuntimeAgentDefinition
- type RuntimeAttachment
- type RuntimeContext
- type RuntimeInvokeRequest
- type RuntimeInvokeResponse
- type RuntimeJobContext
- type SealRequest
- type SealResponse
- type SearchProxyRequest
- type SessionAppendRequest
- type SessionAppendResponse
- type SessionCompactRequest
- type SessionCompactResponse
- type SessionLoadResponse
- type ShareFileRequest
- type ShareFileResponse
- type StartAgentRequest
- type StartupHookDef
- type StaticAssetDef
- type StorageFileRef
- type StorageFileRefRequest
- type StorageSetIndexRequest
- type SyncRequest
- type SyncResponse
- type ToolDef
- type TopicDef
- type TopicEnrollment
- type TopicSubscriptionRequest
- type UnsealRequest
- type UnsealResponse
- type UpdateJobProgressRequest
- type UpgradeRequest
- type WebhookDef
Constants ¶
const ( ErrorKindPlatform = "platform" ErrorKindAgent = "agent" )
const AppRuntimeProtocol = "airlock.app-runtime.v3"
AppRuntimeProtocol identifies the app capability execution contract, independent of SDK semver and the JavaScript executor's framed protocol.
const CallerHeader = "X-Airlock-Caller"
const InvocationTokenHeader = "X-Airlock-Invocation-Token"
const RuntimeInvokePath = "/__air/runtime/invoke"
const TestExecutorContentType = "application/vnd.airlock.jsexec"
Variables ¶
This section is empty.
Functions ¶
func AgentDefinitionHash ¶ added in v0.7.0
func AgentDefinitionHash(def AgentDefinition) (string, error)
AgentDefinitionHash hashes the entire declaration except ContractHash. JSON object key order and whitespace are canonicalized; array order is significant.
func CheckAppRuntimeProtocol ¶ added in v0.7.0
func EncodeCallerHeader ¶ added in v0.7.0
func ResolveDisplayPart ¶
func ResolveDisplayPart(part *DisplayPart)
func ValidateAgentDefinitions ¶ added in v0.7.0
func ValidateAgentDefinitions(manifest AgentManifest) error
ValidateAgentDefinitions validates private contracts and their manifest-local references, including exact hashes and a maximum of one child level.
Types ¶
type AgentBudget ¶ added in v0.7.0
type AgentCallsRequest ¶ added in v0.7.0
type AgentCallsRequest struct {
IDs []string `json:"ids"`
}
type AgentCancelResult ¶ added in v0.7.0
type AgentCancelResult struct {
Calls []AgentRunInfo `json:"calls"`
}
type AgentDefinition ¶ added in v0.7.0
type AgentDefinition struct {
Slug string `json:"slug"`
Description string `json:"description"`
Instructions string `json:"instructions"`
ModelSlot string `json:"modelSlot"`
InputSchema json.RawMessage `json:"inputSchema"`
OutputSchema json.RawMessage `json:"outputSchema"`
ContractHash string `json:"contractHash"`
Tools []AgentToolDefinition `json:"tools,omitempty"`
MCPs []string `json:"mcps,omitempty"`
Subagents []string `json:"subagents,omitempty"`
Budget AgentBudget `json:"budget"`
MaxAttempts int32 `json:"maxAttempts"`
MaxConcurrency int32 `json:"maxConcurrency"`
MaxSubagentCalls int32 `json:"maxSubagentCalls"`
MaxConcurrentSubagents int32 `json:"maxConcurrentSubagents"`
}
type AgentManifest ¶ added in v0.5.0
type AgentManifest struct {
RuntimeProtocol string `json:"runtimeProtocol"`
Version string `json:"version"`
Description string `json:"description"`
Emoji string `json:"emoji"`
Tools []ToolDef `json:"tools"`
Webhooks []WebhookDef `json:"webhooks"`
JobHandlers []JobHandlerDef `json:"jobHandlers"`
JobCrons []JobCronDef `json:"jobCrons"`
Routes []RouteDef `json:"routes"`
Topics []TopicDef `json:"topics"`
MCPServers []MCPDef `json:"mcpServers"`
Connections []ConnectionDef `json:"connections"`
EnvVars []EnvVarDef `json:"envVars"`
Directories []DirectoryDef `json:"directories"`
Instructions []InstructionDef `json:"instructions"`
ModelSlots []ModelSlotDef `json:"modelSlots"`
StaticAssets []StaticAssetDef `json:"staticAssets"`
StartupHooks []StartupHookDef `json:"startupHooks"`
Connectors []ConnectorNeedDef `json:"connectors"`
AgentDefinitions []AgentDefinition `json:"agentDefinitions,omitempty"`
}
AgentManifest is the complete canonical declaration of an agent image. The SDK emits it in offline manifest mode and sends the same value during runtime synchronization. Slices are deterministically ordered by their identifiers, except Instructions and StartupHooks, whose registration order is semantic.
type AgentReply ¶ added in v0.7.0
type AgentReply struct {
Kind string `json:"kind"`
Output json.RawMessage `json:"output,omitempty"`
Question string `json:"question,omitempty"`
}
type AgentRunInfo ¶ added in v0.7.0
type AgentRunInfo struct {
ID string `json:"id"`
SessionID string `json:"sessionId"`
Definition string `json:"definition"`
ContractHash string `json:"contractHash"`
Status string `json:"status"`
Error string `json:"error,omitempty"`
Reply *AgentReply `json:"reply,omitempty"`
Steps int64 `json:"steps"`
Tokens int64 `json:"tokens"`
CreatedAt time.Time `json:"createdAt"`
UpdatedAt time.Time `json:"updatedAt"`
StartedAt *time.Time `json:"startedAt,omitempty"`
CompletedAt *time.Time `json:"completedAt,omitempty"`
}
type AgentRunResponse ¶ added in v0.7.0
type AgentRunResponse struct {
Run AgentRunInfo `json:"run"`
Created bool `json:"created"`
}
type AgentToolDefinition ¶ added in v0.7.0
type AgentToolDefinition struct {
Name string `json:"name"`
Description string `json:"description"`
LLMHint string `json:"llmHint,omitempty"`
InputSchema json.RawMessage `json:"inputSchema"`
OutputSchema json.RawMessage `json:"outputSchema"`
InputExamples []json.RawMessage `json:"inputExamples,omitempty"`
}
type AgentWaitRequest ¶ added in v0.7.0
type AgentWaitResult ¶ added in v0.7.0
type AgentWaitResult struct {
Reason string `json:"reason"`
Completed []AgentRunInfo `json:"completed"`
Pending []string `json:"pending"`
}
type AuthInjection ¶
type AuthInjection struct {
Type AuthInjectionType `json:"type"`
Name string `json:"name,omitempty"`
}
type AuthInjectionType ¶
type AuthInjectionType string
const ( AuthInjectBearer AuthInjectionType = "bearer" AuthInjectAPIKey AuthInjectionType = "api_key_header" AuthInjectPathPrefix AuthInjectionType = "path_prefix" AuthInjectQueryParam AuthInjectionType = "query_param" )
type BindingMode ¶ added in v0.8.1
type BindingMode string
const ( BindingPerUser BindingMode = "per_user" )
type Caller ¶ added in v0.7.0
type Caller struct {
Kind string `json:"kind"`
Access Access `json:"access"`
User *CallerUser `json:"user,omitempty"`
Initiator *CallerUser `json:"initiator,omitempty"`
Origin CallerOrigin `json:"origin"`
}
Caller is host-attributed execution metadata, not an authentication credential.
func DecodeCallerHeader ¶ added in v0.7.0
type CallerOrigin ¶ added in v0.7.0
type CallerUser ¶ added in v0.7.0
type Capabilities ¶
type ConnectionAuth ¶
type ConnectionAuth string
const ( ConnectionAuthOAuth ConnectionAuth = "oauth" ConnectionAuthToken ConnectionAuth = "token" ConnectionAuthNone ConnectionAuth = "none" )
type ConnectionDef ¶
type ConnectionDef struct {
Slug string `json:"slug,omitempty"`
Name string `json:"name"`
Description string `json:"description"`
BaseURL string `json:"baseUrl,omitempty"`
AuthMode ConnectionAuth `json:"authMode"`
AuthURL string `json:"authUrl,omitempty"`
TokenURL string `json:"tokenUrl,omitempty"`
Scopes []string `json:"scopes,omitempty"`
AuthParams map[string]string `json:"authParams,omitempty"`
Headers map[string]string `json:"headers,omitempty"`
AuthInjection AuthInjection `json:"authInjection"`
SetupInstructions string `json:"setupInstructions,omitempty"`
LLMHint string `json:"llmHint,omitempty"`
BindingMode BindingMode `json:"bindingMode"`
}
type ConnectorJobInfo ¶ added in v0.6.0
type ConnectorJobInfo struct {
JobID string `json:"jobId"`
ResourceID string `json:"resourceId,omitempty"`
Status string `json:"status"`
Output json.RawMessage `json:"output,omitempty"`
Error string `json:"error,omitempty"`
Progress *ConnectorJobProgress `json:"progress,omitempty"`
History []ConnectorJobProgress `json:"history"`
}
type ConnectorJobProgress ¶ added in v0.6.0
type ConnectorNeedDef ¶ added in v0.6.0
type ConnectorNeedDef struct {
Slug string `json:"slug"`
Description string `json:"description"`
Multiple bool `json:"multiple,omitempty"`
Requirement protocol.Requirement `json:"requirement"`
}
type ConnectorOrchestrationInfo ¶ added in v0.6.0
type ConnectorOrchestrationInfo struct {
ID string `json:"id"`
Status string `json:"status"`
Strategy string `json:"strategy"`
CanaryPhase string `json:"canaryPhase"`
CanaryCount int32 `json:"canaryCount"`
CanarySucceededCount int32 `json:"canarySucceededCount"`
Targets []ConnectorJobInfo `json:"targets"`
}
type ConnectorOrchestrationRequest ¶ added in v0.6.0
type ConnectorOrchestrationRequest struct {
CommandName string `json:"commandName"`
Request protocol.OrchestrationRequest `json:"request"`
}
type ContinueAgentRequest ¶ added in v0.7.0
type CreateRunRequest ¶
type CreateRunResponse ¶
type DirectoryDef ¶
type DirectoryDef struct {
Path string `json:"path"`
Read Access `json:"read"`
Write Access `json:"write"`
List Access `json:"list"`
Description string `json:"description"`
LLMHint string `json:"llmHint,omitempty"`
RetentionHours int `json:"retentionHours,omitempty"`
Scope DirectoryScope `json:"scope,omitempty"`
}
type DirectoryScope ¶
type DirectoryScope string
type DisplayPart ¶
type DisplayPart struct {
Type string `json:"type"`
Text string `json:"text,omitempty"`
Source string `json:"source,omitempty"`
URL string `json:"url,omitempty"`
Data []byte `json:"data,omitempty"`
Filename string `json:"filename,omitempty"`
MimeType string `json:"mimeType,omitempty"`
Alt string `json:"alt,omitempty"`
Duration float64 `json:"duration,omitempty"`
}
type EnqueueJobErrorResponse ¶ added in v0.5.0
type EnqueueJobErrorResponse struct {
Code string `json:"code"`
Error string `json:"error"`
HandlerName string `json:"handlerName"`
HandlerVersion int32 `json:"handlerVersion"`
}
EnqueueJobErrorResponse is returned with HTTP 409 when an exact job handler contract is temporarily unavailable during a deployment transition.
type EnqueueJobRequest ¶ added in v0.5.0
type EnqueueJobRequest struct {
ID string `json:"id"`
Name string `json:"name"`
Version int32 `json:"version"`
InputSchemaHash string `json:"inputSchemaHash"`
OutputSchemaHash string `json:"outputSchemaHash"`
Input json.RawMessage `json:"input"`
ScheduledAt *time.Time `json:"scheduledAt,omitempty"`
}
type EnqueueJobResponse ¶ added in v0.5.0
type EnvVarValueResponse ¶
type EnvVarValueResponse struct {
Value string `json:"value"`
}
type GetJobResponse ¶ added in v0.5.0
type GetJobResponse struct {
Job JobInfo `json:"job"`
}
type HTTPRequest ¶
type HTTPRequest struct {
URL string `json:"url"`
Method string `json:"method,omitempty"`
Headers map[string]string `json:"headers,omitempty"`
Body string `json:"body,omitempty"`
Timeout int `json:"timeout,omitempty"`
SaveAs string `json:"saveAs,omitempty"`
RunID string `json:"runId,omitempty"`
Raw bool `json:"raw,omitempty"`
AllHeaders bool `json:"allHeaders,omitempty"`
}
type HTTPResponse ¶
type HTTPResponse struct {
Status int `json:"status"`
Headers map[string]string `json:"headers"`
Body string `json:"body,omitempty"`
ContentType string `json:"contentType"`
Size int `json:"size"`
BodyPreview string `json:"bodyPreview,omitempty"`
SavedTo string `json:"savedTo,omitempty"`
Note string `json:"note,omitempty"`
}
type InstructionDef ¶
type JobCronDef ¶ added in v0.5.0
type JobCronDef struct {
Slug string `json:"slug"`
Schedule string `json:"schedule"`
Description string `json:"description"`
HandlerName string `json:"handlerName"`
HandlerVersion int32 `json:"handlerVersion"`
InputSchemaHash string `json:"inputSchemaHash"`
OutputSchemaHash string `json:"outputSchemaHash"`
Input json.RawMessage `json:"input"`
}
type JobHandlerDef ¶ added in v0.5.0
type JobHandlerDef struct {
Name string `json:"name"`
Version int32 `json:"version"`
Description string `json:"description"`
TimeoutMs int64 `json:"timeoutMs"`
MaxAttempts int32 `json:"maxAttempts"`
MaxConcurrency int32 `json:"maxConcurrency"`
InputSchema json.RawMessage `json:"inputSchema"`
OutputSchema json.RawMessage `json:"outputSchema"`
InputSchemaHash string `json:"inputSchemaHash"`
OutputSchemaHash string `json:"outputSchemaHash"`
}
type JobInfo ¶ added in v0.5.0
type JobInfo struct {
ID string `json:"id"`
AgentID string `json:"agentId"`
HandlerName string `json:"handlerName"`
HandlerVersion int32 `json:"handlerVersion"`
InputSchemaHash string `json:"inputSchemaHash"`
OutputSchemaHash string `json:"outputSchemaHash"`
Status string `json:"status"`
Input json.RawMessage `json:"input"`
Output json.RawMessage `json:"output,omitempty"`
AttemptCount int32 `json:"attemptCount"`
MaxAttempts int32 `json:"maxAttempts"`
AttemptLimit int32 `json:"attemptLimit"`
LastError string `json:"lastError,omitempty"`
Progress *JobProgress `json:"progress,omitempty"`
SourceRunID string `json:"sourceRunId,omitempty"`
ScheduledAt *time.Time `json:"scheduledAt,omitempty"`
CreatedAt time.Time `json:"createdAt"`
UpdatedAt time.Time `json:"updatedAt"`
StartedAt *time.Time `json:"startedAt,omitempty"`
CompletedAt *time.Time `json:"completedAt,omitempty"`
}
type JobManifest ¶ added in v0.5.0
type JobManifest struct {
JobHandlers []JobHandlerDef `json:"jobHandlers"`
JobCrons []JobCronDef `json:"jobCrons"`
}
JobManifest is the canonical job declaration emitted by an agent image in job-manifest inspection mode. Both slices are ordered by their identifiers.
type JobProgress ¶ added in v0.5.0
type JobRunRequest ¶ added in v0.5.0
type JobRunRequest struct {
ID string `json:"id"`
Name string `json:"name"`
Version int32 `json:"version"`
InputSchemaHash string `json:"inputSchemaHash"`
OutputSchemaHash string `json:"outputSchemaHash"`
Attempt int32 `json:"attempt"`
TimeoutMs int64 `json:"timeoutMs"`
Input json.RawMessage `json:"input"`
ScheduledAt *time.Time `json:"scheduledAt,omitempty"`
Caller Caller `json:"caller"`
ConversationID string `json:"conversationId"`
}
type JobRunResponse ¶ added in v0.5.0
type JobRunResponse struct {
// Status is success, error, timeout, or retry. Retry reports a temporary
// enqueue availability failure and asks Airlock to redeliver the attempt.
Status string `json:"status"`
Output json.RawMessage `json:"output,omitempty"`
Error string `json:"error,omitempty"`
}
type LLMProxyRequest ¶
type LLMProxyRequest struct {
Slug string `json:"slug,omitempty"`
Capability string `json:"capability,omitempty"`
Options json.RawMessage `json:"options"`
}
type ListAgentRunsResponse ¶ added in v0.7.0
type ListAgentRunsResponse struct {
Runs []AgentRunInfo `json:"runs"`
NextCursor string `json:"nextCursor,omitempty"`
}
type ListJobsResponse ¶ added in v0.5.0
type ListMembersResponse ¶ added in v0.7.0
type ListMembersResponse struct {
Members []Member `json:"members"`
NextCursor string `json:"nextCursor,omitempty"`
}
ListMembersResponse contains a page of deduplicated current-app members. Users with no direct or group-derived grant are excluded; public grants qualify. Each member has the highest effective access (admin > user > public).
type MCPAuthStatus ¶
type MCPContent ¶
type MCPContent struct {
Type string `json:"type"`
Text string `json:"text,omitempty"`
URI string `json:"uri,omitempty"`
Name string `json:"name,omitempty"`
MimeType string `json:"mimeType,omitempty"`
Data string `json:"data,omitempty"`
Resource *MCPResourceContent `json:"resource,omitempty"`
Description string `json:"description,omitempty"`
Title string `json:"title,omitempty"`
Annotations json.RawMessage `json:"annotations,omitempty"`
Icons json.RawMessage `json:"icons,omitempty"`
Size *int64 `json:"size,omitempty"`
Meta json.RawMessage `json:"_meta,omitempty"`
}
type MCPDef ¶
type MCPDef struct {
Slug string `json:"slug,omitempty"`
Name string `json:"name"`
URL string `json:"url"`
AuthMode MCPAuth `json:"authMode"`
AuthURL string `json:"authUrl,omitempty"`
TokenURL string `json:"tokenUrl,omitempty"`
Scopes []string `json:"scopes,omitempty"`
AuthInjection AuthInjection `json:"authInjection"`
BindingMode BindingMode `json:"bindingMode"`
}
type MCPResourceContent ¶ added in v0.7.0
type MCPToolCallRequest ¶
type MCPToolCallRequest struct {
Tool string `json:"tool"`
Arguments json.RawMessage `json:"arguments"`
}
type MCPToolCallResponse ¶
type MCPToolCallResponse struct {
Content []MCPContent `json:"content"`
IsError bool `json:"isError"`
StructuredContent json.RawMessage `json:"structuredContent,omitempty"`
Meta json.RawMessage `json:"_meta,omitempty"`
}
type MCPToolSchema ¶
type MCPToolSchema struct {
ServerSlug string `json:"serverSlug"`
Name string `json:"name"`
Description string `json:"description"`
InputSchema json.RawMessage `json:"inputSchema"`
OutputSchema json.RawMessage `json:"outputSchema,omitempty"`
}
type Member ¶ added in v0.7.0
type Member struct {
User MemberUser `json:"user"`
Access Access `json:"access"`
}
Member is a current-app identity and highest effective access snapshot across actual direct and group-derived grants, including public grants, not a credential.
type MemberUser ¶ added in v0.7.0
type MemberUser struct {
ID string `json:"id"`
Email string `json:"email"`
DisplayName string `json:"displayName"`
PlatformMember bool `json:"platformMember"`
}
MemberUser is directory metadata, not host-attributed execution identity.
type ModelProxyRequest ¶
type ModelProxyRequest struct {
Slug string `json:"slug,omitempty"`
Capability string `json:"capability"`
Options json.RawMessage `json:"options"`
}
type ModelSlotDef ¶
type PrintRequest ¶
type PrintRequest struct {
Parts []DisplayPart `json:"parts"`
Topic string `json:"topic,omitempty"`
ConversationID string `json:"conversationId,omitempty"`
RunID string `json:"runId,omitempty"`
UserID string `json:"userId,omitempty"`
}
type PromptData ¶
type PromptData struct {
AgentDashboardURL string `json:"agentDashboardUrl"`
AgentRouteURL string `json:"agentRouteUrl"`
Capabilities Capabilities `json:"capabilities,omitempty"`
SupportedModalities []string `json:"supportedModalities,omitempty"`
}
type PromptInput ¶
type PromptInput struct {
Message string `json:"message,omitempty"`
ConversationID string `json:"conversationId,omitempty"`
Temperature *float64 `json:"temperature,omitempty"`
Files []FileInfo `json:"files,omitempty"`
ResumeRunID string `json:"resumeRunId,omitempty"`
Approved *bool `json:"approved,omitempty"`
Source string `json:"source,omitempty"`
Instructions string `json:"instructions,omitempty"`
CallerAccess Access `json:"callerAccess,omitempty"`
ForceCompact bool `json:"forceCompact,omitempty"`
DirectTools bool `json:"directTools,omitempty"`
Platform string `json:"platform,omitempty"`
UserDisplayName string `json:"userDisplayName,omitempty"`
UserEmail string `json:"userEmail,omitempty"`
}
type ProxyRequest ¶
type RunCompleteRequest ¶
type RunCompleteRequest struct {
JobID string `json:"jobId,omitempty"`
Attempt int32 `json:"attempt,omitempty"`
LeaseToken string `json:"leaseToken,omitempty"`
RunID string `json:"runId"`
Status string `json:"status"`
Error string `json:"error,omitempty"`
ErrorKind string `json:"errorKind,omitempty"`
PanicTrace string `json:"panicTrace,omitempty"`
Actions []Action `json:"actions"`
Logs []LogEntry `json:"logs,omitempty"`
Checkpoint json.RawMessage `json:"checkpoint,omitempty"`
}
type RuntimeAgentDefinition ¶ added in v0.7.0
type RuntimeAttachment ¶ added in v0.7.0
type RuntimeAttachment struct {
Path string `json:"path"`
MimeType string `json:"mimeType"`
Filename string `json:"filename,omitempty"`
}
RuntimeAttachment references agent object storage, never inline file bytes.
type RuntimeContext ¶ added in v0.7.0
type RuntimeContext struct {
AgentID string `json:"agentId"`
RunID string `json:"runId"`
InvocationToken string `json:"invocationToken"`
BridgeID string `json:"bridgeId,omitempty"`
ConversationID string `json:"conversationId,omitempty"`
Caller Caller `json:"caller"`
SupportedModalities []string `json:"supportedModalities,omitempty"`
Job *RuntimeJobContext `json:"job,omitempty"`
Definition *RuntimeAgentDefinition `json:"definition,omitempty"`
}
RuntimeContext borrows an existing same-agent run. The app must not create or complete it. All attribution is supplied by the authenticated broker.
type RuntimeInvokeRequest ¶ added in v0.7.0
type RuntimeInvokeRequest struct {
RuntimeProtocol string `json:"runtimeProtocol"`
CapabilityID string `json:"capabilityId"`
ToolCallID string `json:"toolCallId"`
Input json.RawMessage `json:"input"`
Context RuntimeContext `json:"context"`
}
RuntimeInvokeRequest is an internal broker-to-app call, authenticated with the target agent's bearer token. The broker must load the active run from shared storage, verify its agent ownership and authorize the selected capability before constructing this request. Never populate Context from public headers or accept a caller-supplied catalogue as an authorization source.
type RuntimeInvokeResponse ¶ added in v0.7.0
type RuntimeInvokeResponse struct {
RuntimeProtocol string `json:"runtimeProtocol"`
Output string `json:"output"`
Title string `json:"title,omitempty"`
Metadata map[string]any `json:"metadata,omitempty"`
Warnings []string `json:"warnings,omitempty"`
Attachments []RuntimeAttachment `json:"attachments,omitempty"`
Logs []LogEntry `json:"logs,omitempty"`
Actions []Action `json:"actions,omitempty"`
Error string `json:"error,omitempty"`
}
RuntimeInvokeResponse retains the complete tool envelope and invocation-local telemetry. Airlock merges Actions and Logs into the borrowed run's record. Tool failures use Error with HTTP 200; protocol/auth failures use non-2xx.
type RuntimeJobContext ¶ added in v0.7.0
type SealRequest ¶
type SealRequest struct {
Plaintext string `json:"plaintext"`
}
type SealResponse ¶
type SealResponse struct {
Sealed string `json:"sealed"`
}
type SearchProxyRequest ¶
type SessionAppendRequest ¶
type SessionAppendResponse ¶
type SessionAppendResponse struct {
Revision string `json:"revision"`
}
type SessionCompactRequest ¶
type SessionCompactResponse ¶
type SessionCompactResponse struct {
Revision string `json:"revision"`
}
type SessionLoadResponse ¶
type ShareFileRequest ¶
type ShareFileRequest struct {
}
type ShareFileResponse ¶
type ShareFileResponse struct {
}
type StartAgentRequest ¶ added in v0.7.0
type StartAgentRequest struct {
RequestID string `json:"requestId"`
ContractHash string `json:"contractHash"`
Input json.RawMessage `json:"input"`
}
type StartupHookDef ¶ added in v0.5.0
type StartupHookDef struct {
Name string `json:"name"`
}
type StaticAssetDef ¶ added in v0.5.0
type StorageFileRef ¶ added in v0.8.1
type StorageFileRefRequest ¶ added in v0.8.1
type StorageFileRefRequest struct {
Path string `json:"path"`
}
type StorageSetIndexRequest ¶ added in v0.8.1
type StorageSetIndexRequest struct {
File StorageFileRef `json:"file"`
Text string `json:"text"`
}
type SyncRequest ¶
type SyncRequest = AgentManifest
SyncRequest is the complete agent declaration accepted by runtime sync.
type SyncResponse ¶
type SyncResponse struct {
RuntimeProtocol string `json:"runtimeProtocol"`
PromptData PromptData `json:"promptData"`
MCPAuthStatus []MCPAuthStatus `json:"mcpAuthStatus,omitempty"`
MCPSchemas map[string][]MCPToolSchema `json:"mcpSchemas,omitempty"`
PublicStorageBase string `json:"publicStorageBase,omitempty"`
}
type ToolDef ¶
type ToolDef struct {
Name string `json:"name"`
Description string `json:"description"`
LLMHint string `json:"llmHint,omitempty"`
Access Access `json:"access"`
InputSchema json.RawMessage `json:"inputSchema,omitempty"`
OutputSchema json.RawMessage `json:"outputSchema,omitempty"`
InputExamples []json.RawMessage `json:"inputExamples,omitempty"`
FileInputDirectory string `json:"fileInputDirectory,omitempty"`
}
type TopicEnrollment ¶ added in v0.7.0
type TopicEnrollment string
const ( TopicEnrollmentDefaultOn TopicEnrollment = "default_on" TopicEnrollmentDefaultOff TopicEnrollment = "default_off" )
type TopicSubscriptionRequest ¶ added in v0.7.0
type TopicSubscriptionRequest struct {
ConversationID string `json:"conversationId"`
}
type UnsealRequest ¶
type UnsealRequest struct {
Sealed string `json:"sealed"`
}
type UnsealResponse ¶
type UnsealResponse struct {
Plaintext string `json:"plaintext"`
}