@ai-agent-forge/agent-forge 0.85.0

package/dist/host/manual-compaction.js

@@ -0,0 +1,63 @@
+export function createManualCompactionExecutor(options) {
+    const coordinator = options.coordinator;
+    let state = "idle";
+    let currentOperationId;
+    return {
+        get state() {
+            return state;
+        },
+        requestCompaction(input) {
+            if (state === "in_progress") {
+                // v8 ignore next -- state 与 currentOperationId 同步赋值，busy 时必有 operationId
+                return { status: "busy", currentOperationId: currentOperationId ?? "unknown" };
+            }
+            if (input.pluginId.trim().length === 0) {
+                throw new Error("Compaction pluginId must be a non-empty string");
+            }
+            state = "in_progress";
+            currentOperationId = input.operationId;
+            try {
+                // Stage against the current revision; a concurrent commit makes this stale.
+                const staged = coordinator.stage({
+                    operationId: input.operationId,
+                    expectedRevision: coordinator.currentRevision,
+                    payload: null,
+                });
+                if (staged.status === "stale") {
+                    return { status: "stale", currentRevision: staged.currentRevision };
+                }
+                if (staged.status === "duplicate") {
+                    return { status: "completed", revision: staged.revision, summary: { duplicate: true } };
+                }
+                // Plugin-owned summarization; the executor knows nothing of the content.
+                let summary;
+                try {
+                    summary = input.summarize();
+                }
+                catch (error) {
+                    coordinator.cancelStage(staged.staged.token);
+                    return { status: "summary_failed", reason: error instanceof Error ? error.message : String(error) };
+                }
+                const outcome = coordinator.commitStage({
+                    token: staged.staged.token,
+                    apply: (payload, revision) => {
+                        void payload;
+                        void revision;
+                    },
+                });
+                if (outcome.status === "stale") {
+                    return { status: "stale", currentRevision: outcome.currentRevision };
+                }
+                if (outcome.status === "committed") {
+                    return { status: "completed", revision: outcome.revision, summary };
+                }
+                return { status: "summary_failed", reason: `Unexpected checkpoint outcome: ${outcome.status}` };
+            }
+            finally {
+                state = "idle";
+                currentOperationId = undefined;
+            }
+        },
+    };
+}
+//# sourceMappingURL=manual-compaction.js.map

package/dist/host/manual-compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-compaction.js","sourceRoot":"","sources":["../../src/host/manual-compaction.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Manual compaction executor (2A.2) — the host primitive that lets a PLUGIN\n * decide when compaction happens and what the summary contains, while the\n * kernel side only provides the model/session/commit primitives (here: the\n * 2A.1 checkpoint coordinator).\n *\n * The executor owns no summarization policy: the requesting plugin supplies\n * the deterministic `summarize` callback. The executor sequences the\n * operation through the checkpoint coordinator (stage → summarize → commit),\n * so a stale revision, a failing summary, or a concurrent compaction can\n * never produce a half commit. Auto compaction, overflow recovery, retry,\n * and tree/branch migration are later 2A slices.\n */\nimport type { JsonValue } from \"@agent-forge/ai\";\nimport type { HostCheckpointCoordinatorV1 } from \"./checkpoint-commit.ts\";\n\nexport type ManualCompactionStateV1 = \"idle\" | \"in_progress\";\n\nexport type ManualCompactionOutcomeV1 =\n\t| { readonly status: \"completed\"; readonly revision: number; readonly summary: JsonValue }\n\t| { readonly status: \"stale\"; readonly currentRevision: number }\n\t| { readonly status: \"summary_failed\"; readonly reason: string }\n\t| { readonly status: \"busy\"; readonly currentOperationId: string };\n\nexport interface ManualCompactionExecutorV1 {\n\t/** Plugin-driven entry point: the plugin decides timing AND the summary. */\n\trequestCompaction(input: {\n\t\treadonly pluginId: string;\n\t\treadonly operationId: string;\n\t\treadonly summarize: () => JsonValue;\n\t}): ManualCompactionOutcomeV1;\n\treadonly state: ManualCompactionStateV1;\n}\n\nexport function createManualCompactionExecutor(options: {\n\treadonly coordinator: HostCheckpointCoordinatorV1;\n}): ManualCompactionExecutorV1 {\n\tconst coordinator = options.coordinator;\n\tlet state: ManualCompactionStateV1 = \"idle\";\n\tlet currentOperationId: string | undefined;\n\n\treturn {\n\t\tget state() {\n\t\t\treturn state;\n\t\t},\n\t\trequestCompaction(input) {\n\t\t\tif (state === \"in_progress\") {\n\t\t\t\t// v8 ignore next -- state 与 currentOperationId 同步赋值，busy 时必有 operationId\n\t\t\t\treturn { status: \"busy\", currentOperationId: currentOperationId ?? \"unknown\" };\n\t\t\t}\n\t\t\tif (input.pluginId.trim().length === 0) {\n\t\t\t\tthrow new Error(\"Compaction pluginId must be a non-empty string\");\n\t\t\t}\n\t\t\tstate = \"in_progress\";\n\t\t\tcurrentOperationId = input.operationId;\n\t\t\ttry {\n\t\t\t\t// Stage against the current revision; a concurrent commit makes this stale.\n\t\t\t\tconst staged = coordinator.stage({\n\t\t\t\t\toperationId: input.operationId,\n\t\t\t\t\texpectedRevision: coordinator.currentRevision,\n\t\t\t\t\tpayload: null,\n\t\t\t\t});\n\t\t\t\tif (staged.status === \"stale\") {\n\t\t\t\t\treturn { status: \"stale\", currentRevision: staged.currentRevision };\n\t\t\t\t}\n\t\t\t\tif (staged.status === \"duplicate\") {\n\t\t\t\t\treturn { status: \"completed\", revision: staged.revision, summary: { duplicate: true } };\n\t\t\t\t}\n\t\t\t\t// Plugin-owned summarization; the executor knows nothing of the content.\n\t\t\t\tlet summary: JsonValue;\n\t\t\t\ttry {\n\t\t\t\t\tsummary = input.summarize();\n\t\t\t\t} catch (error) {\n\t\t\t\t\tcoordinator.cancelStage(staged.staged.token);\n\t\t\t\t\treturn { status: \"summary_failed\", reason: error instanceof Error ? error.message : String(error) };\n\t\t\t\t}\n\t\t\t\tconst outcome = coordinator.commitStage({\n\t\t\t\t\ttoken: staged.staged.token,\n\t\t\t\t\tapply: (payload, revision) => {\n\t\t\t\t\t\tvoid payload;\n\t\t\t\t\t\tvoid revision;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\tif (outcome.status === \"stale\") {\n\t\t\t\t\treturn { status: \"stale\", currentRevision: outcome.currentRevision };\n\t\t\t\t}\n\t\t\t\tif (outcome.status === \"committed\") {\n\t\t\t\t\treturn { status: \"completed\", revision: outcome.revision, summary };\n\t\t\t\t}\n\t\t\t\treturn { status: \"summary_failed\", reason: `Unexpected checkpoint outcome: ${outcome.status}` };\n\t\t\t} finally {\n\t\t\t\tstate = \"idle\";\n\t\t\t\tcurrentOperationId = undefined;\n\t\t\t}\n\t\t},\n\t};\n}\n"]}

package/dist/host/output-projection.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Host output projection (2.6b) — projects kernel events into consistent
+ * host-facing output records with trace/correlation identity and structured
+ * errors.
+ *
+ * Every projected record carries the turn's `traceId`; tool calls and their
+ * results share the call's `correlationId`; errors become structured
+ * diagnostics (channel, severity, code) instead of raw throws; and the
+ * record order matches the event order. Events without a traceId are
+ * rejected explicitly — an unattributable output can never reach the host.
+ * The projection is deterministic and replayable. The TUI renderer itself
+ * is out of scope.
+ */
+export type HostOutputChannelV1 = "message" | "tool" | "diagnostic" | "lifecycle";
+export type HostOutputSeverityV1 = "info" | "ok" | "warn" | "error";
+export interface HostOutputRecordV1 {
+    readonly channel: HostOutputChannelV1;
+    readonly severity: HostOutputSeverityV1;
+    readonly traceId: string;
+    readonly correlationId?: string;
+    readonly at: number;
+    readonly summary: string;
+    readonly code?: string;
+    readonly detail?: string;
+}
+export type HostEventV1 = {
+    readonly kind: "model_output";
+    readonly traceId: string;
+    readonly at: number;
+    readonly text: string;
+} | {
+    readonly kind: "tool_call";
+    readonly traceId: string;
+    readonly at: number;
+    readonly callId: string;
+    readonly toolName: string;
+} | {
+    readonly kind: "tool_result";
+    readonly traceId: string;
+    readonly at: number;
+    readonly callId: string;
+    readonly toolName: string;
+    readonly ok: boolean;
+    readonly detail?: string;
+} | {
+    readonly kind: "error";
+    readonly traceId: string;
+    readonly at: number;
+    readonly name: string;
+    readonly message: string;
+} | {
+    readonly kind: "phase";
+    readonly traceId: string;
+    readonly at: number;
+    readonly phase: string;
+};
+export interface HostOutputProjectorV1 {
+    project(events: readonly HostEventV1[]): readonly HostOutputRecordV1[];
+}
+export declare function createHostOutputProjector(): HostOutputProjectorV1;
+//# sourceMappingURL=output-projection.d.ts.map

package/dist/host/output-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-projection.d.ts","sourceRoot":"","sources":["../../src/host/output-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC;AAClF,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvG;IACA,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CACzB,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACxB,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErG,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,kBAAkB,EAAE,CAAC;CACvE;AAaD,wBAAgB,yBAAyB,IAAI,qBAAqB,CA8DjE","sourcesContent":["/**\n * Host output projection (2.6b) — projects kernel events into consistent\n * host-facing output records with trace/correlation identity and structured\n * errors.\n *\n * Every projected record carries the turn's `traceId`; tool calls and their\n * results share the call's `correlationId`; errors become structured\n * diagnostics (channel, severity, code) instead of raw throws; and the\n * record order matches the event order. Events without a traceId are\n * rejected explicitly — an unattributable output can never reach the host.\n * The projection is deterministic and replayable. The TUI renderer itself\n * is out of scope.\n */\nexport type HostOutputChannelV1 = \"message\" | \"tool\" | \"diagnostic\" | \"lifecycle\";\nexport type HostOutputSeverityV1 = \"info\" | \"ok\" | \"warn\" | \"error\";\n\nexport interface HostOutputRecordV1 {\n\treadonly channel: HostOutputChannelV1;\n\treadonly severity: HostOutputSeverityV1;\n\treadonly traceId: string;\n\treadonly correlationId?: string;\n\treadonly at: number;\n\treadonly summary: string;\n\treadonly code?: string;\n\treadonly detail?: string;\n}\n\nexport type HostEventV1 =\n\t| { readonly kind: \"model_output\"; readonly traceId: string; readonly at: number; readonly text: string }\n\t| {\n\t\t\treadonly kind: \"tool_call\";\n\t\t\treadonly traceId: string;\n\t\t\treadonly at: number;\n\t\t\treadonly callId: string;\n\t\t\treadonly toolName: string;\n\t  }\n\t| {\n\t\t\treadonly kind: \"tool_result\";\n\t\t\treadonly traceId: string;\n\t\t\treadonly at: number;\n\t\t\treadonly callId: string;\n\t\t\treadonly toolName: string;\n\t\t\treadonly ok: boolean;\n\t\t\treadonly detail?: string;\n\t  }\n\t| {\n\t\t\treadonly kind: \"error\";\n\t\t\treadonly traceId: string;\n\t\t\treadonly at: number;\n\t\t\treadonly name: string;\n\t\t\treadonly message: string;\n\t  }\n\t| { readonly kind: \"phase\"; readonly traceId: string; readonly at: number; readonly phase: string };\n\nexport interface HostOutputProjectorV1 {\n\tproject(events: readonly HostEventV1[]): readonly HostOutputRecordV1[];\n}\n\n/** Deterministic error-code mapping for diagnostics. */\nfunction diagnosticCode(name: string): string {\n\tconst table: readonly (readonly [string, string])[] = [\n\t\t[\"AbortError\", \"cancelled\"],\n\t\t[\"TimeoutError\", \"timeout\"],\n\t\t[\"TypeError\", \"invalid_input\"],\n\t\t[\"RangeError\", \"out_of_range\"],\n\t];\n\treturn table.find(([matching]) => matching === name)?.[1] ?? \"internal_error\";\n}\n\nexport function createHostOutputProjector(): HostOutputProjectorV1 {\n\treturn {\n\t\tproject(events) {\n\t\t\treturn events.map((event) => {\n\t\t\t\tif (!event.traceId) {\n\t\t\t\t\tthrow new Error(\"Host output projection requires a traceId on every event\");\n\t\t\t\t}\n\t\t\t\tswitch (event.kind) {\n\t\t\t\t\tcase \"model_output\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"message\" as const,\n\t\t\t\t\t\t\tseverity: \"info\" as const,\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: event.text,\n\t\t\t\t\t\t};\n\t\t\t\t\tcase \"tool_call\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"tool\" as const,\n\t\t\t\t\t\t\tseverity: \"info\" as const,\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tcorrelationId: event.callId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: `tool ${event.toolName} called`,\n\t\t\t\t\t\t\tcode: event.toolName,\n\t\t\t\t\t\t};\n\t\t\t\t\tcase \"tool_result\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"tool\" as const,\n\t\t\t\t\t\t\tseverity: event.ok ? (\"ok\" as const) : (\"error\" as const),\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tcorrelationId: event.callId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: `tool ${event.toolName} ${event.ok ? \"succeeded\" : \"failed\"}`,\n\t\t\t\t\t\t\tcode: event.toolName,\n\t\t\t\t\t\t\t...(event.detail === undefined ? {} : { detail: event.detail }),\n\t\t\t\t\t\t};\n\t\t\t\t\tcase \"error\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"diagnostic\" as const,\n\t\t\t\t\t\t\tseverity: \"error\" as const,\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: event.message,\n\t\t\t\t\t\t\tcode: diagnosticCode(event.name),\n\t\t\t\t\t\t\tdetail: event.name,\n\t\t\t\t\t\t};\n\t\t\t\t\tcase \"phase\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"lifecycle\" as const,\n\t\t\t\t\t\t\tseverity: \"info\" as const,\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: `phase: ${event.phase}`,\n\t\t\t\t\t\t\tcode: event.phase,\n\t\t\t\t\t\t};\n\t\t\t\t\tdefault:\n\t\t\t\t\t\tthrow new Error(\"Unsupported host event reached the projector\");\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t};\n}\n"]}

package/dist/host/output-projection.js

@@ -0,0 +1,74 @@
+/** Deterministic error-code mapping for diagnostics. */
+function diagnosticCode(name) {
+    const table = [
+        ["AbortError", "cancelled"],
+        ["TimeoutError", "timeout"],
+        ["TypeError", "invalid_input"],
+        ["RangeError", "out_of_range"],
+    ];
+    return table.find(([matching]) => matching === name)?.[1] ?? "internal_error";
+}
+export function createHostOutputProjector() {
+    return {
+        project(events) {
+            return events.map((event) => {
+                if (!event.traceId) {
+                    throw new Error("Host output projection requires a traceId on every event");
+                }
+                switch (event.kind) {
+                    case "model_output":
+                        return {
+                            channel: "message",
+                            severity: "info",
+                            traceId: event.traceId,
+                            at: event.at,
+                            summary: event.text,
+                        };
+                    case "tool_call":
+                        return {
+                            channel: "tool",
+                            severity: "info",
+                            traceId: event.traceId,
+                            correlationId: event.callId,
+                            at: event.at,
+                            summary: `tool ${event.toolName} called`,
+                            code: event.toolName,
+                        };
+                    case "tool_result":
+                        return {
+                            channel: "tool",
+                            severity: event.ok ? "ok" : "error",
+                            traceId: event.traceId,
+                            correlationId: event.callId,
+                            at: event.at,
+                            summary: `tool ${event.toolName} ${event.ok ? "succeeded" : "failed"}`,
+                            code: event.toolName,
+                            ...(event.detail === undefined ? {} : { detail: event.detail }),
+                        };
+                    case "error":
+                        return {
+                            channel: "diagnostic",
+                            severity: "error",
+                            traceId: event.traceId,
+                            at: event.at,
+                            summary: event.message,
+                            code: diagnosticCode(event.name),
+                            detail: event.name,
+                        };
+                    case "phase":
+                        return {
+                            channel: "lifecycle",
+                            severity: "info",
+                            traceId: event.traceId,
+                            at: event.at,
+                            summary: `phase: ${event.phase}`,
+                            code: event.phase,
+                        };
+                    default:
+                        throw new Error("Unsupported host event reached the projector");
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=output-projection.js.map

package/dist/host/output-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-projection.js","sourceRoot":"","sources":["../../src/host/output-projection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Host output projection (2.6b) — projects kernel events into consistent\n * host-facing output records with trace/correlation identity and structured\n * errors.\n *\n * Every projected record carries the turn's `traceId`; tool calls and their\n * results share the call's `correlationId`; errors become structured\n * diagnostics (channel, severity, code) instead of raw throws; and the\n * record order matches the event order. Events without a traceId are\n * rejected explicitly — an unattributable output can never reach the host.\n * The projection is deterministic and replayable. The TUI renderer itself\n * is out of scope.\n */\nexport type HostOutputChannelV1 = \"message\" | \"tool\" | \"diagnostic\" | \"lifecycle\";\nexport type HostOutputSeverityV1 = \"info\" | \"ok\" | \"warn\" | \"error\";\n\nexport interface HostOutputRecordV1 {\n\treadonly channel: HostOutputChannelV1;\n\treadonly severity: HostOutputSeverityV1;\n\treadonly traceId: string;\n\treadonly correlationId?: string;\n\treadonly at: number;\n\treadonly summary: string;\n\treadonly code?: string;\n\treadonly detail?: string;\n}\n\nexport type HostEventV1 =\n\t| { readonly kind: \"model_output\"; readonly traceId: string; readonly at: number; readonly text: string }\n\t| {\n\t\t\treadonly kind: \"tool_call\";\n\t\t\treadonly traceId: string;\n\t\t\treadonly at: number;\n\t\t\treadonly callId: string;\n\t\t\treadonly toolName: string;\n\t  }\n\t| {\n\t\t\treadonly kind: \"tool_result\";\n\t\t\treadonly traceId: string;\n\t\t\treadonly at: number;\n\t\t\treadonly callId: string;\n\t\t\treadonly toolName: string;\n\t\t\treadonly ok: boolean;\n\t\t\treadonly detail?: string;\n\t  }\n\t| {\n\t\t\treadonly kind: \"error\";\n\t\t\treadonly traceId: string;\n\t\t\treadonly at: number;\n\t\t\treadonly name: string;\n\t\t\treadonly message: string;\n\t  }\n\t| { readonly kind: \"phase\"; readonly traceId: string; readonly at: number; readonly phase: string };\n\nexport interface HostOutputProjectorV1 {\n\tproject(events: readonly HostEventV1[]): readonly HostOutputRecordV1[];\n}\n\n/** Deterministic error-code mapping for diagnostics. */\nfunction diagnosticCode(name: string): string {\n\tconst table: readonly (readonly [string, string])[] = [\n\t\t[\"AbortError\", \"cancelled\"],\n\t\t[\"TimeoutError\", \"timeout\"],\n\t\t[\"TypeError\", \"invalid_input\"],\n\t\t[\"RangeError\", \"out_of_range\"],\n\t];\n\treturn table.find(([matching]) => matching === name)?.[1] ?? \"internal_error\";\n}\n\nexport function createHostOutputProjector(): HostOutputProjectorV1 {\n\treturn {\n\t\tproject(events) {\n\t\t\treturn events.map((event) => {\n\t\t\t\tif (!event.traceId) {\n\t\t\t\t\tthrow new Error(\"Host output projection requires a traceId on every event\");\n\t\t\t\t}\n\t\t\t\tswitch (event.kind) {\n\t\t\t\t\tcase \"model_output\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"message\" as const,\n\t\t\t\t\t\t\tseverity: \"info\" as const,\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: event.text,\n\t\t\t\t\t\t};\n\t\t\t\t\tcase \"tool_call\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"tool\" as const,\n\t\t\t\t\t\t\tseverity: \"info\" as const,\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tcorrelationId: event.callId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: `tool ${event.toolName} called`,\n\t\t\t\t\t\t\tcode: event.toolName,\n\t\t\t\t\t\t};\n\t\t\t\t\tcase \"tool_result\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"tool\" as const,\n\t\t\t\t\t\t\tseverity: event.ok ? (\"ok\" as const) : (\"error\" as const),\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tcorrelationId: event.callId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: `tool ${event.toolName} ${event.ok ? \"succeeded\" : \"failed\"}`,\n\t\t\t\t\t\t\tcode: event.toolName,\n\t\t\t\t\t\t\t...(event.detail === undefined ? {} : { detail: event.detail }),\n\t\t\t\t\t\t};\n\t\t\t\t\tcase \"error\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"diagnostic\" as const,\n\t\t\t\t\t\t\tseverity: \"error\" as const,\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: event.message,\n\t\t\t\t\t\t\tcode: diagnosticCode(event.name),\n\t\t\t\t\t\t\tdetail: event.name,\n\t\t\t\t\t\t};\n\t\t\t\t\tcase \"phase\":\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tchannel: \"lifecycle\" as const,\n\t\t\t\t\t\t\tseverity: \"info\" as const,\n\t\t\t\t\t\t\ttraceId: event.traceId,\n\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\tsummary: `phase: ${event.phase}`,\n\t\t\t\t\t\t\tcode: event.phase,\n\t\t\t\t\t\t};\n\t\t\t\t\tdefault:\n\t\t\t\t\t\tthrow new Error(\"Unsupported host event reached the projector\");\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t};\n}\n"]}

package/dist/host/output-reducer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Output reducer (3.5a) — deterministic fold/unfold over projected host
+ * output records (2.6b), for viewer-friendly summaries.
+ *
+ * Folding is a PURE VIEW operation: consecutive tool call/result pairs are
+ * grouped by correlationId into fold summaries (counts only), while
+ * message, diagnostic, and lifecycle records — including any terminal
+ * phase — always stay unfolded. The original records are kept by reference
+ * inside each group, so unfolding reproduces the exact input sequence:
+ * folding and unfolding never change events, revisions, artifact
+ * references, or terminal states. TUI interaction and persistent renderers
+ * are out of scope.
+ */
+import type { HostOutputRecordV1 } from "./output-projection.ts";
+export type FoldedOutputGroupV1 = {
+    readonly kind: "records";
+    readonly detailsRef: string;
+    readonly records: readonly HostOutputRecordV1[];
+} | {
+    readonly kind: "tool";
+    readonly toolName: string;
+    readonly correlationId: string;
+    readonly detailsRef: string;
+    readonly calls: number;
+    readonly ok: number;
+    readonly failed: number;
+    /** Wall time from the first to the last record of the group (终端输出模式设计 §3 必显耗时). */
+    readonly durationMs: number;
+    /** The original records, kept by reference for exact unfolding. */
+    readonly records: readonly HostOutputRecordV1[];
+};
+export interface FoldedOutputV1 {
+    readonly groups: readonly FoldedOutputGroupV1[];
+    readonly totalRecords: number;
+    readonly foldedToolGroups: number;
+}
+export interface OutputReducerV1 {
+    fold(records: readonly HostOutputRecordV1[]): FoldedOutputV1;
+    /** Exact inverse: unfold(fold(records)) deep-equals records, order included. */
+    unfold(folded: FoldedOutputV1): readonly HostOutputRecordV1[];
+}
+export declare function createOutputReducer(): OutputReducerV1;
+//# sourceMappingURL=output-reducer.d.ts.map

package/dist/host/output-reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-reducer.d.ts","sourceRoot":"","sources":["../../src/host/output-reducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAAE,GAC1G;IACA,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4GAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC/C,CAAC;AAEL,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,cAAc,CAAC;IAC7D,gFAAgF;IAChF,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,kBAAkB,EAAE,CAAC;CAC9D;AAmBD,wBAAgB,mBAAmB,IAAI,eAAe,CAyErD","sourcesContent":["/**\n * Output reducer (3.5a) — deterministic fold/unfold over projected host\n * output records (2.6b), for viewer-friendly summaries.\n *\n * Folding is a PURE VIEW operation: consecutive tool call/result pairs are\n * grouped by correlationId into fold summaries (counts only), while\n * message, diagnostic, and lifecycle records — including any terminal\n * phase — always stay unfolded. The original records are kept by reference\n * inside each group, so unfolding reproduces the exact input sequence:\n * folding and unfolding never change events, revisions, artifact\n * references, or terminal states. TUI interaction and persistent renderers\n * are out of scope.\n */\nimport type { HostOutputRecordV1 } from \"./output-projection.ts\";\n\nexport type FoldedOutputGroupV1 =\n\t| { readonly kind: \"records\"; readonly detailsRef: string; readonly records: readonly HostOutputRecordV1[] }\n\t| {\n\t\t\treadonly kind: \"tool\";\n\t\t\treadonly toolName: string;\n\t\t\treadonly correlationId: string;\n\t\t\treadonly detailsRef: string;\n\t\t\treadonly calls: number;\n\t\t\treadonly ok: number;\n\t\t\treadonly failed: number;\n\t\t\t/** Wall time from the first to the last record of the group (终端输出模式设计 §3 必显耗时). */\n\t\t\treadonly durationMs: number;\n\t\t\t/** The original records, kept by reference for exact unfolding. */\n\t\t\treadonly records: readonly HostOutputRecordV1[];\n\t  };\n\nexport interface FoldedOutputV1 {\n\treadonly groups: readonly FoldedOutputGroupV1[];\n\treadonly totalRecords: number;\n\treadonly foldedToolGroups: number;\n}\n\nexport interface OutputReducerV1 {\n\tfold(records: readonly HostOutputRecordV1[]): FoldedOutputV1;\n\t/** Exact inverse: unfold(fold(records)) deep-equals records, order included. */\n\tunfold(folded: FoldedOutputV1): readonly HostOutputRecordV1[];\n}\n\ninterface MutableRecordsGroup {\n\treadonly kind: \"records\";\n\tdetailsRef: string;\n\treadonly records: HostOutputRecordV1[];\n}\n\ninterface MutableToolGroup {\n\treadonly kind: \"tool\";\n\treadonly toolName: string;\n\treadonly correlationId: string;\n\treadonly detailsRef: string;\n\tcalls: number;\n\tok: number;\n\tfailed: number;\n\treadonly records: HostOutputRecordV1[];\n}\n\nexport function createOutputReducer(): OutputReducerV1 {\n\treturn {\n\t\tfold(records) {\n\t\t\tconst groups: Array<MutableRecordsGroup | MutableToolGroup> = [];\n\n\t\t\tlet pendingTool: MutableToolGroup | null = null;\n\t\t\tconst flushTool = (): void => {\n\t\t\t\tif (pendingTool) {\n\t\t\t\t\tgroups.push(pendingTool);\n\t\t\t\t\tpendingTool = null;\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tfor (const record of records) {\n\t\t\t\tif (record.channel === \"tool\" && record.correlationId !== undefined) {\n\t\t\t\t\tconst isCall = record.severity === \"info\" && record.summary.endsWith(\"called\");\n\t\t\t\t\tif (pendingTool && pendingTool.correlationId !== record.correlationId) flushTool();\n\t\t\t\t\tif (!pendingTool) {\n\t\t\t\t\t\tpendingTool = {\n\t\t\t\t\t\t\tkind: \"tool\",\n\t\t\t\t\t\t\ttoolName: record.code ?? record.summary,\n\t\t\t\t\t\t\tcorrelationId: record.correlationId,\n\t\t\t\t\t\t\tdetailsRef: `trace:${record.traceId}#call:${record.correlationId}`,\n\t\t\t\t\t\t\tcalls: 0,\n\t\t\t\t\t\t\tok: 0,\n\t\t\t\t\t\t\tfailed: 0,\n\t\t\t\t\t\t\trecords: [],\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\tpendingTool.records.push(record);\n\t\t\t\t\tif (isCall) pendingTool.calls += 1;\n\t\t\t\t\telse if (record.severity === \"ok\") pendingTool.ok += 1;\n\t\t\t\t\telse if (record.severity === \"error\") pendingTool.failed += 1;\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tflushTool();\n\t\t\t\tconst last = groups.at(-1);\n\t\t\t\tif (last?.kind === \"records\") {\n\t\t\t\t\tlast.records.push(record);\n\t\t\t\t\tlast.detailsRef = `trace:${record.traceId}#records:${last.records.length}`;\n\t\t\t\t} else {\n\t\t\t\t\tgroups.push({\n\t\t\t\t\t\tkind: \"records\",\n\t\t\t\t\t\tdetailsRef: `trace:${record.traceId}#records:1`,\n\t\t\t\t\t\trecords: [record],\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\tflushTool();\n\n\t\t\tlet foldedToolGroups = 0;\n\t\t\tconst frozenGroups = groups.map((group): FoldedOutputGroupV1 => {\n\t\t\t\tconst base = { ...group, records: Object.freeze([...group.records]) };\n\t\t\t\tif (base.kind === \"tool\") {\n\t\t\t\t\tfoldedToolGroups += 1;\n\t\t\t\t\t// v8 ignore next -- tool 组至少包含触发分组的那条记录，恒非空\n\t\t\t\t\tconst firstAt = base.records[0]?.at ?? 0;\n\t\t\t\t\t// v8 ignore next -- tool 组至少包含触发分组的那条记录，恒非空\n\t\t\t\t\tconst lastAt = base.records.at(-1)?.at ?? firstAt;\n\t\t\t\t\treturn Object.freeze({ ...base, durationMs: Math.max(lastAt - firstAt, 0) });\n\t\t\t\t}\n\t\t\t\treturn Object.freeze(base);\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tgroups: Object.freeze(frozenGroups),\n\t\t\t\ttotalRecords: records.length,\n\t\t\t\tfoldedToolGroups,\n\t\t\t};\n\t\t},\n\t\tunfold(folded) {\n\t\t\treturn Object.freeze(folded.groups.flatMap((group) => [...group.records]));\n\t\t},\n\t};\n}\n"]}

package/dist/host/output-reducer.js

@@ -0,0 +1,77 @@
+export function createOutputReducer() {
+    return {
+        fold(records) {
+            const groups = [];
+            let pendingTool = null;
+            const flushTool = () => {
+                if (pendingTool) {
+                    groups.push(pendingTool);
+                    pendingTool = null;
+                }
+            };
+            for (const record of records) {
+                if (record.channel === "tool" && record.correlationId !== undefined) {
+                    const isCall = record.severity === "info" && record.summary.endsWith("called");
+                    if (pendingTool && pendingTool.correlationId !== record.correlationId)
+                        flushTool();
+                    if (!pendingTool) {
+                        pendingTool = {
+                            kind: "tool",
+                            toolName: record.code ?? record.summary,
+                            correlationId: record.correlationId,
+                            detailsRef: `trace:${record.traceId}#call:${record.correlationId}`,
+                            calls: 0,
+                            ok: 0,
+                            failed: 0,
+                            records: [],
+                        };
+                    }
+                    pendingTool.records.push(record);
+                    if (isCall)
+                        pendingTool.calls += 1;
+                    else if (record.severity === "ok")
+                        pendingTool.ok += 1;
+                    else if (record.severity === "error")
+                        pendingTool.failed += 1;
+                    continue;
+                }
+                flushTool();
+                const last = groups.at(-1);
+                if (last?.kind === "records") {
+                    last.records.push(record);
+                    last.detailsRef = `trace:${record.traceId}#records:${last.records.length}`;
+                }
+                else {
+                    groups.push({
+                        kind: "records",
+                        detailsRef: `trace:${record.traceId}#records:1`,
+                        records: [record],
+                    });
+                }
+            }
+            flushTool();
+            let foldedToolGroups = 0;
+            const frozenGroups = groups.map((group) => {
+                const base = { ...group, records: Object.freeze([...group.records]) };
+                if (base.kind === "tool") {
+                    foldedToolGroups += 1;
+                    // v8 ignore next -- tool 组至少包含触发分组的那条记录，恒非空
+                    const firstAt = base.records[0]?.at ?? 0;
+                    // v8 ignore next -- tool 组至少包含触发分组的那条记录，恒非空
+                    const lastAt = base.records.at(-1)?.at ?? firstAt;
+                    return Object.freeze({ ...base, durationMs: Math.max(lastAt - firstAt, 0) });
+                }
+                return Object.freeze(base);
+            });
+            return {
+                groups: Object.freeze(frozenGroups),
+                totalRecords: records.length,
+                foldedToolGroups,
+            };
+        },
+        unfold(folded) {
+            return Object.freeze(folded.groups.flatMap((group) => [...group.records]));
+        },
+    };
+}
+//# sourceMappingURL=output-reducer.js.map

package/dist/host/output-reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-reducer.js","sourceRoot":"","sources":["../../src/host/output-reducer.ts"],"names":[],"mappings":"AA4DA,MAAM,UAAU,mBAAmB,GAAoB;IACtD,OAAO;QACN,IAAI,CAAC,OAAO,EAAE;YACb,MAAM,MAAM,GAAkD,EAAE,CAAC;YAEjE,IAAI,WAAW,GAA4B,IAAI,CAAC;YAChD,MAAM,SAAS,GAAG,GAAS,EAAE,CAAC;gBAC7B,IAAI,WAAW,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBACzB,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;YAAA,CACD,CAAC;YAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC9B,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;oBACrE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAC/E,IAAI,WAAW,IAAI,WAAW,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa;wBAAE,SAAS,EAAE,CAAC;oBACnF,IAAI,CAAC,WAAW,EAAE,CAAC;wBAClB,WAAW,GAAG;4BACb,IAAI,EAAE,MAAM;4BACZ,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO;4BACvC,aAAa,EAAE,MAAM,CAAC,aAAa;4BACnC,UAAU,EAAE,SAAS,MAAM,CAAC,OAAO,SAAS,MAAM,CAAC,aAAa,EAAE;4BAClE,KAAK,EAAE,CAAC;4BACR,EAAE,EAAE,CAAC;4BACL,MAAM,EAAE,CAAC;4BACT,OAAO,EAAE,EAAE;yBACX,CAAC;oBACH,CAAC;oBACD,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACjC,IAAI,MAAM;wBAAE,WAAW,CAAC,KAAK,IAAI,CAAC,CAAC;yBAC9B,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI;wBAAE,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;yBAClD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;wBAAE,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC;oBAC9D,SAAS;gBACV,CAAC;gBACD,SAAS,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3B,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC1B,IAAI,CAAC,UAAU,GAAG,SAAS,MAAM,CAAC,OAAO,YAAY,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC5E,CAAC;qBAAM,CAAC;oBACP,MAAM,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,SAAS;wBACf,UAAU,EAAE,SAAS,MAAM,CAAC,OAAO,YAAY;wBAC/C,OAAO,EAAE,CAAC,MAAM,CAAC;qBACjB,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;YACD,SAAS,EAAE,CAAC;YAEZ,IAAI,gBAAgB,GAAG,CAAC,CAAC;YACzB,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAuB,EAAE,CAAC;gBAC/D,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBACtE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,gBAAgB,IAAI,CAAC,CAAC;oBACtB,gFAA4C;oBAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;oBACzC,gFAA4C;oBAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,OAAO,CAAC;oBAClD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9E,CAAC;gBACD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAAA,CAC3B,CAAC,CAAC;YACH,OAAO;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;gBACnC,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,gBAAgB;aAChB,CAAC;QAAA,CACF;QACD,MAAM,CAAC,MAAM,EAAE;YACd,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAAA,CAC3E;KACD,CAAC;AAAA,CACF","sourcesContent":["/**\n * Output reducer (3.5a) — deterministic fold/unfold over projected host\n * output records (2.6b), for viewer-friendly summaries.\n *\n * Folding is a PURE VIEW operation: consecutive tool call/result pairs are\n * grouped by correlationId into fold summaries (counts only), while\n * message, diagnostic, and lifecycle records — including any terminal\n * phase — always stay unfolded. The original records are kept by reference\n * inside each group, so unfolding reproduces the exact input sequence:\n * folding and unfolding never change events, revisions, artifact\n * references, or terminal states. TUI interaction and persistent renderers\n * are out of scope.\n */\nimport type { HostOutputRecordV1 } from \"./output-projection.ts\";\n\nexport type FoldedOutputGroupV1 =\n\t| { readonly kind: \"records\"; readonly detailsRef: string; readonly records: readonly HostOutputRecordV1[] }\n\t| {\n\t\t\treadonly kind: \"tool\";\n\t\t\treadonly toolName: string;\n\t\t\treadonly correlationId: string;\n\t\t\treadonly detailsRef: string;\n\t\t\treadonly calls: number;\n\t\t\treadonly ok: number;\n\t\t\treadonly failed: number;\n\t\t\t/** Wall time from the first to the last record of the group (终端输出模式设计 §3 必显耗时). */\n\t\t\treadonly durationMs: number;\n\t\t\t/** The original records, kept by reference for exact unfolding. */\n\t\t\treadonly records: readonly HostOutputRecordV1[];\n\t  };\n\nexport interface FoldedOutputV1 {\n\treadonly groups: readonly FoldedOutputGroupV1[];\n\treadonly totalRecords: number;\n\treadonly foldedToolGroups: number;\n}\n\nexport interface OutputReducerV1 {\n\tfold(records: readonly HostOutputRecordV1[]): FoldedOutputV1;\n\t/** Exact inverse: unfold(fold(records)) deep-equals records, order included. */\n\tunfold(folded: FoldedOutputV1): readonly HostOutputRecordV1[];\n}\n\ninterface MutableRecordsGroup {\n\treadonly kind: \"records\";\n\tdetailsRef: string;\n\treadonly records: HostOutputRecordV1[];\n}\n\ninterface MutableToolGroup {\n\treadonly kind: \"tool\";\n\treadonly toolName: string;\n\treadonly correlationId: string;\n\treadonly detailsRef: string;\n\tcalls: number;\n\tok: number;\n\tfailed: number;\n\treadonly records: HostOutputRecordV1[];\n}\n\nexport function createOutputReducer(): OutputReducerV1 {\n\treturn {\n\t\tfold(records) {\n\t\t\tconst groups: Array<MutableRecordsGroup | MutableToolGroup> = [];\n\n\t\t\tlet pendingTool: MutableToolGroup | null = null;\n\t\t\tconst flushTool = (): void => {\n\t\t\t\tif (pendingTool) {\n\t\t\t\t\tgroups.push(pendingTool);\n\t\t\t\t\tpendingTool = null;\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tfor (const record of records) {\n\t\t\t\tif (record.channel === \"tool\" && record.correlationId !== undefined) {\n\t\t\t\t\tconst isCall = record.severity === \"info\" && record.summary.endsWith(\"called\");\n\t\t\t\t\tif (pendingTool && pendingTool.correlationId !== record.correlationId) flushTool();\n\t\t\t\t\tif (!pendingTool) {\n\t\t\t\t\t\tpendingTool = {\n\t\t\t\t\t\t\tkind: \"tool\",\n\t\t\t\t\t\t\ttoolName: record.code ?? record.summary,\n\t\t\t\t\t\t\tcorrelationId: record.correlationId,\n\t\t\t\t\t\t\tdetailsRef: `trace:${record.traceId}#call:${record.correlationId}`,\n\t\t\t\t\t\t\tcalls: 0,\n\t\t\t\t\t\t\tok: 0,\n\t\t\t\t\t\t\tfailed: 0,\n\t\t\t\t\t\t\trecords: [],\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\tpendingTool.records.push(record);\n\t\t\t\t\tif (isCall) pendingTool.calls += 1;\n\t\t\t\t\telse if (record.severity === \"ok\") pendingTool.ok += 1;\n\t\t\t\t\telse if (record.severity === \"error\") pendingTool.failed += 1;\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tflushTool();\n\t\t\t\tconst last = groups.at(-1);\n\t\t\t\tif (last?.kind === \"records\") {\n\t\t\t\t\tlast.records.push(record);\n\t\t\t\t\tlast.detailsRef = `trace:${record.traceId}#records:${last.records.length}`;\n\t\t\t\t} else {\n\t\t\t\t\tgroups.push({\n\t\t\t\t\t\tkind: \"records\",\n\t\t\t\t\t\tdetailsRef: `trace:${record.traceId}#records:1`,\n\t\t\t\t\t\trecords: [record],\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\tflushTool();\n\n\t\t\tlet foldedToolGroups = 0;\n\t\t\tconst frozenGroups = groups.map((group): FoldedOutputGroupV1 => {\n\t\t\t\tconst base = { ...group, records: Object.freeze([...group.records]) };\n\t\t\t\tif (base.kind === \"tool\") {\n\t\t\t\t\tfoldedToolGroups += 1;\n\t\t\t\t\t// v8 ignore next -- tool 组至少包含触发分组的那条记录，恒非空\n\t\t\t\t\tconst firstAt = base.records[0]?.at ?? 0;\n\t\t\t\t\t// v8 ignore next -- tool 组至少包含触发分组的那条记录，恒非空\n\t\t\t\t\tconst lastAt = base.records.at(-1)?.at ?? firstAt;\n\t\t\t\t\treturn Object.freeze({ ...base, durationMs: Math.max(lastAt - firstAt, 0) });\n\t\t\t\t}\n\t\t\t\treturn Object.freeze(base);\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tgroups: Object.freeze(frozenGroups),\n\t\t\t\ttotalRecords: records.length,\n\t\t\t\tfoldedToolGroups,\n\t\t\t};\n\t\t},\n\t\tunfold(folded) {\n\t\t\treturn Object.freeze(folded.groups.flatMap((group) => [...group.records]));\n\t\t},\n\t};\n}\n"]}

package/dist/host/output-serializer.d.ts

@@ -0,0 +1,31 @@
+export type HostOutputSurfaceV1 = "tui" | "cli-text" | "inspector";
+export interface HostOutputSerializerContextV1 {
+    readonly surface: HostOutputSurfaceV1;
+    readonly policyVersion: string;
+    readonly inspectorAuthorized: boolean;
+}
+export interface OutputArtifactRefV1 {
+    readonly sessionId: string;
+    readonly operationId: string;
+    readonly artifactId: string;
+    readonly kind: string;
+    readonly mediaType: string;
+    readonly sizeBytes?: number;
+    readonly truncated: boolean;
+    readonly createdAt: number;
+}
+export interface HostOutputProjectionV1 {
+    readonly text: string;
+    readonly artifacts?: readonly OutputArtifactRefV1[];
+    readonly redactions?: readonly string[];
+    readonly diagnostics?: readonly string[];
+    readonly rejected?: {
+        readonly code: "output_projection_rejected";
+        readonly reason: string;
+    };
+}
+export interface HostOutputSerializerV1 {
+    project(input: Readonly<Record<string, unknown>>, context: HostOutputSerializerContextV1): HostOutputProjectionV1;
+}
+export declare function createHostOutputSerializer(): HostOutputSerializerV1;
+//# sourceMappingURL=output-serializer.d.ts.map

package/dist/host/output-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-serializer.d.ts","sourceRoot":"","sources":["../../src/host/output-serializer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnE,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7F;AAoBD,MAAM,WAAW,sBAAsB;IACtC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,6BAA6B,GAAG,sBAAsB,CAAC;CAClH;AA2CD,wBAAgB,0BAA0B,IAAI,sBAAsB,CA6EnE","sourcesContent":["export type HostOutputSurfaceV1 = \"tui\" | \"cli-text\" | \"inspector\";\n\nexport interface HostOutputSerializerContextV1 {\n\treadonly surface: HostOutputSurfaceV1;\n\treadonly policyVersion: string;\n\treadonly inspectorAuthorized: boolean;\n}\n\nexport interface OutputArtifactRefV1 {\n\treadonly sessionId: string;\n\treadonly operationId: string;\n\treadonly artifactId: string;\n\treadonly kind: string;\n\treadonly mediaType: string;\n\treadonly sizeBytes?: number;\n\treadonly truncated: boolean;\n\treadonly createdAt: number;\n}\n\nexport interface HostOutputProjectionV1 {\n\treadonly text: string;\n\treadonly artifacts?: readonly OutputArtifactRefV1[];\n\treadonly redactions?: readonly string[];\n\treadonly diagnostics?: readonly string[];\n\treadonly rejected?: { readonly code: \"output_projection_rejected\"; readonly reason: string };\n}\n\n/** Field keys that may never reach tui/cli-text surfaces at any depth. */\nconst INTERNAL_FIELD_KEYS: readonly string[] = [\n\t\"memoryId\",\n\t\"memoryIds\",\n\t\"score\",\n\t\"scores\",\n\t\"ranking\",\n\t\"queryPlan\",\n\t\"budget\",\n\t\"budgets\",\n\t\"agentRole\",\n\t\"pluginRole\",\n\t\"lease\",\n\t\"leaseId\",\n\t\"purgeState\",\n\t\"rawSources\",\n];\n\nexport interface HostOutputSerializerV1 {\n\tproject(input: Readonly<Record<string, unknown>>, context: HostOutputSerializerContextV1): HostOutputProjectionV1;\n}\n\ninterface ArtifactLike {\n\treadonly sessionId?: unknown;\n\treadonly operationId?: unknown;\n\treadonly artifactId?: unknown;\n\treadonly kind?: unknown;\n\treadonly mediaType?: unknown;\n\treadonly sizeBytes?: unknown;\n\treadonly truncated?: unknown;\n\treadonly createdAt?: unknown;\n}\n\nfunction isArtifactLike(value: unknown): value is ArtifactLike {\n\treturn (\n\t\ttypeof value === \"object\" && value !== null && \"artifactId\" in value && \"sessionId\" in value && \"kind\" in value\n\t);\n}\n\nfunction toArtifactRef(value: ArtifactLike): OutputArtifactRefV1 | undefined {\n\tif (\n\t\ttypeof value.sessionId !== \"string\" ||\n\t\ttypeof value.operationId !== \"string\" ||\n\t\ttypeof value.artifactId !== \"string\" ||\n\t\ttypeof value.kind !== \"string\" ||\n\t\ttypeof value.mediaType !== \"string\" ||\n\t\ttypeof value.truncated !== \"boolean\" ||\n\t\ttypeof value.createdAt !== \"number\"\n\t) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tsessionId: value.sessionId,\n\t\toperationId: value.operationId,\n\t\tartifactId: value.artifactId,\n\t\tkind: value.kind,\n\t\tmediaType: value.mediaType,\n\t\t...(typeof value.sizeBytes === \"number\" ? { sizeBytes: value.sizeBytes } : {}),\n\t\ttruncated: value.truncated,\n\t\tcreatedAt: value.createdAt,\n\t};\n}\n\nexport function createHostOutputSerializer(): HostOutputSerializerV1 {\n\treturn {\n\t\tproject(input, context) {\n\t\t\tif (context.policyVersion.trim().length === 0) {\n\t\t\t\treturn {\n\t\t\t\t\ttext: \"\",\n\t\t\t\t\tdiagnostics: [\"output_projection_rejected: policyVersion must be a non-empty string\"],\n\t\t\t\t\trejected: { code: \"output_projection_rejected\", reason: \"policyVersion must be a non-empty string\" },\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst redactions: string[] = [];\n\t\t\tconst diagnostics: string[] = [];\n\t\t\tconst artifacts: OutputArtifactRefV1[] = [];\n\t\t\tconst showInternal = context.surface === \"inspector\" && context.inspectorAuthorized;\n\t\t\t// §5.4 requires building the field allowlist FIRST — the renderer can\n\t\t\t// only ever see allowlisted facts, so no fallback path can leak.\n\t\t\tconst isAllowedKey = (key: string): boolean => !INTERNAL_FIELD_KEYS.includes(key) || showInternal;\n\n\t\t\tconst renderValue = (key: string, value: unknown, path: string): string => {\n\t\t\t\tif (!isAllowedKey(key)) {\n\t\t\t\t\tredactions.push(`${path}.${key}`);\n\t\t\t\t\treturn `[redacted:${key}]`;\n\t\t\t\t}\n\t\t\t\tif (isArtifactLike(value)) {\n\t\t\t\t\tconst ref = toArtifactRef(value);\n\t\t\t\t\tif (ref) {\n\t\t\t\t\t\tartifacts.push(ref);\n\t\t\t\t\t\treturn `[artifact:${ref.artifactId}]`;\n\t\t\t\t\t}\n\t\t\t\t\tdiagnostics.push(`output_projection_rejected: ${path}.${key} is a malformed artifact reference`);\n\t\t\t\t\treturn `[unrenderable:${key}]`;\n\t\t\t\t}\n\t\t\t\tif (typeof value === \"string\") return value;\n\t\t\t\tif (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n\t\t\t\tif (value === null) return \"null\";\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tconst rendered = value.map((item) => renderValue(key, item, path));\n\t\t\t\t\treturn `[${rendered.join(\", \")}]`;\n\t\t\t\t}\n\t\t\t\tif (typeof value === \"object\") {\n\t\t\t\t\tconst rendered = Object.entries(value)\n\t\t\t\t\t\t.map(\n\t\t\t\t\t\t\t([nestedKey, nestedValue]) =>\n\t\t\t\t\t\t\t\t`${nestedKey}:${renderValue(nestedKey, nestedValue, `${path}.${key}`)}`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.join(\", \");\n\t\t\t\t\treturn `{${rendered}}`;\n\t\t\t\t}\n\t\t\t\tdiagnostics.push(`output_projection_rejected: ${path}.${key} cannot be serialized`);\n\t\t\t\treturn `[unrenderable:${key}]`;\n\t\t\t};\n\n\t\t\tconst textParts: string[] = [];\n\t\t\tfor (const [key, value] of Object.entries(input)) {\n\t\t\t\tif (key === \"artifacts\" && Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\tif (isArtifactLike(entry)) {\n\t\t\t\t\t\t\tconst ref = toArtifactRef(entry);\n\t\t\t\t\t\t\tif (ref) artifacts.push(ref);\n\t\t\t\t\t\t\telse diagnostics.push(\"output_projection_rejected: artifacts entry is malformed\");\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tdiagnostics.push(\"output_projection_rejected: artifacts entry is malformed\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\ttextParts.push(`${key}=${renderValue(key, value, \"root\")}`);\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\ttext: textParts.join(\"\\n\"),\n\t\t\t\t...(artifacts.length > 0 ? { artifacts: Object.freeze(artifacts) } : {}),\n\t\t\t\t...(redactions.length > 0 ? { redactions: Object.freeze([...redactions]) } : {}),\n\t\t\t\t...(diagnostics.length > 0 ? { diagnostics: Object.freeze([...diagnostics]) } : {}),\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/host/output-serializer.js

@@ -0,0 +1,120 @@
+/** Field keys that may never reach tui/cli-text surfaces at any depth. */
+const INTERNAL_FIELD_KEYS = [
+    "memoryId",
+    "memoryIds",
+    "score",
+    "scores",
+    "ranking",
+    "queryPlan",
+    "budget",
+    "budgets",
+    "agentRole",
+    "pluginRole",
+    "lease",
+    "leaseId",
+    "purgeState",
+    "rawSources",
+];
+function isArtifactLike(value) {
+    return (typeof value === "object" && value !== null && "artifactId" in value && "sessionId" in value && "kind" in value);
+}
+function toArtifactRef(value) {
+    if (typeof value.sessionId !== "string" ||
+        typeof value.operationId !== "string" ||
+        typeof value.artifactId !== "string" ||
+        typeof value.kind !== "string" ||
+        typeof value.mediaType !== "string" ||
+        typeof value.truncated !== "boolean" ||
+        typeof value.createdAt !== "number") {
+        return undefined;
+    }
+    return {
+        sessionId: value.sessionId,
+        operationId: value.operationId,
+        artifactId: value.artifactId,
+        kind: value.kind,
+        mediaType: value.mediaType,
+        ...(typeof value.sizeBytes === "number" ? { sizeBytes: value.sizeBytes } : {}),
+        truncated: value.truncated,
+        createdAt: value.createdAt,
+    };
+}
+export function createHostOutputSerializer() {
+    return {
+        project(input, context) {
+            if (context.policyVersion.trim().length === 0) {
+                return {
+                    text: "",
+                    diagnostics: ["output_projection_rejected: policyVersion must be a non-empty string"],
+                    rejected: { code: "output_projection_rejected", reason: "policyVersion must be a non-empty string" },
+                };
+            }
+            const redactions = [];
+            const diagnostics = [];
+            const artifacts = [];
+            const showInternal = context.surface === "inspector" && context.inspectorAuthorized;
+            // §5.4 requires building the field allowlist FIRST — the renderer can
+            // only ever see allowlisted facts, so no fallback path can leak.
+            const isAllowedKey = (key) => !INTERNAL_FIELD_KEYS.includes(key) || showInternal;
+            const renderValue = (key, value, path) => {
+                if (!isAllowedKey(key)) {
+                    redactions.push(`${path}.${key}`);
+                    return `[redacted:${key}]`;
+                }
+                if (isArtifactLike(value)) {
+                    const ref = toArtifactRef(value);
+                    if (ref) {
+                        artifacts.push(ref);
+                        return `[artifact:${ref.artifactId}]`;
+                    }
+                    diagnostics.push(`output_projection_rejected: ${path}.${key} is a malformed artifact reference`);
+                    return `[unrenderable:${key}]`;
+                }
+                if (typeof value === "string")
+                    return value;
+                if (typeof value === "number" || typeof value === "boolean")
+                    return String(value);
+                if (value === null)
+                    return "null";
+                if (Array.isArray(value)) {
+                    const rendered = value.map((item) => renderValue(key, item, path));
+                    return `[${rendered.join(", ")}]`;
+                }
+                if (typeof value === "object") {
+                    const rendered = Object.entries(value)
+                        .map(([nestedKey, nestedValue]) => `${nestedKey}:${renderValue(nestedKey, nestedValue, `${path}.${key}`)}`)
+                        .join(", ");
+                    return `{${rendered}}`;
+                }
+                diagnostics.push(`output_projection_rejected: ${path}.${key} cannot be serialized`);
+                return `[unrenderable:${key}]`;
+            };
+            const textParts = [];
+            for (const [key, value] of Object.entries(input)) {
+                if (key === "artifacts" && Array.isArray(value)) {
+                    for (const entry of value) {
+                        if (isArtifactLike(entry)) {
+                            const ref = toArtifactRef(entry);
+                            if (ref)
+                                artifacts.push(ref);
+                            else
+                                diagnostics.push("output_projection_rejected: artifacts entry is malformed");
+                        }
+                        else {
+                            diagnostics.push("output_projection_rejected: artifacts entry is malformed");
+                        }
+                    }
+                    continue;
+                }
+                textParts.push(`${key}=${renderValue(key, value, "root")}`);
+            }
+            return {
+                text: textParts.join("\n"),
+                ...(artifacts.length > 0 ? { artifacts: Object.freeze(artifacts) } : {}),
+                ...(redactions.length > 0 ? { redactions: Object.freeze([...redactions]) } : {}),
+                ...(diagnostics.length > 0 ? { diagnostics: Object.freeze([...diagnostics]) } : {}),
+            };
+        },
+    };
+}
+//# sourceMappingURL=output-serializer.js.map

package/dist/host/output-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-serializer.js","sourceRoot":"","sources":["../../src/host/output-serializer.ts"],"names":[],"mappings":"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","sourcesContent":["export type HostOutputSurfaceV1 = \"tui\" | \"cli-text\" | \"inspector\";\n\nexport interface HostOutputSerializerContextV1 {\n\treadonly surface: HostOutputSurfaceV1;\n\treadonly policyVersion: string;\n\treadonly inspectorAuthorized: boolean;\n}\n\nexport interface OutputArtifactRefV1 {\n\treadonly sessionId: string;\n\treadonly operationId: string;\n\treadonly artifactId: string;\n\treadonly kind: string;\n\treadonly mediaType: string;\n\treadonly sizeBytes?: number;\n\treadonly truncated: boolean;\n\treadonly createdAt: number;\n}\n\nexport interface HostOutputProjectionV1 {\n\treadonly text: string;\n\treadonly artifacts?: readonly OutputArtifactRefV1[];\n\treadonly redactions?: readonly string[];\n\treadonly diagnostics?: readonly string[];\n\treadonly rejected?: { readonly code: \"output_projection_rejected\"; readonly reason: string };\n}\n\n/** Field keys that may never reach tui/cli-text surfaces at any depth. */\nconst INTERNAL_FIELD_KEYS: readonly string[] = [\n\t\"memoryId\",\n\t\"memoryIds\",\n\t\"score\",\n\t\"scores\",\n\t\"ranking\",\n\t\"queryPlan\",\n\t\"budget\",\n\t\"budgets\",\n\t\"agentRole\",\n\t\"pluginRole\",\n\t\"lease\",\n\t\"leaseId\",\n\t\"purgeState\",\n\t\"rawSources\",\n];\n\nexport interface HostOutputSerializerV1 {\n\tproject(input: Readonly<Record<string, unknown>>, context: HostOutputSerializerContextV1): HostOutputProjectionV1;\n}\n\ninterface ArtifactLike {\n\treadonly sessionId?: unknown;\n\treadonly operationId?: unknown;\n\treadonly artifactId?: unknown;\n\treadonly kind?: unknown;\n\treadonly mediaType?: unknown;\n\treadonly sizeBytes?: unknown;\n\treadonly truncated?: unknown;\n\treadonly createdAt?: unknown;\n}\n\nfunction isArtifactLike(value: unknown): value is ArtifactLike {\n\treturn (\n\t\ttypeof value === \"object\" && value !== null && \"artifactId\" in value && \"sessionId\" in value && \"kind\" in value\n\t);\n}\n\nfunction toArtifactRef(value: ArtifactLike): OutputArtifactRefV1 | undefined {\n\tif (\n\t\ttypeof value.sessionId !== \"string\" ||\n\t\ttypeof value.operationId !== \"string\" ||\n\t\ttypeof value.artifactId !== \"string\" ||\n\t\ttypeof value.kind !== \"string\" ||\n\t\ttypeof value.mediaType !== \"string\" ||\n\t\ttypeof value.truncated !== \"boolean\" ||\n\t\ttypeof value.createdAt !== \"number\"\n\t) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tsessionId: value.sessionId,\n\t\toperationId: value.operationId,\n\t\tartifactId: value.artifactId,\n\t\tkind: value.kind,\n\t\tmediaType: value.mediaType,\n\t\t...(typeof value.sizeBytes === \"number\" ? { sizeBytes: value.sizeBytes } : {}),\n\t\ttruncated: value.truncated,\n\t\tcreatedAt: value.createdAt,\n\t};\n}\n\nexport function createHostOutputSerializer(): HostOutputSerializerV1 {\n\treturn {\n\t\tproject(input, context) {\n\t\t\tif (context.policyVersion.trim().length === 0) {\n\t\t\t\treturn {\n\t\t\t\t\ttext: \"\",\n\t\t\t\t\tdiagnostics: [\"output_projection_rejected: policyVersion must be a non-empty string\"],\n\t\t\t\t\trejected: { code: \"output_projection_rejected\", reason: \"policyVersion must be a non-empty string\" },\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst redactions: string[] = [];\n\t\t\tconst diagnostics: string[] = [];\n\t\t\tconst artifacts: OutputArtifactRefV1[] = [];\n\t\t\tconst showInternal = context.surface === \"inspector\" && context.inspectorAuthorized;\n\t\t\t// §5.4 requires building the field allowlist FIRST — the renderer can\n\t\t\t// only ever see allowlisted facts, so no fallback path can leak.\n\t\t\tconst isAllowedKey = (key: string): boolean => !INTERNAL_FIELD_KEYS.includes(key) || showInternal;\n\n\t\t\tconst renderValue = (key: string, value: unknown, path: string): string => {\n\t\t\t\tif (!isAllowedKey(key)) {\n\t\t\t\t\tredactions.push(`${path}.${key}`);\n\t\t\t\t\treturn `[redacted:${key}]`;\n\t\t\t\t}\n\t\t\t\tif (isArtifactLike(value)) {\n\t\t\t\t\tconst ref = toArtifactRef(value);\n\t\t\t\t\tif (ref) {\n\t\t\t\t\t\tartifacts.push(ref);\n\t\t\t\t\t\treturn `[artifact:${ref.artifactId}]`;\n\t\t\t\t\t}\n\t\t\t\t\tdiagnostics.push(`output_projection_rejected: ${path}.${key} is a malformed artifact reference`);\n\t\t\t\t\treturn `[unrenderable:${key}]`;\n\t\t\t\t}\n\t\t\t\tif (typeof value === \"string\") return value;\n\t\t\t\tif (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n\t\t\t\tif (value === null) return \"null\";\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tconst rendered = value.map((item) => renderValue(key, item, path));\n\t\t\t\t\treturn `[${rendered.join(\", \")}]`;\n\t\t\t\t}\n\t\t\t\tif (typeof value === \"object\") {\n\t\t\t\t\tconst rendered = Object.entries(value)\n\t\t\t\t\t\t.map(\n\t\t\t\t\t\t\t([nestedKey, nestedValue]) =>\n\t\t\t\t\t\t\t\t`${nestedKey}:${renderValue(nestedKey, nestedValue, `${path}.${key}`)}`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.join(\", \");\n\t\t\t\t\treturn `{${rendered}}`;\n\t\t\t\t}\n\t\t\t\tdiagnostics.push(`output_projection_rejected: ${path}.${key} cannot be serialized`);\n\t\t\t\treturn `[unrenderable:${key}]`;\n\t\t\t};\n\n\t\t\tconst textParts: string[] = [];\n\t\t\tfor (const [key, value] of Object.entries(input)) {\n\t\t\t\tif (key === \"artifacts\" && Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\tif (isArtifactLike(entry)) {\n\t\t\t\t\t\t\tconst ref = toArtifactRef(entry);\n\t\t\t\t\t\t\tif (ref) artifacts.push(ref);\n\t\t\t\t\t\t\telse diagnostics.push(\"output_projection_rejected: artifacts entry is malformed\");\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tdiagnostics.push(\"output_projection_rejected: artifacts entry is malformed\");\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\ttextParts.push(`${key}=${renderValue(key, value, \"root\")}`);\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\ttext: textParts.join(\"\\n\"),\n\t\t\t\t...(artifacts.length > 0 ? { artifacts: Object.freeze(artifacts) } : {}),\n\t\t\t\t...(redactions.length > 0 ? { redactions: Object.freeze([...redactions]) } : {}),\n\t\t\t\t...(diagnostics.length > 0 ? { diagnostics: Object.freeze([...diagnostics]) } : {}),\n\t\t\t};\n\t\t},\n\t};\n}\n"]}