@skaile/workspaces 5.5.0 → 5.6.0

package/dist/types/src/agent-lifecycle.d.ts

@@ -0,0 +1,402 @@
+/**
+ * Agent instance and run vocabulary shared by the protocol events and the
+ * `agent.*` capabilities.
+ *
+ * An *instance* is an agent asset bound into a workspace under an id
+ * (`skaile.yaml` `agents:`); a *run* is one execution of an instance started
+ * through `agent.run`. The run controller that owns the full run record builds
+ * on these types.
+ *
+ * @category Lifecycle
+ * @since 4.16.0
+ */
+/** Lifecycle of an agent instance: a long-running identity or a short-lived callable role. */
+export type AgentInstanceLifecycleKind = "standing" | "role";
+/** Where an instance's memory blocks live. */
+export type AgentMemoryScopeKind = "instance" | "user" | "workspace" | "session";
+/**
+ * Status of an `agent.run` run.
+ *
+ * `queued → running → (waiting_approval | waiting_children)* → succeeded | failed | cancelled`.
+ */
+export declare const AGENT_RUN_STATUSES: readonly ["queued", "running", "waiting_approval", "waiting_children", "succeeded", "failed", "cancelled"];
+export type AgentRunStatus = (typeof AGENT_RUN_STATUSES)[number];
+/** A status no run leaves again. */
+export declare const TERMINAL_AGENT_RUN_STATUSES: readonly AgentRunStatus[];
+/**
+ * One agent instance of the workspace, as a client renders it in a picker.
+ * Carried on `session_init_ack.instances` and returned by `agent.list`.
+ *
+ * @category Lifecycle
+ * @since 4.16.0
+ */
+export type AgentInstanceSummary = {
+    /** Instance id (`default` for the primary `agent:`). */
+    id: string;
+    /** `agents.<id>.ref` as written. */
+    ref: string;
+    lifecycle: AgentInstanceLifecycleKind;
+    description?: string;
+    /** SHA-256 of the resolved instance; absent when the instance failed to resolve. */
+    revisionHash?: string;
+    /** Roles only: which JSON-Schema roots the agent declares. */
+    io?: {
+        input: boolean;
+        output: boolean;
+    };
+    /** `ready` = can be started; `unavailable` = the asset did not resolve (`error` says why). */
+    status: "ready" | "unavailable";
+    error?: string;
+};
+/** Why a call or a run did not succeed. */
+export type AgentRunFailure = {
+    code: string;
+    message: string;
+    /** Validation problems (JSON-Schema paths) when `code` is `input_invalid` or `output_invalid`. */
+    issues?: string[];
+};
+/** The state of one run as `agent.run` / `agent.status` / `agent.result` report it. */
+export type AgentRunReport = {
+    runId: string;
+    status: AgentRunStatus;
+    /** The role's output once `succeeded` (validated against `io.output`). */
+    output?: unknown;
+    error?: AgentRunFailure;
+    /** Set while `status` is `waiting_approval`: decide it with `approval.decide`. */
+    approvalId?: string;
+    /** Set with `approvalId`: the one operation the approval releases. */
+    operationId?: string;
+};
+/** A host's answer when a request fails as a domain error (unknown run, not allowed, store error). */
+export type HostFailure = {
+    ok: false;
+    code: string;
+    message: string;
+    issues?: string[];
+};
+/**
+ * Requests the runner sends to `host.agent_run`. The host spawns, tracks,
+ * cancels and approves runs; the runner has already checked that the
+ * instance exists and that `input` matches the role's `io.input`. The host
+ * MUST validate again, enforce `approval: "required"` (one approval per
+ * operation, replayable once), apply `budget`, and answer every `start` for
+ * the same `callId` with the same `runId`.
+ */
+export type HostAgentRunRequest = {
+    op: "start";
+    instanceId: string;
+    /** Revision of the resolved instance the runner saw; the host runs that revision or fails. */
+    revisionHash?: string;
+    input?: unknown;
+    /** `sync` answers when the run ends; `async` answers as soon as it is queued. */
+    mode: "sync" | "async";
+    budget?: {
+        max_turns?: number;
+        max_tokens?: number;
+    };
+    /** Capability-dispatch call id; the idempotency key of the start. */
+    callId: string;
+    callerSessionId: string;
+    callerInstanceId: string;
+    approval: "required" | "none";
+} | {
+    op: "status" | "cancel";
+    runId: string;
+    callerSessionId: string;
+} | {
+    op: "result";
+    runId: string;
+    wait: boolean;
+    callerSessionId: string;
+} | {
+    op: "decide_approval";
+    approvalId: string;
+    decision: "approve" | "deny";
+    callerSessionId: string;
+};
+export type HostAgentRunReply = AgentRunReport | HostFailure;
+/** A memory block as the runner declares it to the host store. */
+export type HostMemoryBlockRef = {
+    name: string;
+    scope: AgentMemoryScopeKind;
+    maxChars: number;
+};
+/**
+ * Requests the runner sends to `host.memory_store`. The host owns storage,
+ * enforces `maxChars` and scope, and applies its own pending → confirmed policy.
+ */
+export type HostMemoryStoreRequest = {
+    op: "read";
+    instanceId: string;
+    block: HostMemoryBlockRef;
+} | {
+    op: "write" | "append";
+    instanceId: string;
+    block: HostMemoryBlockRef;
+    content: string;
+} | {
+    op: "list";
+    instanceId: string;
+    blocks: HostMemoryBlockRef[];
+}
+/** Current content of every block, read once when a session is built. */
+ | {
+    op: "snapshot";
+    instanceId: string;
+    blocks: HostMemoryBlockRef[];
+};
+export type HostMemoryStoreReply = {
+    ok: true;
+    /** `read`: the block's content. */
+    content?: string;
+    /** `write` / `append`: the block's size after the change. */
+    chars?: number;
+    /** `write` / `append`: `pending` when the host holds the change for review. */
+    status?: "confirmed" | "pending";
+    /** `list`: sizes of the blocks the host holds. */
+    blocks?: Array<{
+        name: string;
+        chars: number;
+    }>;
+    /** `snapshot`: block name → content. */
+    snapshot?: Record<string, string>;
+} | HostFailure;
+/** A trigger as the host schedules it. */
+export type HostTrigger = {
+    id: string;
+    kind: "schedule" | "webhook" | "channel" | "event";
+    cron?: string;
+    prompt?: string;
+    timezone?: string;
+    /** `channel` triggers. */
+    when?: string;
+    /** `event` triggers. */
+    event?: string;
+    enabled: boolean;
+    /** `asset` = the agent asset's default, `workspace` = the instance's `skaile.yaml` entry, `runtime` = added through `trigger.upsert`. */
+    source: "asset" | "workspace" | "runtime";
+    nextRunAt?: string;
+};
+/**
+ * Requests the runner sends to `host.trigger_store`. `upsert` and `toggle`
+ * carry `approval: "required"`: the host MUST gate them behind a user approval.
+ */
+export type HostTriggerStoreRequest = {
+    op: "list";
+    instanceId: string;
+} | {
+    op: "upsert";
+    instanceId: string;
+    trigger: Omit<HostTrigger, "source" | "nextRunAt" | "enabled"> & {
+        enabled?: boolean;
+    };
+    approval: "required";
+} | {
+    op: "toggle";
+    instanceId: string;
+    triggerId: string;
+    enabled: boolean;
+    approval: "required";
+};
+export type HostTriggerStoreReply = {
+    ok: true;
+    triggers?: HostTrigger[];
+    trigger?: HostTrigger;
+} | HostFailure;
+/** Why a run left `running` for a `queued` that is not its first start. */
+export type AgentRunResumeReason = "approval" | "children";
+/**
+ * One execution of an agent instance, as the run controller records it.
+ *
+ * `attempt` is 1 for every run in this release; a retrying worker raises it.
+ * `sessionId` is the id of the run's own native session and is assigned when
+ * the run is created, so a session can be mapped back to its run before it exists.
+ *
+ * @category Lifecycle
+ * @since 4.16.0
+ */
+export type AgentRun = {
+    id: string;
+    workspaceId: string;
+    instanceId: string;
+    /** Revision of the resolved instance the run executes; `null` when the host resolves none. */
+    revisionHash: string | null;
+    /** The actor (user or service) the run is accountable to; set by the host, never by the model. */
+    requestedBy: string;
+    /** The run at the top of the delegation tree; its own id for a run started outside any run. */
+    rootRunId: string;
+    /** The run whose session started this one; `null` for a root run. */
+    parentRunId: string | null;
+    /** Session that dispatched the start; with `callId` the idempotency key of the start. */
+    callerSessionId: string | null;
+    callId: string | null;
+    sessionId: string;
+    /** Driver the run executed on; `null` until it is first launched. */
+    harness: string | null;
+    status: AgentRunStatus;
+    attempt: number;
+    /** What the next launch of a resumed run delivers; `null` for a run that was not suspended. */
+    resumeReason: AgentRunResumeReason | null;
+    budget?: {
+        max_turns?: number;
+        max_tokens?: number;
+    };
+    input: unknown;
+    output?: unknown;
+    error?: AgentRunFailure;
+    createdAt: string;
+    /** When the run first reached `running`; `null` while it has never started. */
+    startedAt: string | null;
+    updatedAt: string;
+};
+/** The fields of a run a transition may change. */
+export type AgentRunPatch = Partial<Pick<AgentRun, "status" | "harness" | "resumeReason" | "startedAt" | "output" | "error">> & {
+    updatedAt: string;
+};
+/** `start` holds the run itself behind an approval; `operation` holds one capability call a running run made. */
+export type AgentApprovalKind = "start" | "operation";
+/** `pending → approved | denied`, or `pending → expired` when the run ends first. Never leaves a decided state. */
+export type AgentApprovalState = "pending" | "approved" | "denied" | "expired";
+/**
+ * A persisted approval: the one operation a decision releases.
+ *
+ * `args` are what executes on approval; `argsHash` (SHA-256 of their canonical
+ * JSON) is what a replay is checked against. `result` / `error` are set once the
+ * operation ran; `deliveredAt` once the session has been told.
+ *
+ * @category Lifecycle
+ * @since 4.16.0
+ */
+export type AgentApproval = {
+    id: string;
+    runId: string;
+    operationId: string;
+    kind: AgentApprovalKind;
+    /** Capability name of the held call (`agent.run` for a `start` approval). */
+    capability: string;
+    /** Capability-dispatch call id of the held call, when the session supplied one. */
+    callId: string | null;
+    args: unknown;
+    argsHash: string;
+    state: AgentApprovalState;
+    decidedBy: string | null;
+    decidedAt: string | null;
+    result?: unknown;
+    error?: AgentRunFailure;
+    executedAt: string | null;
+    deliveredAt: string | null;
+    createdAt: string;
+};
+/** The fields of an approval a decision or its follow-up may change. */
+export type AgentApprovalPatch = Partial<Pick<AgentApproval, "state" | "decidedBy" | "decidedAt" | "result" | "error" | "executedAt" | "deliveredAt">>;
+/**
+ * One row of a run's append-only event log (`agent_run_events`). A host
+ * persists these, broadcasts them after they are persisted, and replays
+ * those after a sequence cursor to a client that reconnects.
+ *
+ * @category Lifecycle
+ * @since 4.16.0
+ */
+export type AgentRunEvent = {
+    type: "run_state";
+    status: AgentRunStatus;
+    /** `null` for the run's creation. */
+    previous: AgentRunStatus | null;
+    instanceId: string;
+    rootRunId: string;
+    parentRunId: string | null;
+    attempt: number;
+    /** Set with `waiting_approval`: the approval the run waits on. */
+    approvalId?: string;
+    operationId?: string;
+    error?: AgentRunFailure;
+} | {
+    type: "approval";
+    approvalId: string;
+    operationId: string;
+    kind: AgentApprovalKind;
+    capability: string;
+    state: AgentApprovalState;
+    decidedBy?: string;
+} | {
+    type: "operation_result";
+    approvalId: string;
+    operationId: string;
+    outcome: "completed" | "failed";
+};
+/** An {@link AgentRunEvent} with the position the store gave it. `seq` counts from 1 within one run. */
+export type AgentRunEventRecord = {
+    runId: string;
+    seq: number;
+    at: string;
+    event: AgentRunEvent;
+};
+/** Which runs {@link RunStore.listRuns} returns; every given field must match. */
+export type AgentRunFilter = {
+    rootRunId?: string;
+    parentRunId?: string;
+    instanceId?: string;
+    statuses?: readonly AgentRunStatus[];
+};
+/**
+ * Where the run controller keeps runs, their event log and approvals. A host
+ * with durable storage implements it over its database; {@link
+ * createInMemoryRunStore} (`@skaile/workspaces/runner`) is the in-process one
+ * for tests and the CLI.
+ *
+ * The two `transition*` methods are compare-and-set: they apply the patch only
+ * if the row is still in an expected state and answer `undefined` otherwise.
+ * That is what makes a decision, a cancel and a resume race-safe: of two
+ * concurrent attempts exactly one wins.
+ *
+ * @category Lifecycle
+ * @since 4.16.0
+ */
+export interface RunStore {
+    /** Insert a run; when its `(callerSessionId, callId)` pair already exists, answer that run with `created: false`. */
+    insertRun(run: AgentRun): Promise<{
+        run: AgentRun;
+        created: boolean;
+    }>;
+    getRun(id: string): Promise<AgentRun | undefined>;
+    /** Apply `patch` if the run's status is one of `from`; answer the updated run, or `undefined` when it was not. */
+    transitionRun(id: string, from: readonly AgentRunStatus[], patch: AgentRunPatch): Promise<AgentRun | undefined>;
+    findRunByDispatch(callerSessionId: string, callId: string): Promise<AgentRun | undefined>;
+    findRunBySession(sessionId: string): Promise<AgentRun | undefined>;
+    listRuns(filter: AgentRunFilter): Promise<AgentRun[]>;
+    /** Append to a run's log; the store assigns `seq`. */
+    appendEvent(runId: string, event: AgentRunEvent, at: string): Promise<AgentRunEventRecord>;
+    listEvents(runId: string, afterSeq?: number): Promise<AgentRunEventRecord[]>;
+    insertApproval(approval: AgentApproval): Promise<void>;
+    getApproval(id: string): Promise<AgentApproval | undefined>;
+    /** The approval a run's held call `callId` produced, if any. */
+    findApprovalByCall(runId: string, callId: string): Promise<AgentApproval | undefined>;
+    listApprovals(runId: string): Promise<AgentApproval[]>;
+    /** Apply `patch` if the approval's state is `from`; answer the updated approval, or `undefined` when it was not. */
+    transitionApproval(id: string, from: AgentApprovalState, patch: AgentApprovalPatch): Promise<AgentApproval | undefined>;
+}
+/**
+ * What a suspended run's session is told when it resumes. It reaches the
+ * model as a host message through the ordinary prompt path.
+ *
+ * @category Lifecycle
+ * @since 4.16.0
+ */
+export type RunHostMessage = {
+    type: "approval_result";
+    operationId: string;
+    /** `completed`: the operation ran (`result`); `failed`: it threw (`error`); `denied`: it never ran. */
+    status: "completed" | "failed" | "denied";
+    result?: unknown;
+    error?: AgentRunFailure;
+} | {
+    type: "children_finished";
+    children: Array<{
+        runId: string;
+        instanceId: string;
+        status: AgentRunStatus;
+        output?: unknown;
+        error?: AgentRunFailure;
+    }>;
+};
+//# sourceMappingURL=agent-lifecycle.d.ts.map

package/dist/types/src/agent-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-lifecycle.d.ts","sourceRoot":"","sources":["../../../types/src/agent-lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/types/src/capabilities.d.ts

@@ -52,7 +52,6 @@ export type CapabilityAudience = "llm" | "user" | "runtime";
  * - `skill`: from a skill's MCP surface
  * - `mcp`: from a generic MCP server
  * - `connector`: from a connector (e.g. `postgres.query`)
- * - `mount`: surfaced by a filesystem mount
  * - `app`: from an embedded, agent-controllable app (carries the originating
  *   `appId`). Handlers run in the app itself — see {@link Capability.side} `'app'`.
  *
@@ -78,9 +77,6 @@ export type CapabilityOrigin = {
 } | {
     kind: "connector";
     connectorId: string;
-} | {
-    kind: "mount";
-    mountId: string;
 } | {
     kind: "app";
     appId: string;

package/dist/types/src/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../types/src/capabilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../types/src/capabilities.ts"],"names":[],"mappings":"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"}

package/dist/types/src/delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../types/src/delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAiGvE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAI3D"}
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../types/src/delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAmGvE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAI3D"}

package/dist/types/src/events.d.ts

@@ -6,6 +6,7 @@
  * wrapped in a {@link Message} envelope by the host's persistence layer.
  */
 import type { CapabilityDeregisterEvent, CapabilityInvokedEvent, CapabilityRegisterEvent, RenderInvokedEvent } from "./capabilities.js";
+import type { AgentMemoryScopeKind, AgentRunStatus } from "./agent-lifecycle.js";
 import type { IncompatibleProtocolEvent, ProtocolInfoEvent, SessionInitAckEvent, SessionInitMismatchEvent } from "./lifecycle.js";
 import type { ContextUsageSnapshot } from "./context-usage.js";
 import type { LogEntry } from "./logging.js";
@@ -18,7 +19,7 @@ import type { LogEntry } from "./logging.js";
  *
  * @docLink packages/types/events#agent-event
  */
-export type AgentEvent = TextEvent | TextRetractEvent | ToolCallEvent | ToolResultEvent | QuestionEvent | QuestionReplyEvent | ErrorEvent | StatusEvent | DevServerEvent | FileChangeEvent | SubagentEvent | FinishedEvent | A2AMessageEvent | StateChangedEvent | HandoffEvent | ConnectorResponseEvent | ConnectorQueryResponseEvent | ConnectorMutateResponseEvent | PromptAckEvent | QueuedPromptsDroppedEvent | ConnectorsAvailableEvent | LifecycleCompleteEvent | TypingEvent | UserMessageEvent | SyncStatusEvent | SecretsReadyEvent | ConfiguredEvent | MountMountedEvent | MountUnmountedEvent | MountChangedEvent | MountSyncStatusEvent | DebugResultEvent | LogEntryEvent | ValidationWarningEvent | SkillsChangedEvent | CommandsAvailableEvent | FlowBreadcrumbEvent | FlowPromptEvent | SessionInfoEvent | ReactionAddedEvent | ReactionRemovedEvent | ResourceStatusEvent | ConnectorStatusEvent | CustomMessageEvent | SnapshotEvent | CompactionAttemptEvent | RuntimeSessionEvent | ResumeAttemptedEvent | ResumeFailedEvent | CapabilityRegisterEvent | CapabilityDeregisterEvent | CapabilityInvokedEvent | RenderInvokedEvent | ProtocolInfoEvent | IncompatibleProtocolEvent | SessionInitAckEvent | SessionInitMismatchEvent | SystemPromptComposedEvent | ContextUsageEvent | ProviderResponseSeenEvent | ProviderQuotaObservedEvent;
+export type AgentEvent = TextEvent | TextRetractEvent | ToolCallEvent | ToolResultEvent | QuestionEvent | QuestionReplyEvent | ErrorEvent | StatusEvent | DevServerEvent | FileChangeEvent | SubagentEvent | MemoryChangedEvent | TriggerFiredEvent | FinishedEvent | A2AMessageEvent | StateChangedEvent | HandoffEvent | ConnectorResponseEvent | ConnectorQueryResponseEvent | ConnectorMutateResponseEvent | PromptAckEvent | QueuedPromptsDroppedEvent | ConnectorsAvailableEvent | LifecycleCompleteEvent | TypingEvent | UserMessageEvent | SyncStatusEvent | SecretsReadyEvent | ConfiguredEvent | MountMountedEvent | MountUnmountedEvent | MountChangedEvent | MountSyncStatusEvent | DebugResultEvent | LogEntryEvent | ValidationWarningEvent | SkillsChangedEvent | CommandsAvailableEvent | FlowBreadcrumbEvent | FlowPromptEvent | SessionInfoEvent | ReactionAddedEvent | ReactionRemovedEvent | ResourceStatusEvent | ConnectorStatusEvent | CustomMessageEvent | SnapshotEvent | CompactionAttemptEvent | RuntimeSessionEvent | ResumeAttemptedEvent | ResumeFailedEvent | CapabilityRegisterEvent | CapabilityDeregisterEvent | CapabilityInvokedEvent | RenderInvokedEvent | ProtocolInfoEvent | IncompatibleProtocolEvent | SessionInitAckEvent | SessionInitMismatchEvent | SystemPromptComposedEvent | ContextUsageEvent | ProviderResponseSeenEvent | ProviderQuotaObservedEvent;
 /**
  * A text message from the agent to the user.
  *
@@ -292,13 +293,74 @@ export type SubagentEvent = {
     description: string;
     /** Flow node this subagent is executing (set by orchestrator) */
     nodeId?: string;
-    /** Structured output from the subagent (set on "finished") */
+    /**
+     * Structured output of a harness-native subagent (set on "finished"). Unchanged since 1.x;
+     * an `agent.run` run carries its output in {@link SubagentEvent.result} instead.
+     */
     output?: {
         summary: string;
         filesChanged: string[];
         status: string;
         concerns: string[];
     };
+    /**
+     * Typed output of an `agent.run` run, validated against the role's `io.output` schema (set on
+     * "finished" when the run succeeded; since 4.16.0). Absent for a harness-native subagent.
+     */
+    result?: unknown;
+    /** `agent.run` run this event belongs to (since 4.16.0). Absent for a harness-native subagent. */
+    runId?: string;
+    /** Instance the run executes (since 4.16.0). */
+    instanceId?: string;
+    /** The input the run was started with (set on "started"; since 4.16.0). */
+    input?: unknown;
+    /** Final status of the run (set on "finished"; since 4.16.0). */
+    runStatus?: AgentRunStatus;
+    /** Why the run did not succeed (set on "finished" when `runStatus` is not `succeeded`; since 4.16.0). */
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+/**
+ * A memory block of an agent instance changed.
+ *
+ * Emitted by the runner after a `memory.write` / `memory.append` call the host
+ * accepted, and by a host that changes a block by another route (a memory
+ * review, a consolidation). The block's content is not part of the event:
+ * read it with `memory.read` or from the host's store.
+ *
+ * @category Events
+ * @since 4.16.0
+ * @docLink packages/types/events#agent-event
+ */
+export type MemoryChangedEvent = {
+    type: "memory_changed";
+    /** Instance whose block changed. */
+    instanceId: string;
+    /** Block name, as declared in `memory.blocks`. */
+    block: string;
+    scope: AgentMemoryScopeKind;
+    /** Who made the change: the agent through a capability, a user, or the host itself. */
+    by: "agent" | "user" | "host";
+};
+/**
+ * A trigger of an agent instance fired and started (or queued) a run.
+ *
+ * The host schedules triggers (`schedule`, `webhook`, `channel`, `event`), so
+ * the host emits this event when it delivers the trigger's prompt; the
+ * runner defines the shape only. `source` reuses the trigger kinds of the
+ * asset (`schedule | webhook | channel | event`).
+ *
+ * @category Events
+ * @since 4.16.0
+ * @docLink packages/types/events#agent-event
+ */
+export type TriggerFiredEvent = {
+    type: "trigger_fired";
+    instanceId: string;
+    triggerId: string;
+    source: "schedule" | "webhook" | "channel" | "event";
 };
 /**
  * Per-turn token usage reported by a driver.
@@ -1770,14 +1832,14 @@ export type SessionInfoEvent = {
 /**
  * One labeled section of the assembled system prompt, as broken down by
  * the runner's session-builder. Single-entry labels (`context`, `prompt`,
- * `home`, `environment`, `resources`) appear once; multi-entry labels
+ * `home`, `environment`, `resources`, `memory`) appear once; multi-entry labels
  * (`prompt-extensions`, `composition`, `additional`) appear once per
  * source.
  *
  * @since 2026-05
  */
 export type SystemPromptSection = {
-    label: "context" | "prompt" | "home" | "environment" | "resources" | "mcp-guidance" | "tool-activity" | "prompt-extensions" | "composition" | "additional";
+    label: "context" | "prompt" | "home" | "environment" | "resources" | "mcp-guidance" | "tool-activity" | "memory" | "prompt-extensions" | "composition" | "additional";
     value: string;
     /** File path, block id, or descriptor — present for multi-entry labels. */
     source?: string;