@diyor28/context 1.0.0

package/dist/codecs/index.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Built-in codecs for @foundry/context
+ */
+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 });
+exports.BUILT_IN_CODECS = void 0;
+exports.getCodec = getCodec;
+exports.registerCodec = registerCodec;
+__exportStar(require("./base.js"), exports);
+__exportStar(require("./system-rules.codec.js"), exports);
+__exportStar(require("./tool-schema.codec.js"), exports);
+__exportStar(require("./structured-reference.codec.js"), exports);
+__exportStar(require("./conversation-history.codec.js"), exports);
+__exportStar(require("./tool-output.codec.js"), exports);
+__exportStar(require("./redacted-stub.codec.js"), exports);
+__exportStar(require("./unsafe-text.codec.js"), exports);
+const system_rules_codec_js_1 = require("./system-rules.codec.js");
+const tool_schema_codec_js_1 = require("./tool-schema.codec.js");
+const structured_reference_codec_js_1 = require("./structured-reference.codec.js");
+const conversation_history_codec_js_1 = require("./conversation-history.codec.js");
+const tool_output_codec_js_1 = require("./tool-output.codec.js");
+const redacted_stub_codec_js_1 = require("./redacted-stub.codec.js");
+const unsafe_text_codec_js_1 = require("./unsafe-text.codec.js");
+/**
+ * Built-in codec registry.
+ * Maps codecId -> codec implementation.
+ */
+exports.BUILT_IN_CODECS = {
+    'system-rules': system_rules_codec_js_1.SystemRulesCodec,
+    'tool-schema': tool_schema_codec_js_1.ToolSchemaCodec,
+    'structured-reference': structured_reference_codec_js_1.StructuredReferenceCodec,
+    'conversation-history': conversation_history_codec_js_1.ConversationHistoryCodec,
+    'tool-output': tool_output_codec_js_1.ToolOutputCodec,
+    'redacted-stub': redacted_stub_codec_js_1.RedactedStubCodec,
+    'unsafe-text': unsafe_text_codec_js_1.UnsafeTextCodec,
+};
+/**
+ * Get codec by ID.
+ *
+ * @param codecId - Codec identifier
+ * @returns Codec implementation, or undefined if not found
+ */
+function getCodec(codecId) {
+    return exports.BUILT_IN_CODECS[codecId];
+}
+/**
+ * Register custom codec.
+ *
+ * @param codec - Custom codec implementation
+ */
+function registerCodec(codec) {
+    if (exports.BUILT_IN_CODECS[codec.codecId]) {
+        throw new Error(`Codec already registered: ${codec.codecId}`);
+    }
+    exports.BUILT_IN_CODECS[codec.codecId] = codec;
+}
+//# sourceMappingURL=index.js.map

package/dist/codecs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codecs/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAwCH,4BAEC;AAOD,sCAKC;AApDD,4CAA0B;AAC1B,0DAAwC;AACxC,yDAAuC;AACvC,kEAAgD;AAChD,kEAAgD;AAChD,yDAAuC;AACvC,2DAAyC;AACzC,yDAAuC;AAGvC,mEAA2D;AAC3D,iEAAyD;AACzD,mFAA2E;AAC3E,mFAA2E;AAC3E,iEAAyD;AACzD,qEAA6D;AAC7D,iEAAyD;AAEzD;;;GAGG;AACU,QAAA,eAAe,GAA+B;IACzD,cAAc,EAAE,wCAAgB;IAChC,aAAa,EAAE,sCAAe;IAC9B,sBAAsB,EAAE,wDAAwB;IAChD,sBAAsB,EAAE,wDAAwB;IAChD,aAAa,EAAE,sCAAe;IAC9B,eAAe,EAAE,0CAAiB;IAClC,aAAa,EAAE,sCAAe;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,OAAe;IACtC,OAAO,uBAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,KAAiB;IAC7C,IAAI,uBAAe,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,uBAAe,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;AACzC,CAAC"}

package/dist/codecs/redacted-stub.codec.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Redacted stub codec (any kind).
+ *
+ * Placeholder for sensitive content that was removed.
+ */
+import { z } from 'zod';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * Redacted stub payload schema.
+ */
+export declare const RedactedStubPayloadSchema: z.ZodObject<{
+    /** Original block hash (for reference) */
+    originalBlockHash: z.ZodString;
+    /** Reason for redaction */
+    reason: z.ZodString;
+    /** Optional placeholder text */
+    placeholder: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    originalBlockHash: string;
+    reason: string;
+    placeholder?: string | undefined;
+}, {
+    originalBlockHash: string;
+    reason: string;
+    placeholder?: string | undefined;
+}>;
+export type RedactedStubPayload = z.infer<typeof RedactedStubPayloadSchema>;
+/**
+ * Redacted stub codec implementation.
+ */
+export declare const RedactedStubCodec: BlockCodec<RedactedStubPayload>;
+//# sourceMappingURL=redacted-stub.codec.d.ts.map

package/dist/codecs/redacted-stub.codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redacted-stub.codec.d.ts","sourceRoot":"","sources":["../../src/codecs/redacted-stub.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,0CAA0C;;IAG1C,2BAA2B;;IAG3B,gCAAgC;;;;;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,CAAC,mBAAmB,CA6C7D,CAAC"}

package/dist/codecs/redacted-stub.codec.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Redacted stub codec (any kind).
+ *
+ * Placeholder for sensitive content that was removed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedactedStubCodec = exports.RedactedStubPayloadSchema = void 0;
+const zod_1 = require("zod");
+const base_js_1 = require("./base.js");
+/**
+ * Redacted stub payload schema.
+ */
+exports.RedactedStubPayloadSchema = zod_1.z.object({
+    /** Original block hash (for reference) */
+    originalBlockHash: zod_1.z.string(),
+    /** Reason for redaction */
+    reason: zod_1.z.string(),
+    /** Optional placeholder text */
+    placeholder: zod_1.z.string().optional(),
+});
+/**
+ * Redacted stub codec implementation.
+ */
+exports.RedactedStubCodec = {
+    codecId: 'redacted-stub',
+    version: '1.0.0',
+    payloadSchema: exports.RedactedStubPayloadSchema,
+    canonicalize(payload) {
+        return (0, base_js_1.sortObjectKeys)({
+            originalBlockHash: payload.originalBlockHash,
+            reason: payload.reason,
+            placeholder: payload.placeholder ?? '[REDACTED]',
+        });
+    },
+    hash(canonicalized) {
+        return (0, base_js_1.defaultHash)(canonicalized);
+    },
+    render(block) {
+        const { placeholder, reason } = block.payload;
+        const text = `${placeholder ?? '[REDACTED]'}\n\n*Reason: ${reason}*`;
+        return {
+            // Anthropic: user message
+            anthropic: {
+                role: 'user',
+                content: [{ type: 'text', text }],
+            },
+            // OpenAI: user message
+            openai: {
+                role: 'user',
+                content: text,
+            },
+            // Gemini: user message
+            gemini: {
+                role: 'user',
+                parts: [{ text }],
+            },
+        };
+    },
+    validate(payload) {
+        return exports.RedactedStubPayloadSchema.parse(payload);
+    },
+};
+//# sourceMappingURL=redacted-stub.codec.js.map

package/dist/codecs/redacted-stub.codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redacted-stub.codec.js","sourceRoot":"","sources":["../../src/codecs/redacted-stub.codec.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6BAAwB;AAGxB,uCAAwD;AAExD;;GAEG;AACU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,0CAA0C;IAC1C,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE;IAE7B,2BAA2B;IAC3B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAElB,gCAAgC;IAChC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,iBAAiB,GAAoC;IAChE,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,OAAO;IAChB,aAAa,EAAE,iCAAyB;IAExC,YAAY,CAAC,OAA4B;QACvC,OAAO,IAAA,wBAAc,EAAC;YACpB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY;SACjD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,aAAsB;QACzB,OAAO,IAAA,qBAAW,EAAC,aAAa,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,KAAwC;QAC7C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9C,MAAM,IAAI,GAAG,GAAG,WAAW,IAAI,YAAY,gBAAgB,MAAM,GAAG,CAAC;QAErE,OAAO;YACL,0BAA0B;YAC1B,SAAS,EAAE;gBACT,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;aAClC;YAED,uBAAuB;YACvB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,IAAI;aACd;YAED,uBAAuB;YACvB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;aAClB;SACF,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,OAAgB;QACvB,OAAO,iCAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;CACF,CAAC"}

package/dist/codecs/structured-reference.codec.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Structured reference codec (kind: 'reference').
+ *
+ * External documentation, code snippets, API responses.
+ */
+import { z } from 'zod';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * Structured reference payload schema.
+ */
+export declare const StructuredReferencePayloadSchema: z.ZodObject<{
+    /** Reference title */
+    title: z.ZodString;
+    /** Reference content (markdown, code, JSON, etc.) */
+    content: z.ZodString;
+    /** Optional source URL */
+    sourceUrl: z.ZodOptional<z.ZodString>;
+    /** Optional MIME type */
+    mimeType: z.ZodOptional<z.ZodString>;
+    /** Optional cache control hint */
+    cacheable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    content: string;
+    cacheable?: boolean | undefined;
+    sourceUrl?: string | undefined;
+    mimeType?: string | undefined;
+}, {
+    title: string;
+    content: string;
+    cacheable?: boolean | undefined;
+    sourceUrl?: string | undefined;
+    mimeType?: string | undefined;
+}>;
+export type StructuredReferencePayload = z.infer<typeof StructuredReferencePayloadSchema>;
+/**
+ * Structured reference codec implementation.
+ */
+export declare const StructuredReferenceCodec: BlockCodec<StructuredReferencePayload>;
+//# sourceMappingURL=structured-reference.codec.d.ts.map

package/dist/codecs/structured-reference.codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-reference.codec.d.ts","sourceRoot":"","sources":["../../src/codecs/structured-reference.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,gCAAgC;IAC3C,sBAAsB;;IAGtB,qDAAqD;;IAGrD,0BAA0B;;IAG1B,yBAAyB;;IAGzB,kCAAkC;;;;;;;;;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAAU,CAAC,0BAA0B,CA2D3E,CAAC"}

package/dist/codecs/structured-reference.codec.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Structured reference codec (kind: 'reference').
+ *
+ * External documentation, code snippets, API responses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StructuredReferenceCodec = exports.StructuredReferencePayloadSchema = void 0;
+const zod_1 = require("zod");
+const base_js_1 = require("./base.js");
+/**
+ * Structured reference payload schema.
+ */
+exports.StructuredReferencePayloadSchema = zod_1.z.object({
+    /** Reference title */
+    title: zod_1.z.string(),
+    /** Reference content (markdown, code, JSON, etc.) */
+    content: zod_1.z.string(),
+    /** Optional source URL */
+    sourceUrl: zod_1.z.string().optional(),
+    /** Optional MIME type */
+    mimeType: zod_1.z.string().optional(),
+    /** Optional cache control hint */
+    cacheable: zod_1.z.boolean().optional(),
+});
+/**
+ * Structured reference codec implementation.
+ */
+exports.StructuredReferenceCodec = {
+    codecId: 'structured-reference',
+    version: '1.0.0',
+    payloadSchema: exports.StructuredReferencePayloadSchema,
+    canonicalize(payload) {
+        return (0, base_js_1.sortObjectKeys)({
+            title: payload.title.trim(),
+            content: payload.content,
+            sourceUrl: payload.sourceUrl ?? null,
+            mimeType: payload.mimeType ?? null,
+            cacheable: payload.cacheable ?? false,
+        });
+    },
+    hash(canonicalized) {
+        return (0, base_js_1.defaultHash)(canonicalized);
+    },
+    render(block) {
+        const { title, content, sourceUrl, cacheable } = block.payload;
+        // Format as markdown with optional source
+        const formattedContent = [
+            `# ${title}`,
+            sourceUrl ? `\n*Source: ${sourceUrl}*\n` : '',
+            content,
+        ].join('\n');
+        return {
+            // Anthropic: user message with optional cache control
+            anthropic: {
+                role: 'user',
+                content: [
+                    {
+                        type: 'text',
+                        text: formattedContent,
+                        ...(cacheable && { cache_control: { type: 'ephemeral' } }),
+                    },
+                ],
+            },
+            // OpenAI: user message
+            openai: {
+                role: 'user',
+                content: formattedContent,
+            },
+            // Gemini: user message
+            gemini: {
+                role: 'user',
+                parts: [{ text: formattedContent }],
+            },
+        };
+    },
+    validate(payload) {
+        return exports.StructuredReferencePayloadSchema.parse(payload);
+    },
+};
+//# sourceMappingURL=structured-reference.codec.js.map

package/dist/codecs/structured-reference.codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-reference.codec.js","sourceRoot":"","sources":["../../src/codecs/structured-reference.codec.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6BAAwB;AAGxB,uCAAwD;AAExD;;GAEG;AACU,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACvD,sBAAsB;IACtB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IAEjB,qDAAqD;IACrD,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IAEnB,0BAA0B;IAC1B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEhC,yBAAyB;IACzB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,kCAAkC;IAClC,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,wBAAwB,GAA2C;IAC9E,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,OAAO;IAChB,aAAa,EAAE,wCAAgC;IAE/C,YAAY,CAAC,OAAmC;QAC9C,OAAO,IAAA,wBAAc,EAAC;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;YACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;SACtC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,aAAsB;QACzB,OAAO,IAAA,qBAAW,EAAC,aAAa,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,KAA+C;QACpD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QAE/D,0CAA0C;QAC1C,MAAM,gBAAgB,GAAG;YACvB,KAAK,KAAK,EAAE;YACZ,SAAS,CAAC,CAAC,CAAC,cAAc,SAAS,KAAK,CAAC,CAAC,CAAC,EAAE;YAC7C,OAAO;SACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL,sDAAsD;YACtD,SAAS,EAAE;gBACT,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,gBAAgB;wBACtB,GAAG,CAAC,SAAS,IAAI,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;qBAC3D;iBACF;aACF;YAED,uBAAuB;YACvB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,gBAAgB;aAC1B;YAED,uBAAuB;YACvB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;aACpC;SACF,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,OAAgB;QACvB,OAAO,wCAAgC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;CACF,CAAC"}

package/dist/codecs/system-rules.codec.d.ts

@@ -0,0 +1,32 @@
+/**
+ * System rules codec (kind: 'pinned').
+ *
+ * System-level instructions and constraints.
+ */
+import { z } from 'zod';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * System rules payload schema.
+ */
+export declare const SystemRulesPayloadSchema: z.ZodObject<{
+    /** System rules text */
+    text: z.ZodString;
+    /** Optional priority (higher = more important) */
+    priority: z.ZodOptional<z.ZodNumber>;
+    /** Optional cache control hint */
+    cacheable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    priority?: number | undefined;
+    cacheable?: boolean | undefined;
+}, {
+    text: string;
+    priority?: number | undefined;
+    cacheable?: boolean | undefined;
+}>;
+export type SystemRulesPayload = z.infer<typeof SystemRulesPayloadSchema>;
+/**
+ * System rules codec implementation.
+ */
+export declare const SystemRulesCodec: BlockCodec<SystemRulesPayload>;
+//# sourceMappingURL=system-rules.codec.d.ts.map

package/dist/codecs/system-rules.codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-rules.codec.d.ts","sourceRoot":"","sources":["../../src/codecs/system-rules.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,wBAAwB;IACnC,wBAAwB;;IAGxB,kDAAkD;;IAGlD,kCAAkC;;;;;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC,kBAAkB,CA2C3D,CAAC"}

package/dist/codecs/system-rules.codec.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * System rules codec (kind: 'pinned').
+ *
+ * System-level instructions and constraints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemRulesCodec = exports.SystemRulesPayloadSchema = void 0;
+const zod_1 = require("zod");
+const base_js_1 = require("./base.js");
+/**
+ * System rules payload schema.
+ */
+exports.SystemRulesPayloadSchema = zod_1.z.object({
+    /** System rules text */
+    text: zod_1.z.string(),
+    /** Optional priority (higher = more important) */
+    priority: zod_1.z.number().optional(),
+    /** Optional cache control hint */
+    cacheable: zod_1.z.boolean().optional(),
+});
+/**
+ * System rules codec implementation.
+ */
+exports.SystemRulesCodec = {
+    codecId: 'system-rules',
+    version: '1.0.0',
+    payloadSchema: exports.SystemRulesPayloadSchema,
+    canonicalize(payload) {
+        // Normalize whitespace and sort keys
+        return (0, base_js_1.sortObjectKeys)({
+            text: payload.text.trim(),
+            priority: payload.priority ?? 0,
+            cacheable: payload.cacheable ?? false,
+        });
+    },
+    hash(canonicalized) {
+        return (0, base_js_1.defaultHash)(canonicalized);
+    },
+    render(block) {
+        const { text, cacheable } = block.payload;
+        return {
+            // Anthropic: system message with optional cache control
+            anthropic: {
+                type: 'text',
+                text,
+                ...(cacheable && { cache_control: { type: 'ephemeral' } }),
+            },
+            // OpenAI: system message
+            openai: {
+                role: 'system',
+                content: text,
+            },
+            // Gemini: system instruction (string)
+            gemini: text,
+        };
+    },
+    validate(payload) {
+        return exports.SystemRulesPayloadSchema.parse(payload);
+    },
+};
+//# sourceMappingURL=system-rules.codec.js.map

package/dist/codecs/system-rules.codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-rules.codec.js","sourceRoot":"","sources":["../../src/codecs/system-rules.codec.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6BAAwB;AAGxB,uCAAwD;AAExD;;GAEG;AACU,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,wBAAwB;IACxB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAEhB,kDAAkD;IAClD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,kCAAkC;IAClC,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,gBAAgB,GAAmC;IAC9D,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,OAAO;IAChB,aAAa,EAAE,gCAAwB;IAEvC,YAAY,CAAC,OAA2B;QACtC,qCAAqC;QACrC,OAAO,IAAA,wBAAc,EAAC;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;YACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;YAC/B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;SACtC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,aAAsB;QACzB,OAAO,IAAA,qBAAW,EAAC,aAAa,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,KAAuC;QAC5C,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QAE1C,OAAO;YACL,wDAAwD;YACxD,SAAS,EAAE;gBACT,IAAI,EAAE,MAAM;gBACZ,IAAI;gBACJ,GAAG,CAAC,SAAS,IAAI,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;aAC3D;YAED,yBAAyB;YACzB,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YAED,sCAAsC;YACtC,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,OAAgB;QACvB,OAAO,gCAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;CACF,CAAC"}

package/dist/codecs/tool-output.codec.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Tool output codec (kind: 'tool_output').
+ *
+ * Results from tool execution.
+ */
+import { z } from 'zod';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * Tool output payload schema.
+ */
+export declare const ToolOutputPayloadSchema: z.ZodObject<{
+    /** Tool name */
+    toolName: z.ZodString;
+    /** Tool call ID (for correlation) */
+    toolCallId: z.ZodString;
+    /** Tool output (success or error) */
+    output: z.ZodUnion<[z.ZodObject<{
+        success: z.ZodLiteral<true>;
+        result: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        success: true;
+        result?: unknown;
+    }, {
+        success: true;
+        result?: unknown;
+    }>, z.ZodObject<{
+        success: z.ZodLiteral<false>;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        error: string;
+        success: false;
+    }, {
+        error: string;
+        success: false;
+    }>]>;
+    /** Execution duration (ms) */
+    durationMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    toolName: string;
+    toolCallId: string;
+    output: {
+        success: true;
+        result?: unknown;
+    } | {
+        error: string;
+        success: false;
+    };
+    durationMs?: number | undefined;
+}, {
+    toolName: string;
+    toolCallId: string;
+    output: {
+        success: true;
+        result?: unknown;
+    } | {
+        error: string;
+        success: false;
+    };
+    durationMs?: number | undefined;
+}>;
+export type ToolOutputPayload = z.infer<typeof ToolOutputPayloadSchema>;
+/**
+ * Tool output codec implementation.
+ */
+export declare const ToolOutputCodec: BlockCodec<ToolOutputPayload>;
+//# sourceMappingURL=tool-output.codec.d.ts.map

package/dist/codecs/tool-output.codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output.codec.d.ts","sourceRoot":"","sources":["../../src/codecs/tool-output.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,uBAAuB;IAClC,gBAAgB;;IAGhB,qCAAqC;;IAGrC,qCAAqC;;;;;;;;;;;;;;;;;;;;IAYrC,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,UAAU,CAAC,iBAAiB,CAkEzD,CAAC"}

package/dist/codecs/tool-output.codec.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Tool output codec (kind: 'tool_output').
+ *
+ * Results from tool execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolOutputCodec = exports.ToolOutputPayloadSchema = void 0;
+const zod_1 = require("zod");
+const base_js_1 = require("./base.js");
+/**
+ * Tool output payload schema.
+ */
+exports.ToolOutputPayloadSchema = zod_1.z.object({
+    /** Tool name */
+    toolName: zod_1.z.string(),
+    /** Tool call ID (for correlation) */
+    toolCallId: zod_1.z.string(),
+    /** Tool output (success or error) */
+    output: zod_1.z.union([
+        zod_1.z.object({
+            success: zod_1.z.literal(true),
+            result: zod_1.z.unknown(),
+        }),
+        zod_1.z.object({
+            success: zod_1.z.literal(false),
+            error: zod_1.z.string(),
+        }),
+    ]),
+    /** Execution duration (ms) */
+    durationMs: zod_1.z.number().optional(),
+});
+/**
+ * Tool output codec implementation.
+ */
+exports.ToolOutputCodec = {
+    codecId: 'tool-output',
+    version: '1.0.0',
+    payloadSchema: exports.ToolOutputPayloadSchema,
+    canonicalize(payload) {
+        return (0, base_js_1.sortObjectKeys)({
+            toolName: payload.toolName,
+            toolCallId: payload.toolCallId,
+            output: payload.output,
+            // Exclude durationMs from canonicalization (not content-relevant)
+        });
+    },
+    hash(canonicalized) {
+        return (0, base_js_1.defaultHash)(canonicalized);
+    },
+    render(block) {
+        const { toolName, toolCallId, output } = block.payload;
+        // Format output content
+        const contentText = output.success
+            ? JSON.stringify(output.result, null, 2)
+            : `Error: ${output.error}`;
+        return {
+            // Anthropic: user message with tool_result
+            anthropic: {
+                role: 'user',
+                content: [
+                    {
+                        type: 'tool_result',
+                        tool_use_id: toolCallId,
+                        content: contentText,
+                        is_error: !output.success,
+                    },
+                ],
+            },
+            // OpenAI: tool message
+            openai: {
+                role: 'tool',
+                tool_call_id: toolCallId,
+                name: toolName,
+                content: contentText,
+            },
+            // Gemini: user message with function response
+            gemini: {
+                role: 'user',
+                parts: [
+                    {
+                        functionResponse: {
+                            name: toolName,
+                            response: output.success ? output.result : { error: output.error },
+                        },
+                    },
+                ],
+            },
+        };
+    },
+    validate(payload) {
+        return exports.ToolOutputPayloadSchema.parse(payload);
+    },
+};
+//# sourceMappingURL=tool-output.codec.js.map

package/dist/codecs/tool-output.codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output.codec.js","sourceRoot":"","sources":["../../src/codecs/tool-output.codec.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6BAAwB;AAGxB,uCAAwD;AAExD;;GAEG;AACU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,gBAAgB;IAChB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IAEpB,qCAAqC;IACrC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;IAEtB,qCAAqC;IACrC,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC;QACd,OAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE;SACpB,CAAC;QACF,OAAC,CAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YACzB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;SAClB,CAAC;KACH,CAAC;IAEF,8BAA8B;IAC9B,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,eAAe,GAAkC;IAC5D,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,OAAO;IAChB,aAAa,EAAE,+BAAuB;IAEtC,YAAY,CAAC,OAA0B;QACrC,OAAO,IAAA,wBAAc,EAAC;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,kEAAkE;SACnE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,aAAsB;QACzB,OAAO,IAAA,qBAAW,EAAC,aAAa,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,KAAsC;QAC3C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QAEvD,wBAAwB;QACxB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO;YAChC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;QAE7B,OAAO;YACL,2CAA2C;YAC3C,SAAS,EAAE;gBACT,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,aAAa;wBACnB,WAAW,EAAE,UAAU;wBACvB,OAAO,EAAE,WAAW;wBACpB,QAAQ,EAAE,CAAC,MAAM,CAAC,OAAO;qBAC1B;iBACF;aACF;YAED,uBAAuB;YACvB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,YAAY,EAAE,UAAU;gBACxB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,WAAW;aACrB;YAED,8CAA8C;YAC9C,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE;oBACL;wBACE,gBAAgB,EAAE;4BAChB,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;yBACnE;qBACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,OAAgB;QACvB,OAAO,+BAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF,CAAC"}

package/dist/codecs/tool-schema.codec.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tool schema codec (kind: 'reference').
+ *
+ * Tool definitions for function calling.
+ */
+import { z } from 'zod';
+import type { BlockCodec } from '../types/codec.js';
+/**
+ * Tool schema payload schema (JSON Schema-like).
+ */
+export declare const ToolSchemaPayloadSchema: z.ZodObject<{
+    /** Tool name */
+    name: z.ZodString;
+    /** Tool description */
+    description: z.ZodString;
+    /** Input schema (JSON Schema) */
+    inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** Optional cache control hint */
+    cacheable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    cacheable?: boolean | undefined;
+}, {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    cacheable?: boolean | undefined;
+}>;
+export type ToolSchemaPayload = z.infer<typeof ToolSchemaPayloadSchema>;
+/**
+ * Tool schema codec implementation.
+ */
+export declare const ToolSchemaCodec: BlockCodec<ToolSchemaPayload>;
+//# sourceMappingURL=tool-schema.codec.d.ts.map

package/dist/codecs/tool-schema.codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema.codec.d.ts","sourceRoot":"","sources":["../../src/codecs/tool-schema.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,uBAAuB;IAClC,gBAAgB;;IAGhB,uBAAuB;;IAGvB,iCAAiC;;IAGjC,kCAAkC;;;;;;;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,UAAU,CAAC,iBAAiB,CAqDzD,CAAC"}