@diyor28/context 1.0.0

package/dist/builder/context-fork.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * ContextFork: Create sub-agent contexts with sensitivity enforcement.
+ *
+ * Enables forking contexts for sub-agents with automatic sensitivity redaction,
+ * budget overrides, and schema-enforced output validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextFork = void 0;
+exports.filterBySensitivity = filterBySensitivity;
+exports.computeExecutionHash = computeExecutionHash;
+exports.computeSchemaHash = computeSchemaHash;
+const crypto_1 = require("crypto");
+const redacted_stub_codec_js_1 = require("../codecs/redacted-stub.codec.js");
+const hash_js_1 = require("../types/hash.js");
+/**
+ * Sensitivity level ordering (for comparison).
+ */
+const SENSITIVITY_ORDER = {
+    public: 0,
+    internal: 1,
+    restricted: 2,
+};
+/**
+ * Check if a sensitivity level exceeds the maximum allowed level.
+ *
+ * @param level - Sensitivity level to check
+ * @param maxLevel - Maximum allowed level
+ * @returns True if level exceeds maxLevel
+ */
+function exceedsSensitivityLevel(level, maxLevel) {
+    return SENSITIVITY_ORDER[level] > SENSITIVITY_ORDER[maxLevel];
+}
+/**
+ * Create a redacted stub block for sensitive content.
+ *
+ * @param originalBlock - Original block to redact
+ * @param reason - Redaction reason
+ * @returns Redacted stub block
+ */
+function createRedactedStub(originalBlock, reason) {
+    const payload = {
+        originalBlockHash: originalBlock.blockHash,
+        reason,
+        placeholder: '[REDACTED - Sensitive content removed]',
+    };
+    const meta = {
+        kind: originalBlock.meta.kind,
+        sensitivity: 'public',
+        codecId: redacted_stub_codec_js_1.RedactedStubCodec.codecId,
+        codecVersion: redacted_stub_codec_js_1.RedactedStubCodec.version,
+        createdAt: Math.floor(Date.now() / 1000),
+        source: originalBlock.meta.source,
+        tags: originalBlock.meta.tags,
+    };
+    const blockHash = (0, hash_js_1.computeBlockHash)(meta, payload, redacted_stub_codec_js_1.RedactedStubCodec);
+    return {
+        blockHash,
+        meta,
+        payload,
+    };
+}
+/**
+ * Filter view blocks by sensitivity level.
+ * Blocks exceeding maxSensitivity are replaced with redacted stubs.
+ *
+ * @param view - Source context view
+ * @param maxSensitivity - Maximum allowed sensitivity level
+ * @returns Filtered blocks with redacted stubs
+ */
+function filterBySensitivity(view, maxSensitivity) {
+    return view.blocks.map((block) => {
+        if (exceedsSensitivityLevel(block.meta.sensitivity, maxSensitivity)) {
+            return createRedactedStub(block, `Sensitivity level '${block.meta.sensitivity}' exceeds maximum '${maxSensitivity}'`);
+        }
+        return block;
+    });
+}
+/**
+ * Compute deterministic execution hash.
+ * Hash includes: model + compiledViewHash + instruction + schemaHash + toolsetVersion
+ *
+ * @param model - Model reference
+ * @param viewHash - Compiled view hash
+ * @param instruction - Task instruction
+ * @param schemaHash - Output schema hash
+ * @param toolsetVersion - Toolset version (optional)
+ * @returns Hex-encoded SHA-256 hash
+ */
+function computeExecutionHash(model, viewHash, instruction, schemaHash, toolsetVersion) {
+    const combined = {
+        model: `${model.provider}:${model.model}`,
+        viewHash,
+        instruction,
+        schemaHash,
+        toolsetVersion: toolsetVersion ?? 'none',
+    };
+    return (0, crypto_1.createHash)('sha256')
+        .update(JSON.stringify(combined))
+        .digest('hex');
+}
+/**
+ * Compute schema hash for deterministic execution tracking.
+ *
+ * @param schema - Zod schema
+ * @returns Hex-encoded SHA-256 hash
+ */
+function computeSchemaHash(schema) {
+    // Use schema description for hashing (simplified approach)
+    // In production, you'd want to serialize the schema structure
+    const schemaDesc = schema.description ?? JSON.stringify(schema._def);
+    return (0, crypto_1.createHash)('sha256')
+        .update(schemaDesc)
+        .digest('hex');
+}
+/**
+ * ContextFork: Create sub-agent contexts with sensitivity enforcement.
+ */
+class ContextFork {
+    graph;
+    parentView;
+    constructor(graph, parentView) {
+        this.graph = graph;
+        this.parentView = parentView;
+    }
+    /**
+     * Create a fork with sensitivity filtering and budget override.
+     *
+     * @param options - Fork options
+     * @returns Filtered context view for sub-agent
+     */
+    async createFork(options) {
+        const maxSensitivity = options.maxSensitivity ?? 'public';
+        // Filter blocks by sensitivity
+        const filteredBlocks = filterBySensitivity(this.parentView, maxSensitivity);
+        // Apply additional filters based on options
+        let finalBlocks = filteredBlocks;
+        if (!options.includeHistory) {
+            finalBlocks = finalBlocks.filter((block) => block.meta.kind !== 'history');
+        }
+        if (!options.includeState) {
+            finalBlocks = finalBlocks.filter((block) => block.meta.kind !== 'state');
+        }
+        // Create new view with filtered blocks
+        // Re-compute stable prefix hash
+        const stablePrefixHash = (0, crypto_1.createHash)('sha256')
+            .update(finalBlocks.map((b) => b.blockHash).join('|'))
+            .digest('hex');
+        const forkedView = {
+            blocks: finalBlocks,
+            stablePrefixHash,
+            createdAt: Math.floor(Date.now() / 1000),
+            tokenEstimate: options.budgetOverride
+                ? { tokens: options.budgetOverride, confidence: 'high', truncated: false }
+                : this.parentView.tokenEstimate,
+        };
+        return forkedView;
+    }
+    /**
+     * Execute a sub-agent task with schema validation.
+     *
+     * @param task - Sub-agent task definition
+     * @param options - Fork options
+     * @param executor - Async executor function (calls LLM)
+     * @returns Fork result with validated output
+     */
+    async executeFork(task, options, executor) {
+        const forkedAt = Math.floor(Date.now() / 1000);
+        // Create fork
+        const forkedView = await this.createFork(options);
+        // Validate forbidden fields
+        if (task.forbiddenFields && task.forbiddenFields.length > 0) {
+            // Add validation to instruction
+            const forbiddenFieldsNote = `\n\nIMPORTANT: Your output MUST NOT include these fields: ${task.forbiddenFields.join(', ')}`;
+            const enhancedInstruction = task.instruction + forbiddenFieldsNote;
+            // Execute with enhanced instruction
+            const executionResult = await executor(enhancedInstruction, forkedView);
+            // Validate output against schema
+            const validatedOutput = task.expectedOutputSchema.parse(executionResult.output);
+            // Check for forbidden fields in output
+            const outputStr = JSON.stringify(validatedOutput);
+            for (const field of task.forbiddenFields) {
+                if (outputStr.includes(field)) {
+                    throw new Error(`Fork execution failed: Output contains forbidden field '${field}'`);
+                }
+            }
+            const completedAt = Math.floor(Date.now() / 1000);
+            // Compute execution hash
+            const schemaHash = computeSchemaHash(task.expectedOutputSchema);
+            const executionHash = computeExecutionHash(options.model, forkedView.stablePrefixHash, task.instruction, schemaHash);
+            return {
+                agentId: options.agentId,
+                model: options.model,
+                summary: executionResult.summary,
+                output: validatedOutput,
+                artifacts: executionResult.artifacts,
+                citations: executionResult.citations,
+                usage: executionResult.usage,
+                provenance: {
+                    sourceViewHash: this.parentView.stablePrefixHash,
+                    executionHash,
+                    forkedAt,
+                    completedAt,
+                },
+            };
+        }
+        else {
+            // Execute without forbidden field validation
+            const executionResult = await executor(task.instruction, forkedView);
+            // Validate output against schema
+            const validatedOutput = task.expectedOutputSchema.parse(executionResult.output);
+            const completedAt = Math.floor(Date.now() / 1000);
+            // Compute execution hash
+            const schemaHash = computeSchemaHash(task.expectedOutputSchema);
+            const executionHash = computeExecutionHash(options.model, forkedView.stablePrefixHash, task.instruction, schemaHash);
+            return {
+                agentId: options.agentId,
+                model: options.model,
+                summary: executionResult.summary,
+                output: validatedOutput,
+                artifacts: executionResult.artifacts,
+                citations: executionResult.citations,
+                usage: executionResult.usage,
+                provenance: {
+                    sourceViewHash: this.parentView.stablePrefixHash,
+                    executionHash,
+                    forkedAt,
+                    completedAt,
+                },
+            };
+        }
+    }
+    /**
+     * Ingest fork result back into parent graph.
+     * Adds result as a memory block with provenance tracking.
+     *
+     * @param result - Fork result to ingest
+     * @param asMemory - Add as memory block (default: true)
+     * @returns Block hash of ingested result
+     */
+    ingestForkResult(result, asMemory = true) {
+        // Create a structured reference block for the fork result
+        // This would use a codec designed for fork results
+        // For now, we'll use a simplified approach
+        const payload = {
+            agentId: result.agentId,
+            model: result.model,
+            summary: result.summary,
+            output: result.output,
+            artifacts: result.artifacts,
+            citations: result.citations,
+            usage: result.usage,
+            provenance: result.provenance,
+        };
+        const meta = {
+            kind: asMemory ? 'memory' : 'reference',
+            sensitivity: 'public',
+            codecId: 'fork-result',
+            codecVersion: '1.0.0',
+            createdAt: Math.floor(Date.now() / 1000),
+            source: result.agentId,
+            tags: ['fork-result', result.model.provider],
+        };
+        // Compute block hash (without codec for now)
+        const blockHash = (0, crypto_1.createHash)('sha256')
+            .update(JSON.stringify({ meta, payload }))
+            .digest('hex');
+        const block = {
+            blockHash,
+            meta,
+            payload,
+        };
+        // Add to graph with provenance
+        const derivedFrom = result.citations
+            ? result.citations.map((hash) => ({ blockHash: hash }))
+            : [];
+        this.graph.addBlock(block, derivedFrom);
+        return blockHash;
+    }
+}
+exports.ContextFork = ContextFork;
+//# sourceMappingURL=context-fork.js.map

package/dist/builder/context-fork.js.map

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

package/dist/builder/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Context builder exports.
+ */
+export * from './context-builder.js';
+export * from './context-fork.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/builder/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Context builder exports.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./context-builder.js"), exports);
+__exportStar(require("./context-fork.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,oDAAkC"}

package/dist/codecs/base.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Base codec utilities.
+ */
+/**
+ * Default hash implementation: SHA-256 of JSON.stringify(canonicalized).
+ *
+ * @param canonicalized - Canonicalized payload
+ * @returns Hex-encoded SHA-256 hash
+ */
+export declare function defaultHash(canonicalized: unknown): string;
+/**
+ * Sort object keys for deterministic serialization.
+ *
+ * @param obj - Object to sort
+ * @returns Object with sorted keys
+ */
+export declare function sortObjectKeys(obj: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=base.d.ts.map

package/dist/codecs/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/codecs/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,CAI1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWpF"}

package/dist/codecs/base.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Base codec utilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultHash = defaultHash;
+exports.sortObjectKeys = sortObjectKeys;
+const crypto_1 = require("crypto");
+/**
+ * Default hash implementation: SHA-256 of JSON.stringify(canonicalized).
+ *
+ * @param canonicalized - Canonicalized payload
+ * @returns Hex-encoded SHA-256 hash
+ */
+function defaultHash(canonicalized) {
+    return (0, crypto_1.createHash)('sha256')
+        .update(JSON.stringify(canonicalized))
+        .digest('hex');
+}
+/**
+ * Sort object keys for deterministic serialization.
+ *
+ * @param obj - Object to sort
+ * @returns Object with sorted keys
+ */
+function sortObjectKeys(obj) {
+    const sorted = {};
+    for (const key of Object.keys(obj).sort()) {
+        const value = obj[key];
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            sorted[key] = sortObjectKeys(value);
+        }
+        else {
+            sorted[key] = value;
+        }
+    }
+    return sorted;
+}
+//# sourceMappingURL=base.js.map

package/dist/codecs/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/codecs/base.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAUH,kCAIC;AAQD,wCAWC;AA/BD,mCAAoC;AAEpC;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,aAAsB;IAChD,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;SACrC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,GAA4B;IACzD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAgC,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/codecs/conversation-history.codec.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Conversation history codec (kind: 'history').
+ *
+ * Previous turns in conversation.
+ */
+import { z } from 'zod';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * Conversation message schema.
+ */
+export declare const ConversationMessageSchema: z.ZodObject<{
+    /** Message role */
+    role: z.ZodEnum<["user", "assistant"]>;
+    /** Message content (text or structured) */
+    content: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">]>;
+    /** Optional message ID */
+    messageId: z.ZodOptional<z.ZodString>;
+    /** Optional timestamp */
+    timestamp: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    content: string | Record<string, unknown>[];
+    role: "user" | "assistant";
+    messageId?: string | undefined;
+    timestamp?: number | undefined;
+}, {
+    content: string | Record<string, unknown>[];
+    role: "user" | "assistant";
+    messageId?: string | undefined;
+    timestamp?: number | undefined;
+}>;
+export type ConversationMessage = z.infer<typeof ConversationMessageSchema>;
+/**
+ * Conversation history payload schema.
+ */
+export declare const ConversationHistoryPayloadSchema: z.ZodObject<{
+    /** Array of messages */
+    messages: z.ZodArray<z.ZodObject<{
+        /** Message role */
+        role: z.ZodEnum<["user", "assistant"]>;
+        /** Message content (text or structured) */
+        content: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">]>;
+        /** Optional message ID */
+        messageId: z.ZodOptional<z.ZodString>;
+        /** Optional timestamp */
+        timestamp: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        content: string | Record<string, unknown>[];
+        role: "user" | "assistant";
+        messageId?: string | undefined;
+        timestamp?: number | undefined;
+    }, {
+        content: string | Record<string, unknown>[];
+        role: "user" | "assistant";
+        messageId?: string | undefined;
+        timestamp?: number | undefined;
+    }>, "many">;
+    /** Optional summary of earlier messages */
+    summary: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    messages: {
+        content: string | Record<string, unknown>[];
+        role: "user" | "assistant";
+        messageId?: string | undefined;
+        timestamp?: number | undefined;
+    }[];
+    summary?: string | undefined;
+}, {
+    messages: {
+        content: string | Record<string, unknown>[];
+        role: "user" | "assistant";
+        messageId?: string | undefined;
+        timestamp?: number | undefined;
+    }[];
+    summary?: string | undefined;
+}>;
+export type ConversationHistoryPayload = z.infer<typeof ConversationHistoryPayloadSchema>;
+/**
+ * Conversation history codec implementation.
+ */
+export declare const ConversationHistoryCodec: BlockCodec<ConversationHistoryPayload>;
+//# sourceMappingURL=conversation-history.codec.d.ts.map

package/dist/codecs/conversation-history.codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.codec.d.ts","sourceRoot":"","sources":["../../src/codecs/conversation-history.codec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AAIrE;;GAEG;AACH,eAAO,MAAM,yBAAyB;IACpC,mBAAmB;;IAGnB,2CAA2C;;IAM3C,0BAA0B;;IAG1B,yBAAyB;;;;;;;;;;;;EAEzB,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,gCAAgC;IAC3C,wBAAwB;;QAtBxB,mBAAmB;;QAGnB,2CAA2C;;QAM3C,0BAA0B;;QAG1B,yBAAyB;;;;;;;;;;;;;IAazB,2CAA2C;;;;;;;;;;;;;;;;;;EAE3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAAU,CAAC,0BAA0B,CA0D3E,CAAC"}

package/dist/codecs/conversation-history.codec.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Conversation history codec (kind: 'history').
+ *
+ * Previous turns in conversation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationHistoryCodec = exports.ConversationHistoryPayloadSchema = exports.ConversationMessageSchema = void 0;
+const zod_1 = require("zod");
+const base_js_1 = require("./base.js");
+/**
+ * Conversation message schema.
+ */
+exports.ConversationMessageSchema = zod_1.z.object({
+    /** Message role */
+    role: zod_1.z.enum(['user', 'assistant']),
+    /** Message content (text or structured) */
+    content: zod_1.z.union([
+        zod_1.z.string(),
+        zod_1.z.array(zod_1.z.record(zod_1.z.unknown())),
+    ]),
+    /** Optional message ID */
+    messageId: zod_1.z.string().optional(),
+    /** Optional timestamp */
+    timestamp: zod_1.z.number().optional(),
+});
+/**
+ * Conversation history payload schema.
+ */
+exports.ConversationHistoryPayloadSchema = zod_1.z.object({
+    /** Array of messages */
+    messages: zod_1.z.array(exports.ConversationMessageSchema),
+    /** Optional summary of earlier messages */
+    summary: zod_1.z.string().optional(),
+});
+/**
+ * Conversation history codec implementation.
+ */
+exports.ConversationHistoryCodec = {
+    codecId: 'conversation-history',
+    version: '1.0.0',
+    payloadSchema: exports.ConversationHistoryPayloadSchema,
+    canonicalize(payload) {
+        // Canonicalize messages (exclude volatile fields like timestamp)
+        const canonicalMessages = payload.messages.map((msg) => ({
+            role: msg.role,
+            content: msg.content,
+        }));
+        return (0, base_js_1.sortObjectKeys)({
+            messages: canonicalMessages,
+            summary: payload.summary ?? null,
+        });
+    },
+    hash(canonicalized) {
+        return (0, base_js_1.defaultHash)(canonicalized);
+    },
+    render(block) {
+        const { messages, summary } = block.payload;
+        // Add summary as first message if present
+        const allMessages = summary
+            ? [{ role: 'user', content: `**Earlier conversation (summary):**\n${summary}` }, ...messages]
+            : messages;
+        return {
+            // Anthropic: messages array
+            anthropic: allMessages.map((msg) => ({
+                role: msg.role,
+                content: typeof msg.content === 'string'
+                    ? msg.content
+                    : msg.content,
+            })),
+            // OpenAI: messages array
+            openai: allMessages.map((msg) => ({
+                role: msg.role,
+                content: msg.content,
+            })),
+            // Gemini: convert to user/model role
+            gemini: allMessages.map((msg) => ({
+                role: msg.role === 'assistant' ? 'model' : 'user',
+                parts: typeof msg.content === 'string'
+                    ? [{ text: msg.content }]
+                    : msg.content,
+            })),
+        };
+    },
+    validate(payload) {
+        return exports.ConversationHistoryPayloadSchema.parse(payload);
+    },
+};
+//# sourceMappingURL=conversation-history.codec.js.map

package/dist/codecs/conversation-history.codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.codec.js","sourceRoot":"","sources":["../../src/codecs/conversation-history.codec.ts"],"names":[],"mappings":"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"}

package/dist/codecs/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Built-in codecs for @foundry/context
+ */
+export * from './base.js';
+export * from './system-rules.codec.js';
+export * from './tool-schema.codec.js';
+export * from './structured-reference.codec.js';
+export * from './conversation-history.codec.js';
+export * from './tool-output.codec.js';
+export * from './redacted-stub.codec.js';
+export * from './unsafe-text.codec.js';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * Built-in codec registry.
+ * Maps codecId -> codec implementation.
+ */
+export declare const BUILT_IN_CODECS: Record<string, BlockCodec>;
+/**
+ * Get codec by ID.
+ *
+ * @param codecId - Codec identifier
+ * @returns Codec implementation, or undefined if not found
+ */
+export declare function getCodec(codecId: string): BlockCodec | undefined;
+/**
+ * Register custom codec.
+ *
+ * @param codec - Custom codec implementation
+ */
+export declare function registerCodec(codec: BlockCodec): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codecs/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AASpD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAQtD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAKrD"}