@howells/envelope 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Daniel Howells
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,60 @@
+# envelope
+
+Thin wrapper around the `claude` (Claude Code) CLI for **strict** Zod-validated input/output.
+
+This is designed for local Node apps where you want "model calls" to look like a normal API:
+- validate inputs with Zod
+- request structured JSON output via `--json-schema`
+- validate outputs with Zod again (defense in depth)
+
+## Requirements
+
+- Node 20+
+- `claude` CLI installed and authenticated (Claude Code)
+
+## Usage (Zod envelope)
+
+```ts
+import { z } from "zod";
+import { createEnvelope, createClaudeCodeClient, createCodexClient } from "envelope";
+
+const summarizeClaude = createEnvelope({
+  client: createClaudeCodeClient({ model: "opus", maxBudgetUsd: 2 }),
+  input: z.object({ text: z.string().min(1) }),
+  output: z.object({ summary: z.string().min(1) }),
+  prompt: ({ text }) =>
+    `Summarize this in 1 sentence. Return JSON only: ${JSON.stringify({ text })}`,
+});
+
+const summarizeCodex = createEnvelope({
+  client: createCodexClient({ model: "gpt-5.3-codex" }),
+  input: z.object({ text: z.string().min(1) }),
+  output: z.object({ summary: z.string().min(1) }),
+  prompt: ({ text }) =>
+    `Summarize this in 1 sentence. Return JSON only: ${JSON.stringify({ text })}`,
+});
+
+const out = await summarizeClaude({ text: "..." });
+console.log(out.summary);
+```
+
+## Usage (AI SDK 6)
+
+```ts
+import { generateText } from "ai";
+import { claudeCode, codex } from "envelope/ai-sdk";
+
+const { text } = await generateText({
+  model: claudeCode("opus"),
+  prompt: "Write a haiku about camellias.",
+});
+
+const r2 = await generateText({
+  model: codex("gpt-5.3-codex"),
+  prompt: "Write a haiku about camellias.",
+});
+```
+
+Notes:
+- Current adapter is text-only and uses a single-shot call under the hood.
+- If we want true streaming, we can extend it to use `claude --output-format stream-json`.

package/dist/ai-sdk.d.ts

@@ -0,0 +1,10 @@
+import type { LanguageModelV1 } from "@ai-sdk/provider";
+import { type CliTool } from "./client.js";
+export declare function cliModel(args: {
+    tool: CliTool;
+    model: string;
+    clientOptions?: any;
+}): LanguageModelV1;
+export declare function claudeCode(model: string, clientOptions?: any): LanguageModelV1;
+export declare function codex(model: string, clientOptions?: any): LanguageModelV1;
+//# sourceMappingURL=ai-sdk.d.ts.map

package/dist/ai-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.d.ts","sourceRoot":"","sources":["../src/ai-sdk.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,eAAe,EAIhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAA6D,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAkCtG,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB,GAAG,eAAe,CAwDlB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,mBAE5D;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,mBAEvD"}

package/dist/ai-sdk.js

@@ -0,0 +1,91 @@
+// AI SDK adapter for CLI tools (Claude Code, Codex).
+//
+// This is intentionally minimal and text-first. For `object-json` mode, it
+// maps the JSON schema to the tool's structured output mode.
+import { createClaudeCodeClient, createCodexClient } from "./client.js";
+function v1PromptToText(prompt) {
+    const parts = [];
+    for (const m of prompt) {
+        const role = m.role;
+        const content = m.content;
+        if (!Array.isArray(content))
+            continue;
+        const text = content
+            .filter((p) => p && typeof p === "object" && p.type === "text" && typeof p.text === "string")
+            .map((p) => p.text)
+            .join("");
+        if (text) {
+            parts.push(`${role}: ${text}`);
+        }
+    }
+    return parts.join("\n");
+}
+function toSchema(schema) {
+    if (!schema)
+        return null;
+    return schema;
+}
+function makeClient(tool, model, opts) {
+    if (tool === "codex") {
+        return createCodexClient({ model, ...(opts ?? {}) });
+    }
+    return createClaudeCodeClient({ model, ...(opts ?? {}) });
+}
+export function cliModel(args) {
+    const client = makeClient(args.tool, args.model, args.clientOptions);
+    return {
+        specificationVersion: "v1",
+        provider: args.tool,
+        modelId: args.model,
+        defaultObjectGenerationMode: "json",
+        supportsStructuredOutputs: true,
+        async doGenerate(callOptions) {
+            const promptText = v1PromptToText(callOptions.prompt);
+            const finishReason = "stop";
+            if (callOptions.mode.type === "object-json") {
+                const schema = toSchema(callOptions.mode.schema);
+                if (!schema) {
+                    throw new Error("object-json mode requires a JSON schema");
+                }
+                const res = await client.structured({ prompt: promptText, jsonSchema: schema });
+                return {
+                    text: JSON.stringify(res.structured ?? null),
+                    finishReason,
+                    usage: { promptTokens: 0, completionTokens: 0 },
+                    rawCall: { rawPrompt: promptText, rawSettings: { mode: callOptions.mode } },
+                };
+            }
+            const res = await client.text({ prompt: promptText });
+            return {
+                text: res.text,
+                finishReason,
+                usage: { promptTokens: 0, completionTokens: 0 },
+                rawCall: { rawPrompt: promptText, rawSettings: { mode: callOptions.mode } },
+            };
+        },
+        async doStream(callOptions) {
+            const res = await this.doGenerate(callOptions);
+            const stream = new ReadableStream({
+                start(controller) {
+                    if (res.text) {
+                        controller.enqueue({ type: "text-delta", textDelta: res.text });
+                    }
+                    controller.enqueue({
+                        type: "finish",
+                        finishReason: res.finishReason,
+                        usage: res.usage,
+                    });
+                    controller.close();
+                },
+            });
+            return { stream, rawCall: res.rawCall, warnings: [] };
+        },
+    };
+}
+export function claudeCode(model, clientOptions) {
+    return cliModel({ tool: "claude-code", model, clientOptions });
+}
+export function codex(model, clientOptions) {
+    return cliModel({ tool: "codex", model, clientOptions });
+}
+//# sourceMappingURL=ai-sdk.js.map

package/dist/ai-sdk.js.map

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

package/dist/claude-code.d.ts

@@ -0,0 +1,34 @@
+export type ClaudeCodeModel = string;
+export interface ClaudeCodeOptions {
+    claudePath?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    model?: ClaudeCodeModel;
+    maxBudgetUsd?: number;
+    timeoutMs?: number;
+    permissionMode?: "dontAsk" | "default" | "bypassPermissions";
+    tools?: string;
+}
+export interface ClaudeCodeEnvelope<TStructured> {
+    type?: string;
+    subtype?: string;
+    is_error?: boolean;
+    result?: string;
+    structured_output?: TStructured;
+    total_cost_usd?: number;
+    stop_reason?: string | null;
+    session_id?: string;
+    permission_denials?: unknown[];
+}
+export declare function claudeCodeStructured<TStructured>(args: {
+    prompt: string;
+    jsonSchema: string;
+    options?: ClaudeCodeOptions;
+}): Promise<ClaudeCodeEnvelope<TStructured>>;
+export declare function claudeCodeText(args: {
+    prompt: string;
+    options?: ClaudeCodeOptions;
+}): Promise<{
+    text: string;
+}>;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../src/claude-code.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,mBAAmB,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB,CAAC,WAAW;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC;CAChC;AAyCD,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,IAAI,EAAE;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B,4CA4CA;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;;GAuCA"}

package/dist/claude-code.js

@@ -0,0 +1,97 @@
+import { execFile } from "node:child_process";
+function isRecord(v) {
+    return typeof v === "object" && v !== null;
+}
+function execFileAsync(file, args, opts) {
+    return new Promise((resolve, reject) => {
+        execFile(file, args, {
+            cwd: opts.cwd,
+            env: opts.env,
+            timeout: opts.timeoutMs,
+            maxBuffer: 128 * 1024 * 1024,
+            encoding: "utf8",
+        }, (err, stdout, stderr) => {
+            if (err) {
+                const e = new Error(`claude CLI failed (code=${err.code ?? "?"}): ${stderr || stdout}`);
+                e.cause = err;
+                reject(e);
+                return;
+            }
+            resolve({ stdout, stderr });
+        });
+    });
+}
+function buildBaseArgs(opts) {
+    return ["--model", opts.model, "-p", "--permission-mode", opts.permissionMode, "--tools", opts.tools];
+}
+export async function claudeCodeStructured(args) {
+    const options = {
+        claudePath: args.options?.claudePath ?? "claude",
+        cwd: args.options?.cwd ?? process.cwd(),
+        env: args.options?.env ?? process.env,
+        model: args.options?.model ?? "opus",
+        maxBudgetUsd: args.options?.maxBudgetUsd ?? 5,
+        timeoutMs: args.options?.timeoutMs ?? 120_000,
+        permissionMode: args.options?.permissionMode ?? "dontAsk",
+        tools: args.options?.tools ?? "",
+    };
+    const { stdout } = await execFileAsync(options.claudePath, [
+        ...buildBaseArgs(options),
+        "--max-budget-usd",
+        String(options.maxBudgetUsd),
+        "--output-format",
+        "json",
+        "--json-schema",
+        args.jsonSchema,
+        args.prompt,
+    ], { cwd: options.cwd, env: options.env, timeoutMs: options.timeoutMs });
+    let envelopeUnknown;
+    try {
+        envelopeUnknown = JSON.parse(stdout);
+    }
+    catch {
+        throw new Error(`claude CLI returned non-JSON output. First 200 chars:\n${stdout.slice(0, 200)}`);
+    }
+    if (!isRecord(envelopeUnknown)) {
+        throw new Error("claude CLI returned non-object JSON envelope");
+    }
+    const envelope = envelopeUnknown;
+    if (envelope.is_error) {
+        throw new Error(`claude CLI error envelope: ${envelope.subtype ?? "unknown"}`);
+    }
+    return envelope;
+}
+export async function claudeCodeText(args) {
+    const options = {
+        claudePath: args.options?.claudePath ?? "claude",
+        cwd: args.options?.cwd ?? process.cwd(),
+        env: args.options?.env ?? process.env,
+        model: args.options?.model ?? "opus",
+        maxBudgetUsd: args.options?.maxBudgetUsd ?? 5,
+        timeoutMs: args.options?.timeoutMs ?? 120_000,
+        permissionMode: args.options?.permissionMode ?? "dontAsk",
+        tools: args.options?.tools ?? "",
+    };
+    const { stdout } = await execFileAsync(options.claudePath, [
+        ...buildBaseArgs(options),
+        "--max-budget-usd",
+        String(options.maxBudgetUsd),
+        "--output-format",
+        "json",
+        args.prompt,
+    ], { cwd: options.cwd, env: options.env, timeoutMs: options.timeoutMs });
+    let envelopeUnknown;
+    try {
+        envelopeUnknown = JSON.parse(stdout);
+    }
+    catch {
+        // fallback: if the user configured output-format defaults, just return the raw stdout
+        return { text: stdout };
+    }
+    if (!isRecord(envelopeUnknown)) {
+        return { text: stdout };
+    }
+    const envelope = envelopeUnknown;
+    return { text: envelope.result ?? "" };
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/claude-code.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import type { JSONSchema7 } from "@ai-sdk/provider";
+import { type ClaudeCodeOptions } from "./claude-code.js";
+import { type CodexOptions } from "./codex-cli.js";
+export type CliTool = "claude-code" | "codex";
+export interface GenerateTextArgs {
+    prompt: string;
+}
+export interface GenerateStructuredArgs {
+    prompt: string;
+    jsonSchema: JSONSchema7;
+}
+export interface CliClient {
+    tool: CliTool;
+    model: string;
+    text(args: GenerateTextArgs): Promise<{
+        text: string;
+    }>;
+    structured<T>(args: GenerateStructuredArgs): Promise<{
+        structured: T;
+    }>;
+}
+export declare function jsonSchemaFromZod(schema: z.ZodTypeAny): JSONSchema7;
+export declare function createClaudeCodeClient(args?: {
+    model?: string;
+    maxBudgetUsd?: number;
+    timeoutMs?: number;
+    options?: Omit<ClaudeCodeOptions, "model" | "maxBudgetUsd" | "timeoutMs">;
+}): CliClient;
+export declare function createCodexClient(args?: {
+    model?: string;
+    timeoutMs?: number;
+    options?: Omit<CodexOptions, "model" | "timeoutMs">;
+}): CliClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/E,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,WAAW,CAOnE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,cAAc,GAAG,WAAW,CAAC,CAAC;CAC3E,GAAG,SAAS,CAyBZ;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC;CACrD,GAAG,SAAS,CAwBZ"}

package/dist/client.js

@@ -0,0 +1,61 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { claudeCodeStructured, claudeCodeText, } from "./claude-code.js";
+import { codexStructured, codexText } from "./codex-cli.js";
+export function jsonSchemaFromZod(schema) {
+    // Important: do NOT provide `name`. `zod-to-json-schema` wraps named schemas
+    // in a `$ref`/`definitions` envelope, which breaks Codex's `--output-schema`
+    // requirement that the root schema is `type: "object"`.
+    return zodToJsonSchema(schema, {
+        $refStrategy: "none",
+    });
+}
+export function createClaudeCodeClient(args) {
+    const cfg = args;
+    const model = cfg?.model ?? "opus";
+    const maxBudgetUsd = cfg?.maxBudgetUsd ?? 5;
+    const timeoutMs = cfg?.timeoutMs ?? 120_000;
+    return {
+        tool: "claude-code",
+        model,
+        async text(input) {
+            const res = await claudeCodeText({
+                prompt: input.prompt,
+                options: { ...cfg?.options, model, maxBudgetUsd, timeoutMs },
+            });
+            return { text: res.text };
+        },
+        async structured(input) {
+            const envelope = await claudeCodeStructured({
+                prompt: input.prompt,
+                jsonSchema: JSON.stringify(input.jsonSchema),
+                options: { ...cfg?.options, model, maxBudgetUsd, timeoutMs },
+            });
+            return { structured: envelope.structured_output };
+        },
+    };
+}
+export function createCodexClient(args) {
+    const cfg = args;
+    const model = cfg?.model ?? "gpt-5.3-codex";
+    const timeoutMs = cfg?.timeoutMs ?? 180_000;
+    return {
+        tool: "codex",
+        model,
+        async text(input) {
+            const res = await codexText({
+                prompt: input.prompt,
+                options: { ...cfg?.options, model, timeoutMs },
+            });
+            return { text: res.text };
+        },
+        async structured(input) {
+            const res = await codexStructured({
+                prompt: input.prompt,
+                jsonSchema: JSON.stringify(input.jsonSchema),
+                options: { ...cfg?.options, model, timeoutMs },
+            });
+            return { structured: res.structured };
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,cAAc,GAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,SAAS,EAAqB,MAAM,gBAAgB,CAAC;AAoB/E,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,6EAA6E;IAC7E,6EAA6E;IAC7E,wDAAwD;IACxD,OAAO,eAAe,CAAC,MAAM,EAAE;QAC7B,YAAY,EAAE,MAAM;KACrB,CAA2B,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAKtC;IACC,MAAM,GAAG,GAAG,IAAI,CAAC;IACjB,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,MAAM,CAAC;IACnC,MAAM,YAAY,GAAG,GAAG,EAAE,YAAY,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,IAAI,OAAO,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK;QACL,KAAK,CAAC,IAAI,CAAC,KAAuB;YAChC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC;gBAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE;aAC7D,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,UAAU,CAAI,KAA6B;YAC/C,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAI;gBAC7C,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC5C,OAAO,EAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE;aAC7D,CAAC,CAAC;YACH,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,iBAAsB,EAAE,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAIjC;IACC,MAAM,GAAG,GAAG,IAAI,CAAC;IACjB,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,eAAe,CAAC;IAC5C,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,IAAI,OAAO,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK;QACL,KAAK,CAAC,IAAI,CAAC,KAAuB;YAChC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;aAC/C,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,UAAU,CAAI,KAA6B;YAC/C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAI;gBACnC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC5C,OAAO,EAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;aAC/C,CAAC,CAAC;YACH,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/codex-cli.d.ts

@@ -0,0 +1,28 @@
+export type CodexModel = string;
+export interface CodexOptions {
+    codexPath?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    model?: CodexModel;
+    timeoutMs?: number;
+    skipGitRepoCheck?: boolean;
+    sandbox?: "read-only" | "workspace-write" | "danger-full-access";
+    profile?: string;
+    config?: Array<string>;
+    jsonlEvents?: boolean;
+}
+export declare function codexText(args: {
+    prompt: string;
+    options?: CodexOptions;
+}): Promise<{
+    text: string;
+}>;
+export declare function codexStructured<TStructured>(args: {
+    prompt: string;
+    jsonSchema: string;
+    options?: CodexOptions;
+}): Promise<{
+    structured: TStructured;
+    raw: string;
+}>;
+//# sourceMappingURL=codex-cli.d.ts.map

package/dist/codex-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-cli.d.ts","sourceRoot":"","sources":["../src/codex-cli.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA0ED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE;;GAwB/E;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,IAAI,EAAE;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;gBAiCkC,WAAW;;GAI7C"}

package/dist/codex-cli.js

@@ -0,0 +1,120 @@
+import { execFile } from "node:child_process";
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+function execFileAsync(file, args, opts) {
+    return new Promise((resolve, reject) => {
+        execFile(file, args, {
+            cwd: opts.cwd,
+            env: opts.env,
+            timeout: opts.timeoutMs,
+            maxBuffer: 128 * 1024 * 1024,
+            encoding: "utf8",
+        }, (err, stdout, stderr) => {
+            if (err) {
+                const e = new Error(`codex CLI failed (code=${err.code ?? "?"}): ${stderr || stdout}`);
+                e.cause = err;
+                reject(e);
+                return;
+            }
+            resolve({ stdout, stderr });
+        });
+    });
+}
+function baseArgs(options) {
+    const args = ["exec"];
+    if (options.skipGitRepoCheck) {
+        args.push("--skip-git-repo-check");
+    }
+    if (options.cwd) {
+        args.push("-C", options.cwd);
+    }
+    if (options.model) {
+        args.push("--model", options.model);
+    }
+    if (options.sandbox) {
+        args.push("--sandbox", options.sandbox);
+    }
+    if (options.profile) {
+        args.push("--profile", options.profile);
+    }
+    for (const c of options.config) {
+        args.push("--config", c);
+    }
+    if (options.jsonlEvents) {
+        args.push("--json");
+    }
+    return args;
+}
+function defaultOptions(opts) {
+    return {
+        codexPath: opts?.codexPath ?? "codex",
+        cwd: opts?.cwd ?? process.cwd(),
+        env: opts?.env ?? process.env,
+        model: opts?.model ?? "gpt-5.3-codex",
+        timeoutMs: opts?.timeoutMs ?? 180_000,
+        skipGitRepoCheck: opts?.skipGitRepoCheck ?? true,
+        sandbox: opts?.sandbox ?? "danger-full-access",
+        profile: opts?.profile ?? "",
+        config: opts?.config ?? [],
+        jsonlEvents: opts?.jsonlEvents ?? false,
+    };
+}
+export async function codexText(args) {
+    const options = defaultOptions(args.options);
+    const td = await mkdtemp(join(tmpdir(), "envelope-codex-"));
+    try {
+        const outPath = join(td, "last.txt");
+        const cliArgs = [
+            ...baseArgs(options),
+            "--output-last-message",
+            outPath,
+            args.prompt,
+        ];
+        await execFileAsync(options.codexPath, cliArgs, {
+            cwd: options.cwd,
+            env: options.env,
+            timeoutMs: options.timeoutMs,
+        });
+        const text = await readFile(outPath, "utf8");
+        return { text };
+    }
+    finally {
+        await rm(td, { recursive: true, force: true });
+    }
+}
+export async function codexStructured(args) {
+    const options = defaultOptions(args.options);
+    const td = await mkdtemp(join(tmpdir(), "envelope-codex-"));
+    try {
+        const schemaPath = join(td, "schema.json");
+        const outPath = join(td, "last.txt");
+        await writeFile(schemaPath, args.jsonSchema, "utf8");
+        const cliArgs = [
+            ...baseArgs(options),
+            "--output-schema",
+            schemaPath,
+            "--output-last-message",
+            outPath,
+            args.prompt,
+        ];
+        await execFileAsync(options.codexPath, cliArgs, {
+            cwd: options.cwd,
+            env: options.env,
+            timeoutMs: options.timeoutMs,
+        });
+        const raw = await readFile(outPath, "utf8");
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`codex output was not JSON. First 200 chars:\n${raw.slice(0, 200)}`);
+        }
+        return { structured: parsed, raw };
+    }
+    finally {
+        await rm(td, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=codex-cli.js.map

package/dist/codex-cli.js.map

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

package/dist/envelope.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { CliClient } from "./client.js";
+export declare class EnvelopeError extends Error {
+    name: string;
+}
+export interface CreateEnvelopeArgs<TIn extends z.ZodTypeAny, TOut extends z.ZodTypeAny> {
+    input: TIn;
+    output: TOut;
+    prompt: (input: z.infer<TIn>) => string;
+    client?: CliClient;
+}
+export declare function createEnvelope<TIn extends z.ZodTypeAny, TOut extends z.ZodTypeAny>(args: CreateEnvelopeArgs<TIn, TOut>): (inputRaw: unknown) => Promise<z.infer<TOut>>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,qBAAa,aAAc,SAAQ,KAAK;IAC7B,IAAI,SAAmB;CACjC;AAED,MAAM,WAAW,kBAAkB,CAAC,GAAG,SAAS,CAAC,CAAC,UAAU,EAAE,IAAI,SAAS,CAAC,CAAC,UAAU;IACrF,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;IACxC,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,GAAG,SAAS,CAAC,CAAC,UAAU,EAAE,IAAI,SAAS,CAAC,CAAC,UAAU,EAChF,IAAI,EAAE,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,IAKrB,UAAU,OAAO,KAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAgBzD"}

package/dist/envelope.js

@@ -0,0 +1,22 @@
+import { createClaudeCodeClient, jsonSchemaFromZod } from "./client.js";
+export class EnvelopeError extends Error {
+    name = "EnvelopeError";
+}
+export function createEnvelope(args) {
+    const jsonSchema = jsonSchemaFromZod(args.output);
+    const client = args.client ?? createClaudeCodeClient();
+    return async (inputRaw) => {
+        const input = args.input.safeParse(inputRaw);
+        if (!input.success) {
+            throw new EnvelopeError(input.error.message);
+        }
+        const prompt = args.prompt(input.data);
+        const res = await client.structured({ prompt, jsonSchema });
+        const output = args.output.safeParse(res.structured);
+        if (!output.success) {
+            throw new EnvelopeError(`Model returned invalid structured output:\n${output.error.message}`);
+        }
+        return output.data;
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,GAAG,eAAe,CAAC;CACjC;AASD,MAAM,UAAU,cAAc,CAC5B,IAAmC;IAEnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAC;IAEvD,OAAO,KAAK,EAAE,QAAiB,EAA0B,EAAE;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,aAAa,CACrB,8CAA8C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACrE,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./claude-code.js";
+export * from "./codex-cli.js";
+export * from "./client.js";
+export * from "./envelope.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./claude-code.js";
+export * from "./codex-cli.js";
+export * from "./client.js";
+export * from "./envelope.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@howells/envelope",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Strict Zod IO wrapper around local CLI LLMs (Claude Code, Codex), plus an AI SDK adapter.",
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "author": "Daniel Howells",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/howells/envelope.git"
+  },
+  "bugs": {
+    "url": "https://github.com/howells/envelope/issues"
+  },
+  "homepage": "https://github.com/howells/envelope#readme",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./ai-sdk": {
+      "types": "./dist/ai-sdk.d.ts",
+      "default": "./dist/ai-sdk.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json -w",
+    "prepack": "pnpm build",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "llm",
+    "cli",
+    "claude",
+    "codex",
+    "zod",
+    "ai-sdk"
+  ],
+  "dependencies": {
+    "@ai-sdk/provider": "^1.0.0",
+    "@ai-sdk/provider-utils": "^3.0.0",
+    "zod": "^3.25.0",
+    "zod-to-json-schema": "^3.24.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "packageManager": "pnpm@10.12.4"
+}