@axiastudio/aioc 0.1.0-rc.1 → 0.1.1

package/README.md

@@ -8,13 +8,16 @@ Project home and documentation: [https://axiastudio.github.io/aioc](https://axia
 
 ## Release Status
 
-This package is currently in release-candidate phase (`0.1.0-rc.1`) and is not yet stable.
-The core runtime surface is expected to remain frozen except for bug fixes, cleanup, and documentation adjustments before `0.1.0`.
+Current stable release: `0.1.1`.
+AIOC is stable as of `0.1.0`.
+The core runtime surface is compatibility-managed. Breaking changes to the stable surface should ship only with explicit migration guidance and release notes.
 
-### What Stable Means
+### Stable Scope
 
-AIOC will move from release candidate to stable when the core runtime surface is confirmed, the public documentation matches the actual exported contract, `RunRecord` and replay/compare workflows are considered reliable, and the SDK has been validated in real applications beyond toy examples.
+AIOC `0.1.0` stabilized the core runtime surface, public documentation aligned to the exported contract, `RunRecord` and replay/compare workflows, and the governance-first runtime model validated in real applications beyond toy examples.
+AIOC `0.1.1` adds thread-history utilities, the run-output stream adapter, and provider-specific instruction-role documentation without changing the stable governance model.
 
+- Release notes: `CHANGELOG.md`
 - Historical beta contract snapshot: `docs/BETA-CONTRACT.md`
 - Historical alpha contract snapshot: `docs/ALPHA-CONTRACT.md`
 - Privacy baseline: `docs/PRIVACY-BASELINE.md`
@@ -96,7 +99,9 @@ console.log(result.finalOutput);
 - provider setup helpers `setupMistral(...)`, `setupOpenAI(...)`, `setupProvider(...)`
 - run logger hook `run(..., { logger })`
 - run record hook `run(..., { record })`
+- run output adapter `toRunOutputEvents(...)`
 - run-record utilities `extractToolCalls(...)`, `compareRunRecords(...)`, `replayFromRunRecord(...)`
+- thread history utilities `toThreadHistory(...)`, `appendUserMessage(...)`, `replaceThreadHistory(...)`, `applyRunResultHistory(...)`
 - JSON helper `toJsonValue(...)`
 
 ## Policy Gate (Minimal)
@@ -258,7 +263,10 @@ AIOC adopts the following non-negotiable principles:
 - `docs/RFC-0002-policy-gates-for-tools-and-handoffs.md` (`Accepted`)
 - `docs/RFC-0003-run-record-audit-trail-and-persistence.md` (`Accepted`)
 - `docs/RFC-0004-policy-outcomes-and-approval-model.md` (`Accepted`)
-- `docs/RFC-0005-suspended-proposals-and-approval-lifecycle.md` (`Draft`)
+- `docs/RFC-0005-suspended-proposals-and-approval-lifecycle.md` (`Accepted`)
+- `docs/RFC-0006-approval-evidence-helpers.md` (`Draft`)
+- `docs/RFC-0007-thread-state-utilities.md` (`Accepted`)
+- `docs/RFC-0008-run-stream-consumer-utilities.md` (`Accepted`)
 - `docs/PRIVACY-BASELINE.md`
 
 ## Historical Snapshots

package/dist/index.d.ts

@@ -13,9 +13,11 @@ export * from "./providers/chat-completions";
 export * from "./providers/mistral";
 export * from "./providers/openai";
 export * from "./run";
+export * from "./run-output-events";
 export * from "./run-record";
 export * from "./run-record-utils";
 export * from "./run-context";
+export * from "./thread-history";
 export * from "./tool";
 export * from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,OAAO,CAAC;AACtB,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -29,8 +29,10 @@ __exportStar(require("./providers/chat-completions"), exports);
 __exportStar(require("./providers/mistral"), exports);
 __exportStar(require("./providers/openai"), exports);
 __exportStar(require("./run"), exports);
+__exportStar(require("./run-output-events"), exports);
 __exportStar(require("./run-record"), exports);
 __exportStar(require("./run-record-utils"), exports);
 __exportStar(require("./run-context"), exports);
+__exportStar(require("./thread-history"), exports);
 __exportStar(require("./tool"), exports);
 __exportStar(require("./types"), exports);

package/dist/policy-outcomes.d.ts

@@ -8,7 +8,6 @@ export interface ToolResultEnvelope {
     data: unknown | null;
 }
 export declare function createDeniedPolicyResult(reason: string, metadata?: Record<string, unknown>): PolicyResult;
-export declare function createDeprecatedPolicyFieldResult(fieldName: string, replacementField: string, receivedValue?: unknown): PolicyResult;
 export declare function toAllowedToolResultEnvelope(data: unknown): ToolResultEnvelope;
 export declare function materializePolicyResult(policyResult: PolicyResult): PolicyResult;
 export declare function resolveResultMode(policyResult: PolicyResult): PolicyResultMode;

package/dist/policy-outcomes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-outcomes.d.ts","sourceRoot":"","sources":["../src/policy-outcomes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,wBAAwB,CAAC;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,YAAY,CAOd;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,aAAa,CAAC,EAAE,OAAO,GACtB,YAAY,CAMd;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAO7E;AAoBD,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,GACzB,YAAY,CAYd;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,GACzB,gBAAgB,CAElB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EACF;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;IAC3B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,GACJ,kBAAkB,CA+CpB"}
+{"version":3,"file":"policy-outcomes.d.ts","sourceRoot":"","sources":["../src/policy-outcomes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,wBAAwB,CAAC;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,YAAY,CAOd;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAO7E;AAoBD,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,GACzB,YAAY,CAYd;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,GACzB,gBAAgB,CAElB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EACF;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;IAC3B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,GACJ,kBAAkB,CA+CpB"}

package/dist/policy-outcomes.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeniedPolicyResult = createDeniedPolicyResult;
-exports.createDeprecatedPolicyFieldResult = createDeprecatedPolicyFieldResult;
 exports.toAllowedToolResultEnvelope = toAllowedToolResultEnvelope;
 exports.materializePolicyResult = materializePolicyResult;
 exports.resolveResultMode = resolveResultMode;
@@ -15,13 +14,6 @@ function createDeniedPolicyResult(reason, metadata) {
         metadata,
     };
 }
-function createDeprecatedPolicyFieldResult(fieldName, replacementField, receivedValue) {
-    return createDeniedPolicyResult(`deprecated_policy_field_${fieldName}`, {
-        deprecatedField: fieldName,
-        replacementField,
-        receivedValue,
-    });
-}
 function toAllowedToolResultEnvelope(data) {
     return {
         status: "ok",

package/dist/providers/chat-completions.d.ts

@@ -8,6 +8,7 @@ export declare class ChatCompletionsProvider implements ModelProvider {
     private baseURL;
     private headers;
     constructor(options: ChatCompletionsProviderOptions);
+    protected getInstructionRole(): "system" | "developer";
     stream<TContext = unknown>(request: ProviderRequest<TContext>): AsyncIterable<ProviderEvent>;
 }
 //# sourceMappingURL=chat-completions.d.ts.map

package/dist/providers/chat-completions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-completions.d.ts","sourceRoot":"","sources":["../../src/providers/chat-completions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEvE,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AA6SD,qBAAa,uBAAwB,YAAW,aAAa;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,EAAE,8BAA8B;IAK5C,MAAM,CAAC,QAAQ,GAAG,OAAO,EAC9B,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,GACjC,aAAa,CAAC,aAAa,CAAC;CAoHhC"}
+{"version":3,"file":"chat-completions.d.ts","sourceRoot":"","sources":["../../src/providers/chat-completions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEvE,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AA8SD,qBAAa,uBAAwB,YAAW,aAAa;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,EAAE,8BAA8B;IAKnD,SAAS,CAAC,kBAAkB,IAAI,QAAQ,GAAG,WAAW;IAI/C,MAAM,CAAC,QAAQ,GAAG,OAAO,EAC9B,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,GACjC,aAAa,CAAC,aAAa,CAAC;CAwHhC"}

package/dist/providers/chat-completions.js

@@ -69,11 +69,11 @@ function normalizeMessageContent(content) {
     }
     return stringifySafe(content);
 }
-function toChatMessages(items, systemPrompt) {
+function toChatMessages(items, systemPrompt, instructionRole = "system") {
     const messages = [];
     if (systemPrompt) {
         messages.push({
-            role: "system",
+            role: instructionRole,
             content: systemPrompt,
         });
     }
@@ -208,10 +208,13 @@ class ChatCompletionsProvider {
         this.baseURL = normalizeBaseURL(options.baseURL);
         this.headers = buildHeaders(options);
     }
+    getInstructionRole() {
+        return "system";
+    }
     async *stream(request) {
         const payload = {
             model: request.model,
-            messages: toChatMessages(request.messages, request.systemPrompt),
+            messages: toChatMessages(request.messages, request.systemPrompt, this.getInstructionRole()),
             tools: request.tools.length > 0 ? toTools(request.tools) : undefined,
             tool_choice: request.tools.length > 0 ? "auto" : undefined,
             stream: true,

package/dist/providers/openai.d.ts

@@ -7,5 +7,6 @@ export type OpenAIProviderOptions = Omit<ChatCompletionsProviderOptions, "baseUR
 };
 export declare class OpenAIProvider extends ChatCompletionsProvider {
     constructor(options: OpenAIProviderOptions);
+    protected getInstructionRole(): "developer";
 }
 //# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,8BAA8B,EAC9B,SAAS,GAAG,SAAS,CACtB,GAAG;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAcF,qBAAa,cAAe,SAAQ,uBAAuB;gBAC7C,OAAO,EAAE,qBAAqB;CAO3C"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,8BAA8B,EAC9B,SAAS,GAAG,SAAS,CACtB,GAAG;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAcF,qBAAa,cAAe,SAAQ,uBAAuB;gBAC7C,OAAO,EAAE,qBAAqB;cAQvB,kBAAkB,IAAI,WAAW;CAGrD"}

package/dist/providers/openai.js

@@ -19,5 +19,8 @@ class OpenAIProvider extends chat_completions_1.ChatCompletionsProvider {
             headers: toOpenAIHeaders(options),
         });
     }
+    getInstructionRole() {
+        return "developer";
+    }
 }
 exports.OpenAIProvider = OpenAIProvider;

package/dist/run-output-events.d.ts

@@ -0,0 +1,31 @@
+import type { Agent } from "./agent";
+import { type ExtractedToolCall } from "./run-record-utils";
+import type { StreamedRunResult } from "./run";
+import type { AgentInputItem, ToolCallItem, ToolCallOutputItem } from "./types";
+export type RunOutputEvent<TContext = unknown> = {
+    type: "text_delta";
+    delta: string;
+} | {
+    type: "completed";
+    finalOutput: string;
+    history: AgentInputItem[];
+    lastAgent: Agent<TContext>;
+    toolCalls: ExtractedToolCall[];
+} | {
+    type: "agent_updated";
+    agent: Agent<TContext>;
+} | {
+    type: "tool_call";
+    item: ToolCallItem;
+} | {
+    type: "tool_output";
+    item: ToolCallOutputItem;
+    output: unknown;
+    toolCall?: ToolCallItem;
+};
+export declare function toRunOutputEvents<TContext = unknown>(result: StreamedRunResult<TContext>, options?: {
+    emitAgentUpdates?: boolean;
+    emitToolCalls?: boolean;
+    emitToolOutputs?: boolean;
+}): AsyncIterable<RunOutputEvent<TContext>>;
+//# sourceMappingURL=run-output-events.d.ts.map

package/dist/run-output-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-output-events.d.ts","sourceRoot":"","sources":["../src/run-output-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEhF,MAAM,MAAM,cAAc,CAAC,QAAQ,GAAG,OAAO,IACzC;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3B,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CACxB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;CACpB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEN,wBAAuB,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EACzD,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EACnC,OAAO,CAAC,EAAE;IACR,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GACA,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAmEzC"}

package/dist/run-output-events.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toRunOutputEvents = toRunOutputEvents;
+const run_record_utils_1 = require("./run-record-utils");
+async function* toRunOutputEvents(result, options) {
+    const toolCallsById = new Map();
+    let finalOutput = "";
+    let hasSeenInitialAgent = false;
+    for await (const event of result.toStream()) {
+        if (event.type === "raw_model_stream_event") {
+            if (typeof event.data.delta === "string") {
+                yield {
+                    type: "text_delta",
+                    delta: event.data.delta,
+                };
+            }
+            continue;
+        }
+        if (event.type === "agent_updated_stream_event") {
+            if (!hasSeenInitialAgent) {
+                hasSeenInitialAgent = true;
+                continue;
+            }
+            if (options?.emitAgentUpdates) {
+                yield {
+                    type: "agent_updated",
+                    agent: event.agent,
+                };
+            }
+            continue;
+        }
+        if (event.item.type === "tool_call_item") {
+            toolCallsById.set(event.item.callId, event.item);
+            if (options?.emitToolCalls) {
+                yield {
+                    type: "tool_call",
+                    item: event.item,
+                };
+            }
+            continue;
+        }
+        if (event.item.type === "tool_call_output_item") {
+            if (options?.emitToolOutputs) {
+                const toolCall = toolCallsById.get(event.item.callId);
+                yield {
+                    type: "tool_output",
+                    item: event.item,
+                    output: event.item.output,
+                    ...(toolCall ? { toolCall } : {}),
+                };
+            }
+            continue;
+        }
+        finalOutput = event.item.content;
+    }
+    const history = [...result.history];
+    yield {
+        type: "completed",
+        finalOutput,
+        history,
+        lastAgent: result.lastAgent,
+        toolCalls: (0, run_record_utils_1.extractToolCalls)(history),
+    };
+}

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAuChC,OAAO,EACL,cAAc,EAEd,mBAAmB,EAGnB,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAUjB,KAAK,eAAe,CAAC,QAAQ,IAAI;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CAC5B,CAAC;AAGF,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAswB3B,qBAAa,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,KAAK,CAA4B;gBAGvC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAC/C,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC;IAMlC,QAAQ,IAAI,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAQnD,IAAI,OAAO,IAAI,cAAc,EAAE,CAE9B;IAED,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,CAE/B;CACF;AAED,wBAAsB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAC1C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,EAChC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAExC,wBAAsB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAC1C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,EAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GACtC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAsChC,OAAO,EACL,cAAc,EAEd,mBAAmB,EAGnB,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAUjB,KAAK,eAAe,CAAC,QAAQ,IAAI;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CAC5B,CAAC;AAGF,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAuwB3B,qBAAa,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,KAAK,CAA4B;gBAGvC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAC/C,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC;IAMlC,QAAQ,IAAI,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAQnD,IAAI,OAAO,IAAI,cAAc,EAAE,CAE9B;IAED,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,CAE/B;CACF;AAED,wBAAsB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAC1C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,EAChC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAExC,wBAAsB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAC1C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,EAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GACtC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC"}

package/dist/run.js

@@ -124,10 +124,16 @@ function isPolicyResultShape(value) {
         validResultMode &&
         validExpiresAt);
 }
-// TODO: Remove this beta-only migration guard before stable.
-function hasLegacyDenyMode(value) {
+function hasDeprecatedDenyMode(value) {
     return typeof value === "object" && value !== null && "denyMode" in value;
 }
+function createDeprecatedDenyModeResult(receivedValue) {
+    return (0, policy_outcomes_1.createDeniedPolicyResult)("deprecated_policy_field_denyMode", {
+        deprecatedField: "denyMode",
+        replacementField: "resultMode",
+        receivedValue,
+    });
+}
 async function emitPolicyDecision(params) {
     const { agentName, turn, callId, policyResult, logEmitter, onPolicyDecision, } = params;
     const resultMode = policyResult.decision === "allow"
@@ -195,8 +201,8 @@ async function evaluateToolPolicy(agent, call, parsedArguments, runContext, turn
     catch (error) {
         return (0, policy_outcomes_1.createDeniedPolicyResult)("policy_error", toErrorMetadata(error));
     }
-    if (hasLegacyDenyMode(rawResult)) {
-        return (0, policy_outcomes_1.createDeprecatedPolicyFieldResult)("denyMode", "resultMode", rawResult.denyMode);
+    if (hasDeprecatedDenyMode(rawResult)) {
+        return createDeprecatedDenyModeResult(rawResult.denyMode);
     }
     if (!isPolicyResultShape(rawResult)) {
         return (0, policy_outcomes_1.createDeniedPolicyResult)("invalid_policy_result");
@@ -228,8 +234,8 @@ async function evaluateHandoffPolicy(fromAgent, toAgent, call, handoffPayload, r
     catch (error) {
         return (0, policy_outcomes_1.createDeniedPolicyResult)("policy_error", toErrorMetadata(error));
     }
-    if (hasLegacyDenyMode(rawResult)) {
-        return (0, policy_outcomes_1.createDeprecatedPolicyFieldResult)("denyMode", "resultMode", rawResult.denyMode);
+    if (hasDeprecatedDenyMode(rawResult)) {
+        return createDeprecatedDenyModeResult(rawResult.denyMode);
     }
     if (!isPolicyResultShape(rawResult)) {
         return (0, policy_outcomes_1.createDeniedPolicyResult)("invalid_policy_result");

package/dist/thread-history.d.ts

@@ -0,0 +1,10 @@
+import type { AgentInputItem, RunResult } from "./types";
+export interface ThreadHistoryState {
+    history: AgentInputItem[];
+}
+export type RunHistorySource<TContext = unknown> = Pick<RunResult<TContext>, "history">;
+export declare function toThreadHistory(input: string | readonly AgentInputItem[]): AgentInputItem[];
+export declare function appendUserMessage(history: readonly AgentInputItem[], content: string): AgentInputItem[];
+export declare function replaceThreadHistory<TThread extends ThreadHistoryState>(thread: TThread, history: readonly AgentInputItem[]): TThread;
+export declare function applyRunResultHistory<TContext, TThread extends ThreadHistoryState>(thread: TThread, result: RunHistorySource<TContext>): TThread;
+//# sourceMappingURL=thread-history.d.ts.map

package/dist/thread-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-history.d.ts","sourceRoot":"","sources":["../src/thread-history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,gBAAgB,CAAC,QAAQ,GAAG,OAAO,IAAI,IAAI,CACrD,SAAS,CAAC,QAAQ,CAAC,EACnB,SAAS,CACV,CAAC;AAEF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,GACxC,cAAc,EAAE,CAMlB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,OAAO,EAAE,MAAM,GACd,cAAc,EAAE,CAElB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,kBAAkB,EACrE,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,SAAS,cAAc,EAAE,GACjC,OAAO,CAKT;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EACR,OAAO,SAAS,kBAAkB,EAClC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAE9D"}

package/dist/thread-history.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toThreadHistory = toThreadHistory;
+exports.appendUserMessage = appendUserMessage;
+exports.replaceThreadHistory = replaceThreadHistory;
+exports.applyRunResultHistory = applyRunResultHistory;
+const messages_1 = require("./messages");
+function toThreadHistory(input) {
+    if (typeof input === "string") {
+        return [(0, messages_1.user)(input)];
+    }
+    return [...input];
+}
+function appendUserMessage(history, content) {
+    return [...history, (0, messages_1.user)(content)];
+}
+function replaceThreadHistory(thread, history) {
+    return {
+        ...thread,
+        history: [...history],
+    };
+}
+function applyRunResultHistory(thread, result) {
+    return replaceThreadHistory(thread, result.history);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiastudio/aioc",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [