@sixb/core 0.0.1

package/dist/agents/context-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolution.d.ts","sourceRoot":"","sources":["../../src/agents/context-resolution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAEtB,MAAM,WAAW,CAAA;AAGlB,+FAA+F;AAC/F,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,GACnD,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAyBtC"}

package/dist/agents/context.d.ts

@@ -0,0 +1,57 @@
+import type { JsonValue } from "../json";
+import type { ObjectRef } from "../ontology/refs";
+export type AgentContextInput = {
+    readonly kind: "object";
+    readonly ref: ObjectRef;
+} | {
+    readonly kind: "app-state";
+    readonly id: string;
+    readonly label: string;
+    readonly description: string;
+    readonly value: JsonValue;
+};
+export type AgentContextOrigin = "ambient" | "explicit";
+export interface AgentContextEntryInput {
+    readonly context: AgentContextInput;
+    readonly origin: AgentContextOrigin;
+}
+/** Durable user-message part. Origin is display provenance, never an authorization grant. */
+export interface AgentContextPart extends AgentContextEntryInput {
+    readonly type: "context";
+}
+export declare const MAX_AGENT_CONTEXT_ENTRIES = 12;
+export declare const MAX_AGENT_APP_STATE_ENTRY_BYTES: number;
+export declare const MAX_AGENT_APP_STATE_TOTAL_BYTES: number;
+/** Typed constructors for context values shared by custom apps and agent clients. */
+export declare const agentContext: {
+    object<const TObjectTypeId extends string>(objectType: {
+        readonly id: TObjectTypeId;
+    }, primaryId: string): {
+        kind: "object";
+        ref: {
+            objectTypeId: TObjectTypeId;
+            primaryId: string;
+        };
+    };
+    appState<const TValue extends JsonValue>(id: string, input: {
+        readonly label: string;
+        readonly description: string;
+        readonly value: TValue;
+    }): {
+        label: string;
+        description: string;
+        value: TValue;
+        kind: "app-state";
+        id: string;
+    };
+};
+/** Stable identity shared by core deduplication and context-aware clients. */
+export declare function agentContextIdentity(context: AgentContextInput): string;
+/** Stable semantic key for client-side comparisons. */
+export declare function agentContextFingerprint(context: AgentContextInput): string;
+/**
+ * Validate transport-independent context rules and clone mutable app state before it can become
+ * durable. Object existence and visibility are resolved separately because they require a runtime.
+ */
+export declare function normalizeAgentContextEntries(input: readonly AgentContextEntryInput[] | undefined): readonly AgentContextEntryInput[];
+//# sourceMappingURL=context.d.ts.map

package/dist/agents/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/agents/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAGjD,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;CAAE,GACpD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAC1B,CAAA;AAEL,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,CAAA;AAEvD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CACpC;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;IAC9D,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CACzB;AAED,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAC3C,eAAO,MAAM,+BAA+B,QAAY,CAAA;AACxD,eAAO,MAAM,+BAA+B,QAAY,CAAA;AAExD,qFAAqF;AACrF,eAAO,MAAM,YAAY;iBACV,aAAa,SAAS,MAAM,cAC3B;QAAE,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAA;KAAE,aAC/B,MAAM;;;;;;;mBAQJ,MAAM,SAAS,SAAS,MACjC,MAAM,SACH;QACL,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KACvB;eAHiB,MAAM;qBACA,MAAM;eACZ,MAAM;;;;CAK3B,CAAA;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAIvE;AAED,uDAAuD;AACvD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,GACnD,SAAS,sBAAsB,EAAE,CA0CnC"}

package/dist/agents/context.js

@@ -0,0 +1,23 @@
+// @bun
+import {
+  MAX_AGENT_APP_STATE_ENTRY_BYTES,
+  MAX_AGENT_APP_STATE_TOTAL_BYTES,
+  MAX_AGENT_CONTEXT_ENTRIES,
+  agentContext,
+  agentContextFingerprint,
+  agentContextIdentity,
+  normalizeAgentContextEntries
+} from "../chunk-f2b5e2gf.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+export {
+  normalizeAgentContextEntries,
+  agentContextIdentity,
+  agentContextFingerprint,
+  agentContext,
+  MAX_AGENT_CONTEXT_ENTRIES,
+  MAX_AGENT_APP_STATE_TOTAL_BYTES,
+  MAX_AGENT_APP_STATE_ENTRY_BYTES
+};
+
+//# debugId=E92147A2E6E34B4264756E2164756E21

package/dist/agents/context.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "E92147A2E6E34B4264756E2164756E21",
+  "names": []
+}

package/dist/agents/dispatch.d.ts

@@ -0,0 +1,36 @@
+import type { AgentQueueJob, Queue } from "../queues";
+import type { AgentStorage } from "../storage/agents";
+export interface DispatchQueuedAgentRunsInput {
+    readonly projectId: string;
+    readonly storage: AgentStorage;
+    readonly queue: Queue<AgentQueueJob>;
+    /** Dispatch only these runs. Omitted scans the oldest queued runs. */
+    readonly runIds?: readonly string[];
+    readonly limit?: number;
+}
+export interface DispatchedAgentRun {
+    readonly runId: string;
+    readonly jobId: string;
+}
+export interface AgentRunDispatchFailure {
+    readonly runId: string;
+    readonly error: unknown;
+}
+export interface DispatchQueuedAgentRunsResult {
+    readonly scanned: number;
+    readonly dispatched: readonly DispatchedAgentRun[];
+    readonly failures: readonly AgentRunDispatchFailure[];
+}
+/** Stable queue identity: repeated publication of one durable run is idempotent. */
+export declare function agentRunQueueJobId(runId: string): string;
+/** Stable queue identity shared by workflow dispatch and agent reconciliation. */
+export declare function workflowAgentNodeQueueJobId(nodeRunId: string): string;
+/**
+ * Publish durable queued runs to the agent queue.
+ *
+ * The queued run is the dispatch intent, so no parallel outbox record is needed. Callers may run
+ * this concurrently: the deterministic queue job id collapses repeated publication to one active
+ * job, while the worker's queued→running transition remains the execution authority.
+ */
+export declare function dispatchQueuedAgentRuns(input: DispatchQueuedAgentRunsInput): Promise<DispatchQueuedAgentRunsResult>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/agents/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/agents/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IACpC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAA;CACtD;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,kFAAkF;AAClF,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CAmDxC"}

package/dist/agents/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Base error for the agents module. Specific subclasses extend this so callers
+ * can catch any agent-scoped failure with a single `instanceof AgentDefinitionError` check.
+ */
+export declare class AgentDefinitionError extends Error {
+    readonly name: string;
+}
+/**
+ * Raised by the message adapters. `fromAiSdk` is **total**: rather than silently dropping a part it
+ * cannot model, it throws this — which both prevents data loss and pinpoints exactly when the
+ * {@link AgentMessage} part union must be extended. It also fires on transient/streaming parts that
+ * must never be persisted, and on out-of-contract (non-JSON) payloads.
+ */
+export declare class AgentMessageAdapterError extends Error {
+    readonly name = "AgentMessageAdapterError";
+}
+export type AgentRequestErrorCode = "agent_not_found" | "thread_not_found" | "thread_agent_mismatch" | "active_run_exists" | "invalid_context" | "storage_unavailable";
+/**
+ * Raised by {@link requestAgentRun} (the trigger). Callers branch on `code` rather than message text
+ * — e.g. the HTTP layer maps `active_run_exists` to 409 and `agent_not_found` to 404.
+ */
+export declare class AgentRequestError extends Error {
+    readonly code: AgentRequestErrorCode;
+    readonly name = "AgentRequestError";
+    constructor(code: AgentRequestErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/agents/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,8BAA6B;CAC3C;AAED,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,kBAAkB,GAClB,uBAAuB,GACvB,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,CAAA;AAEzB;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAHtC,QAAQ,CAAC,IAAI,uBAAsB;gBAGxB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;CAIlB"}

package/dist/agents/ids.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Id helpers for agent persistence. Threads, the run id, and the user (trigger) message are minted
+ * by the trigger; the queued run is persisted with the user message, and the assistant message id
+ * is minted when the turn finalizes. Prefixes make ids self-describing in logs.
+ */
+export declare function createAgentThreadId(): string;
+export declare function createAgentRunId(): string;
+export declare function createAgentMessageId(): string;
+/** A queue delivery's fencing token for writes to an `agent_runs` record. */
+export declare function createAgentRunExecutionToken(): string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/agents/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/agents/ids.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}

package/dist/agents/index.d.ts

@@ -0,0 +1,24 @@
+export type { AgentFileDataProjection, AgentFileDataResolverInput, AgentInboundUiMessage, AgentInboundUiMessagePart, AgentModelAssistantPart, AgentModelFilePart, AgentModelMessage, AgentModelReasoningPart, AgentModelTextPart, AgentModelToolCallPart, AgentModelToolOutput, AgentModelToolResultPart, AgentUiMessage, AgentUiMessagePart, AgentUiToolPart, ToModelMessagesOptions, } from "./adapters";
+export { fromAiSdk, toModelMessages, toUiMessage } from "./adapters";
+export type { AgentApiGatewayCapabilityInput, AgentApiRoute } from "./api-gateway";
+export { AGENT_API_GATEWAY_PREFIX, AGENT_API_ROUTES, createAgentApiGatewayCapability, isAllowedAgentApiRequest, isValidAgentApiGatewayCapability, } from "./api-gateway";
+export { defineAgent } from "./builders";
+export type { AgentContextEntryInput, AgentContextInput, AgentContextOrigin, AgentContextPart, } from "./context";
+export { agentContext, agentContextFingerprint, agentContextIdentity, MAX_AGENT_APP_STATE_ENTRY_BYTES, MAX_AGENT_APP_STATE_TOTAL_BYTES, MAX_AGENT_CONTEXT_ENTRIES, normalizeAgentContextEntries, } from "./context";
+export { serializeAgentContextForModel } from "./context-model";
+export { resolveAgentContextParts } from "./context-resolution";
+export type { AgentRunDispatchFailure, DispatchedAgentRun, DispatchQueuedAgentRunsInput, DispatchQueuedAgentRunsResult, } from "./dispatch";
+export { agentRunQueueJobId, dispatchQueuedAgentRuns, workflowAgentNodeQueueJobId, } from "./dispatch";
+export { AgentDefinitionError, AgentMessageAdapterError, AgentRequestError, type AgentRequestErrorCode, } from "./errors";
+export { createAgentMessageId, createAgentRunExecutionToken, createAgentRunId, createAgentThreadId, } from "./ids";
+export { AGENT_MESSAGE_CONTENT_VERSION, type AgentFilePart, type AgentMessage, type AgentMessagePart, type AgentMessagePartType, type AgentMessageRole, type AgentReasoningPart, type AgentStepStartPart, type AgentTextPart, type AgentToolCallPart, type AgentToolCallState, } from "./message";
+export { type BuildAgentSystemPromptInput, buildAgentSystemPrompt, DEFAULT_AGENT_SYSTEM_CONTEXT, DEFAULT_AGENT_TASK_SYSTEM_CONTEXT, } from "./prompt";
+export { type RequestAgentRunInput, type RequestAgentRunResult, requestAgentRun, } from "./request";
+export type { ScopedListAgentThreadsInput } from "./runtime";
+export { AgentsRuntime } from "./runtime";
+export type { AgentRunControlStreamId, AgentRunFinishedEvent, AgentRunStreamEvent, AgentRunStreamId, } from "./streams";
+export { AGENT_RUN_CANCEL_RECORD, AGENT_RUN_STREAM_SCHEMA_VERSION, agentRunControlStreamDefinition, agentRunControlStreamId, agentRunFinishedEvent, agentRunStreamDefinition, agentRunStreamId, agentRunStreamIdempotencyKey, DEFAULT_AGENT_RUN_STREAM_RETENTION, publishAgentRunCancel, publishAgentRunFinished, subscribeAgentRunCancel, } from "./streams";
+export type { AgentDefinition, AgentLoopConfig, AgentReasoningLevel, DefineAgentConfig, } from "./types";
+export { AGENT_REASONING_LEVELS } from "./types";
+export { isAgentDefinition, validateAgentGroupReferences } from "./validation";
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

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

package/dist/agents/index.js

@@ -0,0 +1,121 @@
+// @bun
+import {
+  AGENT_API_GATEWAY_PREFIX,
+  AGENT_API_ROUTES,
+  AGENT_REASONING_LEVELS,
+  AgentsRuntime,
+  DEFAULT_AGENT_SYSTEM_CONTEXT,
+  DEFAULT_AGENT_TASK_SYSTEM_CONTEXT,
+  agentRunQueueJobId,
+  buildAgentSystemPrompt,
+  createAgentApiGatewayCapability,
+  createAgentMessageId,
+  createAgentRunExecutionToken,
+  createAgentRunId,
+  createAgentThreadId,
+  defineAgent,
+  dispatchQueuedAgentRuns,
+  fromAiSdk,
+  isAgentDefinition,
+  isAllowedAgentApiRequest,
+  isValidAgentApiGatewayCapability,
+  requestAgentRun,
+  resolveAgentContextParts,
+  serializeAgentContextForModel,
+  toModelMessages,
+  toUiMessage,
+  validateAgentGroupReferences,
+  workflowAgentNodeQueueJobId
+} from "../chunk-nvamz5dv.js";
+import"../chunk-8r8cw2xw.js";
+import"../chunk-vj723r3p.js";
+import"../chunk-51fjndv0.js";
+import {
+  AGENT_MESSAGE_CONTENT_VERSION
+} from "../chunk-k41ajtz7.js";
+import"../chunk-4pycxcj3.js";
+import {
+  AgentDefinitionError,
+  AgentMessageAdapterError,
+  AgentRequestError,
+  MAX_AGENT_APP_STATE_ENTRY_BYTES,
+  MAX_AGENT_APP_STATE_TOTAL_BYTES,
+  MAX_AGENT_CONTEXT_ENTRIES,
+  agentContext,
+  agentContextFingerprint,
+  agentContextIdentity,
+  normalizeAgentContextEntries
+} from "../chunk-f2b5e2gf.js";
+import {
+  AGENT_RUN_CANCEL_RECORD,
+  AGENT_RUN_STREAM_SCHEMA_VERSION,
+  DEFAULT_AGENT_RUN_STREAM_RETENTION,
+  agentRunControlStreamDefinition,
+  agentRunControlStreamId,
+  agentRunFinishedEvent,
+  agentRunStreamDefinition,
+  agentRunStreamId,
+  agentRunStreamIdempotencyKey,
+  publishAgentRunCancel,
+  publishAgentRunFinished,
+  subscribeAgentRunCancel
+} from "../chunk-k25jm1x5.js";
+import"../chunk-dcgrzj1t.js";
+import"../chunk-xwnf87e1.js";
+import"../chunk-0fygrz37.js";
+import"../chunk-btpe64e4.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+export {
+  workflowAgentNodeQueueJobId,
+  validateAgentGroupReferences,
+  toUiMessage,
+  toModelMessages,
+  subscribeAgentRunCancel,
+  serializeAgentContextForModel,
+  resolveAgentContextParts,
+  requestAgentRun,
+  publishAgentRunFinished,
+  publishAgentRunCancel,
+  normalizeAgentContextEntries,
+  isValidAgentApiGatewayCapability,
+  isAllowedAgentApiRequest,
+  isAgentDefinition,
+  fromAiSdk,
+  dispatchQueuedAgentRuns,
+  defineAgent,
+  createAgentThreadId,
+  createAgentRunId,
+  createAgentRunExecutionToken,
+  createAgentMessageId,
+  createAgentApiGatewayCapability,
+  buildAgentSystemPrompt,
+  agentRunStreamIdempotencyKey,
+  agentRunStreamId,
+  agentRunStreamDefinition,
+  agentRunQueueJobId,
+  agentRunFinishedEvent,
+  agentRunControlStreamId,
+  agentRunControlStreamDefinition,
+  agentContextIdentity,
+  agentContextFingerprint,
+  agentContext,
+  MAX_AGENT_CONTEXT_ENTRIES,
+  MAX_AGENT_APP_STATE_TOTAL_BYTES,
+  MAX_AGENT_APP_STATE_ENTRY_BYTES,
+  DEFAULT_AGENT_TASK_SYSTEM_CONTEXT,
+  DEFAULT_AGENT_SYSTEM_CONTEXT,
+  DEFAULT_AGENT_RUN_STREAM_RETENTION,
+  AgentsRuntime,
+  AgentRequestError,
+  AgentMessageAdapterError,
+  AgentDefinitionError,
+  AGENT_RUN_STREAM_SCHEMA_VERSION,
+  AGENT_RUN_CANCEL_RECORD,
+  AGENT_REASONING_LEVELS,
+  AGENT_MESSAGE_CONTENT_VERSION,
+  AGENT_API_ROUTES,
+  AGENT_API_GATEWAY_PREFIX
+};
+
+//# debugId=E9DC4F8F4D05C48864756E2164756E21

package/dist/agents/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "E9DC4F8F4D05C48864756E2164756E21",
+  "names": []
+}

package/dist/agents/message.d.ts

@@ -0,0 +1,78 @@
+import type { FileRef } from "../blob-storage";
+import type { JsonValue } from "../json";
+import type { AgentContextPart } from "./context";
+/**
+ * The agent's own, SDK-independent message. We store messages and threads — not an SDK transport —
+ * so a message is just a `role` plus structured `parts` (and optional `metadata`). There is no
+ * self-describing wrapper: the storage row owns the message's identity, and `contentVersion` (a
+ * column) versions the parts shape so it can be migrated.
+ *
+ * The part union is intentionally focused on what V1 agents actually produce (text, reasoning, step
+ * boundaries, tool calls). It is extensible: adding a part kind later is non-breaking. The adapter
+ * `fromAiSdk` is total — it throws on any part it cannot model rather than dropping it silently,
+ * which both prevents data loss and signals exactly when the union must grow.
+ */
+export declare const AGENT_MESSAGE_CONTENT_VERSION: 1;
+export type AgentMessageRole = "system" | "user" | "assistant";
+/** A plain text part (assistant output, user input, or system text). */
+export interface AgentTextPart {
+    readonly type: "text";
+    readonly text: string;
+    /** Provider passthrough (kept because some providers require it on the next turn). */
+    readonly providerMetadata?: JsonValue;
+}
+/**
+ * A reasoning ("thinking") part. `providerMetadata` is load-bearing here: some providers require
+ * the reasoning signature back on the following turn, so dropping it would break multi-step loops.
+ */
+export interface AgentReasoningPart {
+    readonly type: "reasoning";
+    readonly text: string;
+    readonly providerMetadata?: JsonValue;
+}
+/** A step boundary between assistant loop iterations. */
+export interface AgentStepStartPart {
+    readonly type: "step-start";
+}
+/** A blob-backed file attached to a user message or produced by an agent/tool. */
+export interface AgentFilePart {
+    readonly type: "file";
+    readonly fileRef: FileRef;
+    /** Provider passthrough for future model-specific file handling. */
+    readonly providerMetadata?: JsonValue;
+}
+interface AgentToolCallBase {
+    readonly type: "tool-call";
+    readonly toolCallId: string;
+    readonly toolName: string;
+    /** `true` when reconstructed from an SDK `dynamic-tool` part (vs a static `tool-${name}` part). */
+    readonly dynamic?: boolean;
+    /** `true` when the provider executed the tool inline (steers model projection). V1 = `false`. */
+    readonly providerExecuted?: boolean;
+    readonly input: JsonValue;
+    readonly providerMetadata?: JsonValue;
+}
+/**
+ * A completed tool call. Only terminal states are modelled — transient states
+ * (`input-streaming`, `input-available`, `approval-*`) are never persisted because messages are
+ * written only once a run finishes.
+ */
+export type AgentToolCallPart = AgentToolCallBase & ({
+    readonly state: "output-available";
+    readonly output: JsonValue;
+} | {
+    readonly state: "output-error";
+    readonly errorText: string;
+});
+export type AgentMessagePart = AgentTextPart | AgentReasoningPart | AgentStepStartPart | AgentFilePart | AgentContextPart | AgentToolCallPart;
+export type AgentMessagePartType = AgentMessagePart["type"];
+export type AgentToolCallState = AgentToolCallPart["state"];
+/** The logical agent message the adapters speak and the store persists (as columns). */
+export interface AgentMessage {
+    readonly role: AgentMessageRole;
+    readonly parts: readonly AgentMessagePart[];
+    /** Message-level metadata (mirrors `UIMessage.metadata`). */
+    readonly metadata?: JsonValue;
+}
+export {};
+//# sourceMappingURL=message.d.ts.map

package/dist/agents/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/agents/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,EAAG,CAAU,CAAA;AAEvD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;AAE9D,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sFAAsF;IACtF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAA;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAA;CACtC;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAA;CACtC;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAA;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAC/C,CACI;IAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CACjE,CAAA;AAEH,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,kBAAkB,GAClB,kBAAkB,GAClB,aAAa,GACb,gBAAgB,GAChB,iBAAiB,CAAA;AAErB,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAC3D,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;AAE3D,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC3C,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAC9B"}

package/dist/agents/prompt.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_AGENT_SYSTEM_CONTEXT: string;
+export declare const DEFAULT_AGENT_TASK_SYSTEM_CONTEXT: string;
+export interface BuildAgentSystemPromptInput {
+    readonly instructions: string;
+    readonly addendum?: string;
+    readonly mode?: "conversation" | "task";
+}
+/**
+ * Compose the framework-owned system prompt for every agent turn.
+ *
+ * Core Sixb rules are first and explicitly separated from runtime context and project-authored
+ * agent instructions so models can distinguish platform behavior from agent-specific goals.
+ */
+export declare function buildAgentSystemPrompt(input: BuildAgentSystemPromptInput): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/agents/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/agents/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,QAQ7B,CAAA;AAEZ,eAAO,MAAM,iCAAiC,QAKlC,CAAA;AAEZ,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAAA;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAWjF"}

package/dist/agents/request.d.ts

@@ -0,0 +1,42 @@
+import type { Principal } from "../auth";
+import type { FileRef } from "../blob-storage";
+import type { SixbRuntimeContext } from "../runtime/types";
+import { type AgentRunRecord } from "../storage/agents";
+import type { AgentContextEntryInput } from "./context";
+import type { AgentDefinition } from "./types";
+export interface RequestAgentRunInput {
+    /** The agent to run. */
+    readonly agentId: string;
+    /** The user's message that triggers the turn. */
+    readonly text: string;
+    /** Blob-backed files attached to the trigger message. */
+    readonly attachments?: readonly FileRef[];
+    /** Structured page/object context snapshotted onto the triggering user message. */
+    readonly context?: readonly AgentContextEntryInput[];
+    /** Continue an existing thread. Omitted → a fresh thread is created for this agent. */
+    readonly threadId?: string;
+    /** Title to stamp on the thread when one is created. */
+    readonly title?: string;
+    /** Explicit id for the trigger (user) message. Defaults to a generated id. */
+    readonly messageId?: string;
+    /** Owner principal for a newly created thread. Defaults to the system principal until auth lands. */
+    readonly principal?: Principal;
+}
+export interface RequestAgentRunResult {
+    /** The durable queued run exactly as it was created (`status: "queued"`, attempt 0). */
+    readonly run: AgentRunRecord;
+    /** The enqueued job id, when the queue returns one. */
+    readonly jobId?: string;
+    /** Whether this call created the thread. */
+    readonly createdThread: boolean;
+}
+/**
+ * Trigger an agent turn.
+ *
+ * The user message and a `queued` run are persisted atomically before the queue intent is
+ * published. This makes accepted work visible immediately and lets refresh reconstruct queue state.
+ * The run's thread claim is the single-flight authority; a second request receives
+ * `active_run_exists` before it can leave an orphan message.
+ */
+export declare function requestAgentRun(runtime: SixbRuntimeContext, agent: AgentDefinition, input: RequestAgentRunInput): Promise<RequestAgentRunResult>;
+//# sourceMappingURL=request.d.ts.map

package/dist/agents/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/agents/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAGxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAKvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IACzC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACpD,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,qGAAqG;IACrG,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAA;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CA+FhC"}

package/dist/agents/runtime.d.ts

@@ -0,0 +1,41 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { AgentThreadRecord, ListAgentThreadsInput, ListAgentThreadsResult } from "../storage/agents";
+import { type RequestAgentRunInput, type RequestAgentRunResult } from "./request";
+import type { AgentDefinition } from "./types";
+/** The caller-supplied part of a thread listing; owner + grant filters are derived from the runtime. */
+export type ScopedListAgentThreadsInput = Omit<ListAgentThreadsInput, "projectId" | "agentIds" | "ownerPrincipal">;
+/**
+ * Holds the agent definitions registered with a Sixb instance and exposes lookup + the run trigger.
+ *
+ * Definition lookup (`list` / `getById`) is what the worker uses to resolve a run's model (the model
+ * is a non-serialisable language model, so it is never sent over the wire). `request(...)` is the
+ * trigger surface, mirroring `sixb.actions.request`.
+ *
+ * Duplicate ids are rejected by the `Sixb` constructor before this is built.
+ */
+export declare class AgentsRuntime {
+    private readonly runtime;
+    private readonly agentsById;
+    constructor(runtime: SixbRuntimeContext, agents: readonly AgentDefinition[]);
+    /** All registered agent definitions. */
+    list(): readonly AgentDefinition[];
+    /** Look up a registered agent definition by id. */
+    getById(agentId: string): AgentDefinition | null;
+    /** Trigger an agent turn: persist its queued run and user message, then dispatch the intent. */
+    request(input: RequestAgentRunInput): Promise<RequestAgentRunResult>;
+    /**
+     * Trigger an agent turn on behalf of an explicit runtime context, so scoped
+     * SDKs can enforce caller grants while reusing the registered definitions.
+     */
+    requestAs(runtime: SixbRuntimeContext, input: RequestAgentRunInput): Promise<RequestAgentRunResult>;
+    /**
+     * List threads visible to an explicit runtime. A scoped runtime is filtered to threads it owns and
+     * holds `run:agent` on (via the storage `agentIds` + `ownerPrincipal` filters); a privileged
+     * runtime sees all. Missing agent storage yields an empty page rather than throwing, so a
+     * listing on an agent-less deployment degrades gracefully.
+     */
+    listThreadsAs(runtime: SixbRuntimeContext, input?: ScopedListAgentThreadsInput): Promise<ListAgentThreadsResult>;
+    /** Read a single thread through the runtime's scope; returns null when absent or inaccessible. */
+    getThreadAs(runtime: SixbRuntimeContext, threadId: string): Promise<AgentThreadRecord | null>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/agents/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/agents/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAmB,MAAM,WAAW,CAAA;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,wGAAwG;AACxG,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,qBAAqB,EACrB,WAAW,GAAG,UAAU,GAAG,gBAAgB,CAC5C,CAAA;AAkBD;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;gBAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,eAAe,EAAE;IAK3E,wCAAwC;IACxC,IAAI,IAAI,SAAS,eAAe,EAAE;IAIlC,mDAAmD;IACnD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAIhD,gGAAgG;IAChG,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIpE;;;OAGG;IACH,SAAS,CACP,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC;IAQjC;;;;;OAKG;IACG,aAAa,CACjB,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,2BAAgC,GACtC,OAAO,CAAC,sBAAsB,CAAC;IAoBlC,kGAAkG;IAC5F,WAAW,CACf,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAQrC"}

package/dist/agents/streams.d.ts

@@ -0,0 +1,72 @@
+import type { Broker, BrokerStreamDefinition } from "../broker";
+import type { JsonValue } from "../json";
+import type { AgentRunRecord } from "../storage/agents/types";
+export declare const AGENT_RUN_STREAM_SCHEMA_VERSION: 1;
+export declare const DEFAULT_AGENT_RUN_STREAM_RETENTION: {
+    readonly maxAgeMs: number;
+    readonly maxRecords: 5000;
+};
+export type AgentRunStreamId = `agents.runs.${string}`;
+export declare function agentRunStreamId(runId: string): AgentRunStreamId;
+export declare function agentRunStreamDefinition(runId: string): BrokerStreamDefinition;
+interface AgentRunStreamEventBase {
+    readonly schemaVersion: typeof AGENT_RUN_STREAM_SCHEMA_VERSION;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly threadId: string;
+    readonly agentId: string;
+    readonly attempt: number;
+    readonly occurredAt: string;
+}
+export type AgentRunControlStreamId = `agents.runs.${string}.control`;
+export declare function agentRunControlStreamId(runId: string): AgentRunControlStreamId;
+/** The only control record: a request to stop the run. */
+export declare const AGENT_RUN_CANCEL_RECORD = "agent.run.cancel";
+export declare function agentRunControlStreamDefinition(runId: string): BrokerStreamDefinition;
+/**
+ * Signal a run to stop. Publishing is addressed by `runId`, so it works whether the run is queued,
+ * reserved, or being drained — the worker picks the record up when it subscribes.
+ */
+export declare function publishAgentRunCancel(broker: Broker, params: {
+    readonly projectId: string;
+    readonly runId: string;
+}): Promise<void>;
+/**
+ * Watch a run's control stream and invoke `onCancel` when a cancel arrives. Reads from `earliest` so
+ * a cancel published before the worker subscribed (a run stopped while still queued) is still seen.
+ * Returns the unsubscribe handle.
+ */
+export declare function subscribeAgentRunCancel(broker: Broker, params: {
+    readonly projectId: string;
+    readonly runId: string;
+}, onCancel: () => void): Promise<() => void>;
+export type AgentRunStreamEvent = (AgentRunStreamEventBase & {
+    readonly type: "agent.run.started";
+    readonly modelId?: string;
+}) | (AgentRunStreamEventBase & {
+    readonly type: "agent.ui.chunk";
+    readonly chunkIndex: number;
+    readonly chunk: JsonValue;
+}) | (AgentRunStreamEventBase & {
+    readonly type: "agent.message.finalized";
+    readonly messageId: string;
+}) | (AgentRunStreamEventBase & {
+    readonly type: "agent.run.finished";
+    readonly status: "succeeded" | "failed" | "cancelled";
+    readonly finishReason?: string;
+    readonly error?: string;
+});
+export type AgentRunFinishedEvent = Extract<AgentRunStreamEvent, {
+    type: "agent.run.finished";
+}>;
+/** Build the terminal stream event for a finished run. Throws if the run is not terminal. */
+export declare function agentRunFinishedEvent(run: AgentRunRecord, occurredAt?: Date): AgentRunFinishedEvent;
+/** Single owner of the idempotency-key vocabulary for agent run stream records. */
+export declare function agentRunStreamIdempotencyKey(event: AgentRunStreamEvent): string;
+/**
+ * Ensure the run's stream and append its terminal record — mirrors {@link publishAgentRunCancel}.
+ * Used where a terminal transition happens outside the worker (e.g. cancelling a queued run).
+ */
+export declare function publishAgentRunFinished(broker: Broker, run: AgentRunRecord): Promise<void>;
+export {};
+//# sourceMappingURL=streams.d.ts.map

package/dist/agents/streams.d.ts.map

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