@sixb/core 0.1.2 → 0.1.4

package/dist/agents/streams.d.ts

@@ -1,7 +1,7 @@
 import type { Broker, BrokerStreamDefinition } from "../broker";
 import type { SixbFailure } from "../errors/types";
 import { type JsonValue } from "../json";
-import { type AgentRunFailureCode, type AgentRunRecord } from "../storage/agents/types";
+import { type AgentContextCheckpointReason, type AgentRunFailureCode, 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;
@@ -64,9 +64,25 @@ export declare function subscribeAgentRunCancel(broker: Broker, params: {
 }, onCancel: () => void): Promise<() => void>;
 /** Exact portable failure exposed by a terminal Agent run stream event. */
 export type AgentRunFailure = SixbFailure<AgentRunFailureCode>;
+export declare const AGENT_COMPACTION_FAILURE_CODES: readonly ["context_limit_exceeded", "summary_failed", "checkpoint_failed"];
+export type AgentCompactionFailureCode = (typeof AGENT_COMPACTION_FAILURE_CODES)[number];
 export type AgentRunStreamEvent = (AgentRunStreamEventBase & {
     readonly type: "agent.run.started";
     readonly modelId?: string;
+}) | (AgentRunStreamEventBase & {
+    readonly type: "agent.compaction.started";
+    readonly reason: AgentContextCheckpointReason;
+    readonly estimatedInputTokensBefore: number;
+}) | (AgentRunStreamEventBase & {
+    readonly type: "agent.compaction.completed";
+    readonly reason: AgentContextCheckpointReason;
+    readonly checkpointId: string;
+    readonly estimatedInputTokensBefore: number;
+    readonly estimatedInputTokensAfter: number;
+}) | (AgentRunStreamEventBase & {
+    readonly type: "agent.compaction.failed";
+    readonly reason: AgentContextCheckpointReason;
+    readonly errorCode: AgentCompactionFailureCode;
 }) | (AgentRunStreamEventBase & {
     readonly type: "agent.ui.chunk";
     readonly chunkIndex: number;

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

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

package/dist/agents/streams.js

@@ -2,6 +2,7 @@
 import {
   AGENT_ACTIVITY_STREAM_ID,
   AGENT_ACTIVITY_STREAM_SCHEMA_VERSION,
+  AGENT_COMPACTION_FAILURE_CODES,
   AGENT_RUN_CANCEL_RECORD,
   AGENT_RUN_STREAM_SCHEMA_VERSION,
   DEFAULT_AGENT_ACTIVITY_STREAM_RETENTION,
@@ -20,8 +21,8 @@ import {
   publishAgentRunCancel,
   publishAgentRunFinished,
   subscribeAgentRunCancel
-} from "../chunk-57zpb99z.js";
-import"../chunk-663csy96.js";
+} from "../chunk-dm72y8wt.js";
+import"../chunk-t0jjkep3.js";
 import"../chunk-0172wgm9.js";
 import"../chunk-t8t39h7v.js";
 import"../chunk-y64skrwp.js";
@@ -44,8 +45,9 @@ export {
   DEFAULT_AGENT_ACTIVITY_STREAM_RETENTION,
   AGENT_RUN_STREAM_SCHEMA_VERSION,
   AGENT_RUN_CANCEL_RECORD,
+  AGENT_COMPACTION_FAILURE_CODES,
   AGENT_ACTIVITY_STREAM_SCHEMA_VERSION,
   AGENT_ACTIVITY_STREAM_ID
 };
 
-//# debugId=9EC67E598672F93464756E2164756E21
+//# debugId=37D1CCE42757910764756E2164756E21

package/dist/agents/streams.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "9EC67E598672F93464756E2164756E21",
+  "debugId": "37D1CCE42757910764756E2164756E21",
   "names": []
 }

package/dist/agents/thread-context-projection.d.ts

@@ -0,0 +1,19 @@
+import type { AgentContextCheckpointRecord, AgentMessageRecord } from "../storage/agents/types";
+import type { AgentMessage } from "./message";
+/** A model-only message. Persisted tail messages carry `id`; the synthetic summary does not. */
+export interface AgentThreadModelContextMessage extends AgentMessage {
+    readonly id?: string;
+}
+export interface ProjectAgentThreadModelContextInput {
+    readonly checkpoint: AgentContextCheckpointRecord | null;
+    /** Complete retained tail, ordered by ascending per-thread sequence. */
+    readonly messages: readonly AgentMessageRecord[];
+}
+/**
+ * Build the bounded, model-only view of a durable thread.
+ *
+ * The function is deliberately pure: storage chooses the latest checkpoint and reads its retained
+ * tail; this function validates that projection and prepends one synthetic user-role summary.
+ */
+export declare function projectAgentThreadModelContext(input: ProjectAgentThreadModelContextInput): readonly AgentThreadModelContextMessage[];
+//# sourceMappingURL=thread-context-projection.d.ts.map

package/dist/agents/thread-context-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-context-projection.d.ts","sourceRoot":"","sources":["../../src/agents/thread-context-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,gGAAgG;AAChG,MAAM,WAAW,8BAA+B,SAAQ,YAAY;IAClE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,GAAG,IAAI,CAAA;IACxD,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mCAAmC,GACzC,SAAS,8BAA8B,EAAE,CAY3C"}

package/dist/agents/tool-definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-definition.d.ts","sourceRoot":"","sources":["../../src/agents/tool-definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,SAAS,CAAA;AAWhB,wBAAgB,yBAAyB,CACvC,KAAK,CAAC,KAAK,SAAS,MAAM,EAC1B,KAAK,CAAC,MAAM,SAAS,oBAAoB,EACzC,UAAU,EAAE;IACZ,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CACtE,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CA+BrC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,GAChD,SAAS,mBAAmB,EAAE,CAiBhC"}
+{"version":3,"file":"tool-definition.d.ts","sourceRoot":"","sources":["../../src/agents/tool-definition.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,SAAS,CAAA;AAWhB,wBAAgB,yBAAyB,CACvC,KAAK,CAAC,KAAK,SAAS,MAAM,EAC1B,KAAK,CAAC,MAAM,SAAS,oBAAoB,EACzC,UAAU,EAAE;IACZ,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CACtE,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAwCrC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,GAChD,SAAS,mBAAmB,EAAE,CAiBhC"}

package/dist/agents/tool-result.d.ts

@@ -0,0 +1,6 @@
+import type { AgentToolResult } from "./types";
+/** Narrow a durable JSON tool output to Sixb's file-aware result envelope. */
+export declare function isAgentToolResult(value: unknown): value is AgentToolResult;
+/** Return a precise path when a tagged result does not satisfy the public rich-result contract. */
+export declare function getInvalidAgentToolResultReason(value: unknown): string | undefined;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/agents/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../src/agents/tool-result.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAM1E;AAED,mGAAmG;AACnG,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CA8ClF"}

package/dist/agents/types.d.ts

@@ -1,4 +1,5 @@
 import type { LanguageModelV4, LanguageModelV4CallOptions } from "@ai-sdk/provider";
+import type { BlobBody, FileRef } from "../blob-storage";
 import type { ConnectorRuntime } from "../connectors";
 import type { JsonPrimitive, JsonValue, ReadonlyJsonValue } from "../json";
 import type { Logger } from "../logging";
@@ -8,6 +9,14 @@ import type { GroupDefinition } from "../security";
 export type { AgentContextEntryInput, AgentContextInput, AgentContextOrigin, AgentContextPart, } from "./context";
 export type AgentReasoningLevel = NonNullable<LanguageModelV4CallOptions["reasoning"]>;
 export declare const AGENT_REASONING_LEVELS: readonly ["provider-default", "none", "minimal", "low", "medium", "high", "xhigh"];
+export interface AgentContextConfig {
+    /** Override the provider context-window size inferred by the agent worker. */
+    readonly windowTokens?: number;
+    /** Tokens reserved for the next response and compaction work. */
+    readonly reserveTokens?: number;
+    /** Approximate recent-message budget retained verbatim after compaction. */
+    readonly keepRecentTokens?: number;
+}
 /**
  * Loop / stop controls for an agent run.
  *
@@ -17,6 +26,7 @@ export interface AgentLoopConfig {
     readonly stopWhen?: {
         readonly maxSteps?: number;
     };
+    readonly context?: AgentContextConfig;
 }
 type Simplify<T> = {
     [K in keyof T]: T[K];
@@ -36,16 +46,51 @@ export interface AgentToolRunInfo {
     readonly agentId: string;
     readonly threadId?: string;
 }
+/** Input accepted by the run-scoped artifact publisher exposed to agent tools. */
+export interface AgentToolArtifactPutInput {
+    readonly body: BlobBody;
+    readonly fileName: string;
+    readonly mediaType?: string;
+}
+/** A durable artifact and its path inside the current run sandbox. */
+export interface AgentToolArtifact {
+    readonly fileRef: FileRef;
+    readonly sandboxPath: string;
+}
+/** The narrow artifact-writing surface available to an agent tool call. */
+export interface AgentToolArtifacts {
+    put(input: AgentToolArtifactPutInput): Promise<AgentToolArtifact>;
+}
+export type AgentToolTextContent = {
+    readonly type: "text";
+    readonly text: string;
+};
+export type AgentToolFileContent = {
+    readonly type: "file";
+    readonly fileRef: FileRef;
+};
+/** Durable model-facing content returned by a file-aware tool. */
+export type AgentToolContent = AgentToolTextContent | AgentToolFileContent;
+/**
+ * A file-aware tool result. The tag distinguishes this envelope from an ordinary JSON result while
+ * keeping the whole value safe to persist in the durable tool-call trace.
+ */
+export type AgentToolResult = {
+    readonly kind: "agentToolResult";
+    readonly content: readonly AgentToolContent[];
+};
 /** The narrow, run-scoped surface passed to an agent tool handler. */
 export interface AgentToolRunContext<TInput extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>> {
     readonly input: TInput;
+    readonly toolCallId: string;
     readonly signal: AbortSignal;
     readonly run: AgentToolRunInfo;
     readonly connector: ConnectorRuntime;
     readonly logger: Logger;
+    readonly artifacts: AgentToolArtifacts;
 }
 /** Agent tool handlers may return only values safe to persist in agent messages. */
-export type AgentToolHandlerResult = ReadonlyJsonValue | Promise<ReadonlyJsonValue>;
+export type AgentToolHandlerResult = ReadonlyJsonValue | AgentToolResult | Promise<ReadonlyJsonValue | AgentToolResult>;
 export type AgentToolHandler<TInput extends Readonly<Record<string, unknown>>> = (context: AgentToolRunContext<TInput>) => AgentToolHandlerResult;
 /**
  * Runtime definitions are stored heterogeneously. Keep variance erasure at this

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAElB,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAA;AAEtF,eAAO,MAAM,sBAAsB,oFAQgB,CAAA;AAEnD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAC3B,CAAA;CACF;AAED,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAA;AAChD,KAAK,qBAAqB,CAAC,CAAC,IAAI,OAAO,SAAS,CAAC,GAC7C,iBAAiB,GACjB,CAAC,SAAS,IAAI,GACZ,MAAM,GACN,CAAC,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GAChC,SAAS,qBAAqB,CAAC,KAAK,CAAC,EAAE,GACvC,CAAC,SAAS,aAAa,GACrB,CAAC,GACD,CAAC,SAAS,MAAM,GACd;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACxD,KAAK,CAAA;AAEjB,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAEnE,mEAAmE;AACnE,MAAM,MAAM,yBAAyB,CAAC,MAAM,SAAS,oBAAoB,IACvE,MAAM,SAAS,MAAM,MAAM,GACvB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACjC,QAAQ,CAAC;IACP,QAAQ,EAAE,CAAC,IAAI,MAAM,MAAM,GAAG,qBAAqB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5E,CAAC,CAAA;AAER,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB,CAClC,MAAM,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,oFAAoF;AACpF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAEnF,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAC/E,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,KACjC,sBAAsB,CAAA;AAE3B;;;GAGG;AACH,KAAK,sBAAsB,CAAC,MAAM,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI;IAC9E,cAAc,CAAC,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;CACrF,CAAC,gBAAgB,CAAC,CAAA;AAEnB,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB,CAClC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB;IAE1D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAA;CAC5E;AAED,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,CAAC,KAAK,SAAS,mBAAmB,IAAI,yBAAyB,CAC5F,KAAK,CAAC,OAAO,CAAC,CACf,CAAA;AAED,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,MAAM,SAAS,oBAAoB;IAC5F,GAAG,CACD,OAAO,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,GAC3D,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,qBAAqB,CAAC,KAAK,SAAS,MAAM;IACzD,KAAK,CAAC,KAAK,CAAC,MAAM,SAAS,oBAAoB,EAC7C,KAAK,EAAE,MAAM,GACZ,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,2BAA2B,CAAC,KAAK,SAAS,MAAM;IAC/D,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAA;CAC/D;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,CAAA;IACxE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAC5C,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IAC1D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAA;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,CAAA;IACxE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"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"}

package/dist/agents/validation.d.ts

@@ -2,7 +2,7 @@ import { type JsonValue } from "../json";
 import { type ValueType } from "../ontology";
 import type { GroupDefinition, SecurityDefinitionCatalog } from "../security";
 import { type AgentDefinition, type AgentLoopConfig, type AgentReasoningLevel, type AgentToolDefinition, type AgentToolInputSchema, type DefineAgentConfig } from "./types";
-export declare const AGENT_RESERVED_TOOL_NAMES: readonly ["bash", "read"];
+export declare const AGENT_RESERVED_TOOL_NAMES: readonly ["bash", "read", "view_file"];
 export declare function assertNonEmpty(value: string, field: string): void;
 export declare function isAgentDefinition(value: unknown): value is AgentDefinition;
 export declare function isAgentToolDefinition(value: unknown): value is AgentToolDefinition;
@@ -14,7 +14,7 @@ export declare function validateAndSnapshotAgentToolInput<TInput extends AgentTo
 export declare function validateAndNormalizeAgentToolInput(toolName: string, shape: AgentToolInputSchema, value: unknown, valueTypesById: ReadonlyMap<string, ValueType>): Record<string, JsonValue>;
 /** Revalidate and lock tool definitions supplied directly to the runtime. */
 export declare function validateAgentToolsAtStartup(agents: readonly AgentDefinition[]): void;
-export declare function assertValidLoopConfig(loop: AgentLoopConfig | undefined): void;
+export declare function resolveAgentLoopConfig(loop: AgentLoopConfig | undefined): AgentLoopConfig | undefined;
 export declare function assertValidReasoningLevel(reasoning: AgentReasoningLevel | undefined): void;
 export declare function assertValidProviderOptions(providerOptions: DefineAgentConfig["providerOptions"]): void;
 export declare function groupIdsFromDefinitions(agentId: string, groups: readonly GroupDefinition[] | undefined): readonly string[];

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

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/agents/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAE7E,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAA;AAehB,eAAO,MAAM,yBAAyB,2BAA4B,CAAA;AAElE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAY1E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CASlF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAS9E;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,CAIxF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAa5E;AAED,wBAAgB,iCAAiC,CAAC,MAAM,SAAS,oBAAoB,EACnF,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED,+FAA+F;AAC/F,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAwB3B;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAcpF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAU7E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAS1F;AAED,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,GACpD,IAAI,CAyBN;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAC7C,SAAS,MAAM,EAAE,CAcnB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CAWN;AA6HD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,IAAI,CAoBN"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/agents/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAE7E,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAA;AAehB,eAAO,MAAM,yBAAyB,wCAAyC,CAAA;AAE/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAY1E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CASlF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAS9E;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,CAIxF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAa5E;AAED,wBAAgB,iCAAiC,CAAC,MAAM,SAAS,oBAAoB,EACnF,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED,+FAA+F;AAC/F,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAwB3B;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAcpF;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,eAAe,GAAG,SAAS,GAChC,eAAe,GAAG,SAAS,CAiB7B;AAsBD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAS1F;AAED,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,GACpD,IAAI,CAyBN;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAC7C,SAAS,MAAM,EAAE,CAcnB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CAWN;AA6HD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,IAAI,CAoBN"}

package/dist/auth/index.js

@@ -16,13 +16,15 @@ import {
   hashAccessTokenSecret,
   hashSessionSecret,
   isCsrfExemptMethod,
-  normalizeRequesterGroupIds,
   parseAccessTokenValue,
   parseSessionCookieValue,
   principalsEqual,
-  snapshotRequesterGroupIds,
   verifyDoubleSubmitCsrf
-} from "../chunk-jaj13078.js";
+} from "../chunk-tkdscva6.js";
+import {
+  normalizeRequesterGroupIds,
+  snapshotRequesterGroupIds
+} from "../chunk-rhrbz7d4.js";
 import {
   AuthRuntimeError,
   DEFAULT_AUTH_INVITATION_TTL_MS,
@@ -49,7 +51,11 @@ import {
   serializeCookie,
   shouldUseSecureCookies
 } from "../chunk-xwnf87e1.js";
-import"../chunk-34bqh420.js";
+import"../chunk-f83ka50g.js";
+import"../chunk-rnshztfq.js";
+import"../chunk-04b07a9q.js";
+import"../chunk-dktq02ne.js";
+import"../chunk-zqysyfjt.js";
 import"../chunk-0172wgm9.js";
 import"../chunk-t8t39h7v.js";
 import"../chunk-y64skrwp.js";
@@ -102,4 +108,4 @@ export {
   AuthRuntime
 };
 
-//# debugId=D1A52751FF7620AA64756E2164756E21
+//# debugId=D2293CB7FAECA67264756E2164756E21

package/dist/auth/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "D1A52751FF7620AA64756E2164756E21",
+  "debugId": "D2293CB7FAECA67264756E2164756E21",
   "names": []
 }

package/dist/authorization/index.js

@@ -21,7 +21,11 @@ import {
   isApplicationAccessControlled,
   resolveAuthorizationContext,
   resolveRoleGrants
-} from "../chunk-34bqh420.js";
+} from "../chunk-f83ka50g.js";
+import"../chunk-rnshztfq.js";
+import"../chunk-04b07a9q.js";
+import"../chunk-dktq02ne.js";
+import"../chunk-zqysyfjt.js";
 import"../chunk-0172wgm9.js";
 import"../chunk-t8t39h7v.js";
 import"../chunk-y64skrwp.js";
@@ -49,4 +53,4 @@ export {
   AuthorizationError
 };
 
-//# debugId=DA0A7DB45C57EF1764756E2164756E21
+//# debugId=4F829428F4D4A05C64756E2164756E21

package/dist/authorization/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "DA0A7DB45C57EF1764756E2164756E21",
+  "debugId": "4F829428F4D4A05C64756E2164756E21",
   "names": []
 }

package/dist/bootstrap/index.js

@@ -4,69 +4,71 @@ import {
   discoverOntologyTypeManifest,
   discoverProjectDefinitions,
   generateOntologyTypeManifest
-} from "../chunk-sa4340y1.js";
-import"../chunk-0k4avqr2.js";
-import"../chunk-7pc8b818.js";
-import"../chunk-bh6k3nc6.js";
+} from "../chunk-1yz3x65y.js";
+import"../chunk-sxwk41qa.js";
+import"../chunk-hbeh8j9w.js";
+import"../chunk-rs1wbvy6.js";
 import"../chunk-5sz8ta9r.js";
 import"../chunk-979ww6b3.js";
 import"../chunk-2ab72m2h.js";
 import"../chunk-a31h57d5.js";
 import"../chunk-74drx9gd.js";
 import"../chunk-b49dgvsj.js";
-import"../chunk-0mbx247x.js";
-import"../chunk-bct7hmfc.js";
-import"../chunk-zg9yryhz.js";
-import"../chunk-k9pts48t.js";
-import"../chunk-gqdd7508.js";
+import"../chunk-c43qr6s0.js";
+import"../chunk-g13869yf.js";
+import"../chunk-cbkm2vam.js";
+import"../chunk-pn8n8sba.js";
+import"../chunk-4rh2m6zg.js";
 import"../chunk-xhy826cz.js";
-import"../chunk-nnyp53zt.js";
-import"../chunk-88ppkr54.js";
-import"../chunk-63te770v.js";
+import"../chunk-7gw7mepb.js";
+import"../chunk-rte5sm3z.js";
+import"../chunk-qewtks41.js";
 import"../chunk-8b55ygje.js";
 import"../chunk-51fjndv0.js";
 import"../chunk-8m5ejdpn.js";
 import"../chunk-nf4r78r4.js";
-import"../chunk-5egfka8j.js";
-import"../chunk-c6qd89g5.js";
-import"../chunk-st4xgxey.js";
-import"../chunk-8ryen3p3.js";
-import"../chunk-ys1nse2v.js";
-import"../chunk-fmx1sz2h.js";
-import"../chunk-57r1cpxx.js";
+import"../chunk-tycbzedm.js";
+import"../chunk-tek1qwgm.js";
+import"../chunk-afjpa2hs.js";
+import"../chunk-96swp2wd.js";
+import"../chunk-f6erf2vv.js";
+import"../chunk-1wk20wn3.js";
+import"../chunk-72q2y8hn.js";
+import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";
 import"../chunk-dysw7nsm.js";
 import"../chunk-62c7t4jc.js";
 import"../chunk-ezake7g1.js";
-import"../chunk-4x43bkbp.js";
+import"../chunk-a09jx26t.js";
 import"../chunk-htq0qh7z.js";
 import"../chunk-xkthy56g.js";
-import"../chunk-vp1vc6ee.js";
-import"../chunk-qvybnnpe.js";
+import"../chunk-xdf9yswn.js";
+import"../chunk-nzw7sm3b.js";
 import"../chunk-t9xghkva.js";
+import"../chunk-drjqm1aa.js";
 import"../chunk-5gd7tpv6.js";
 import"../chunk-h9kxd41f.js";
 import"../chunk-9dzba0f2.js";
 import"../chunk-vybf6pkp.js";
 import"../chunk-ry24jbr1.js";
-import"../chunk-6wetht33.js";
 import"../chunk-3j7573mj.js";
 import"../chunk-4gz41why.js";
 import"../chunk-zcnhxkvd.js";
 import"../chunk-1evzqhks.js";
 import"../chunk-dsrkgtnh.js";
 import"../chunk-bhxaq2nn.js";
+import"../chunk-yt8wphsx.js";
+import"../chunk-rdeagz6b.js";
+import"../chunk-dm72y8wt.js";
+import"../chunk-t0jjkep3.js";
+import"../chunk-tkdscva6.js";
+import"../chunk-rhrbz7d4.js";
+import"../chunk-xwnf87e1.js";
+import"../chunk-f83ka50g.js";
 import"../chunk-rnshztfq.js";
 import"../chunk-04b07a9q.js";
 import"../chunk-dktq02ne.js";
 import"../chunk-zqysyfjt.js";
-import"../chunk-yt8wphsx.js";
-import"../chunk-85j5ybfj.js";
-import"../chunk-57zpb99z.js";
-import"../chunk-663csy96.js";
-import"../chunk-jaj13078.js";
-import"../chunk-xwnf87e1.js";
-import"../chunk-34bqh420.js";
 import"../chunk-0172wgm9.js";
 import"../chunk-t8t39h7v.js";
 import"../chunk-y64skrwp.js";
@@ -77,4 +79,4 @@ export {
   discoverOntologySources
 };
 
-//# debugId=37DAABE9284FCA9464756E2164756E21
+//# debugId=251CC8CF1CBD616C64756E2164756E21

package/dist/bootstrap/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "37DAABE9284FCA9464756E2164756E21",
+  "debugId": "251CC8CF1CBD616C64756E2164756E21",
   "names": []
 }