@duetso/agent 0.1.20

package/dist/src/memory/storage.js

@@ -0,0 +1,127 @@
+import { PGlite } from "@electric-sql/pglite";
+import { mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+export async function loadStoredMemory(memoryPath, cwd, store) {
+    if (!memoryPath) {
+        return async () => { };
+    }
+    const database = await openMemoryDatabase(resolveMemoryPath(memoryPath, cwd));
+    const snapshot = await readMemorySnapshot(database);
+    await store.replaceObservations(snapshot.observations);
+    let writeQueue = Promise.resolve();
+    const enqueueWrite = (event) => {
+        writeQueue = writeQueue.then(() => persistMemoryEvent(database, event));
+        void writeQueue;
+    };
+    const unsubscribe = store.on(enqueueWrite);
+    return async () => {
+        unsubscribe();
+        await writeQueue;
+        await database.close();
+    };
+}
+async function openMemoryDatabase(path) {
+    mkdirSync(dirname(path), { recursive: true });
+    const database = new PGlite(path);
+    await database.exec(`
+    CREATE TABLE IF NOT EXISTS observations (
+      id TEXT PRIMARY KEY,
+      created_at BIGINT NOT NULL,
+      observed_date TEXT NOT NULL,
+      referenced_date TEXT,
+      relative_date TEXT,
+      time_of_day TEXT,
+      priority TEXT NOT NULL,
+      scope TEXT NOT NULL,
+      source_json TEXT NOT NULL,
+      content TEXT NOT NULL,
+      tags_json TEXT NOT NULL
+    );
+  `);
+    return database;
+}
+async function readMemorySnapshot(database) {
+    const result = await database.query(`SELECT id, created_at, observed_date, referenced_date, relative_date, time_of_day, priority, scope, source_json, content, tags_json
+     FROM observations
+     ORDER BY created_at ASC`);
+    const observations = result.rows.map(rowToObservation);
+    return {
+        observations,
+        estimatedTokens: {
+            observations: estimateTokens(observations.map((item) => item.content).join("\n")),
+        },
+        updatedAt: Date.now(),
+    };
+}
+async function persistMemoryEvent(database, event) {
+    if (event.type === "observation_appended") {
+        await upsertObservation(database, event.observation);
+        return;
+    }
+    await syncObservations(database, event.observations);
+}
+async function syncObservations(database, observations) {
+    const ids = observations.map((observation) => observation.id);
+    await database.transaction(async (tx) => {
+        if (ids.length === 0) {
+            await tx.exec("DELETE FROM observations");
+        }
+        else {
+            await tx.query("DELETE FROM observations WHERE NOT (id = ANY($1::text[]))", [ids]);
+        }
+        for (const observation of observations) {
+            await upsertObservation(tx, observation);
+        }
+    });
+}
+async function upsertObservation(database, observation) {
+    await database.query(`INSERT INTO observations (
+      id, created_at, observed_date, referenced_date, relative_date, time_of_day,
+      priority, scope, source_json, content, tags_json
+    ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11)
+    ON CONFLICT (id) DO UPDATE SET
+      created_at = EXCLUDED.created_at,
+      observed_date = EXCLUDED.observed_date,
+      referenced_date = EXCLUDED.referenced_date,
+      relative_date = EXCLUDED.relative_date,
+      time_of_day = EXCLUDED.time_of_day,
+      priority = EXCLUDED.priority,
+      scope = EXCLUDED.scope,
+      source_json = EXCLUDED.source_json,
+      content = EXCLUDED.content,
+      tags_json = EXCLUDED.tags_json`, [
+        observation.id,
+        observation.createdAt,
+        observation.observedDate,
+        observation.referencedDate ?? null,
+        observation.relativeDate ?? null,
+        observation.timeOfDay ?? null,
+        observation.priority,
+        observation.scope,
+        JSON.stringify(observation.source),
+        observation.content,
+        JSON.stringify(observation.tags),
+    ]);
+}
+function resolveMemoryPath(path, cwd) {
+    return path.startsWith("/") ? path : join(cwd, path);
+}
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function rowToObservation(row) {
+    return {
+        id: row.id,
+        createdAt: row.created_at,
+        observedDate: row.observed_date,
+        referencedDate: row.referenced_date ?? undefined,
+        relativeDate: row.relative_date ?? undefined,
+        timeOfDay: row.time_of_day ?? undefined,
+        priority: row.priority,
+        scope: row.scope,
+        source: JSON.parse(row.source_json),
+        content: row.content,
+        tags: JSON.parse(row.tags_json),
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/memory/storage.js.map

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

package/dist/src/memory/store.d.ts

@@ -0,0 +1,13 @@
+import type { MemoryStoreEventHandler, Observation, ObservationQuery, ObservationalMemorySnapshot } from "../types/memory.js";
+export declare class MemoryStore {
+    private observations;
+    private handlers;
+    on(handler: MemoryStoreEventHandler): () => void;
+    appendObservation(input: Omit<Observation, "id" | "createdAt">): Promise<Observation>;
+    recall(query: ObservationQuery): Promise<Observation[]>;
+    getSnapshot(): Promise<ObservationalMemorySnapshot>;
+    replaceObservations(observations: Observation[]): Promise<void>;
+    render(snapshot: ObservationalMemorySnapshot): string;
+    private emit;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/src/memory/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/memory/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,uBAAuB,EACvB,WAAW,EAEX,gBAAgB,EAChB,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,QAAQ,CAAsC;IAEtD,EAAE,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAO1C,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAWrF,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0BvD,WAAW,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAcnD,mBAAmB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrE,MAAM,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM;IAQrD,OAAO,CAAC,IAAI;CAKb"}

package/dist/src/memory/store.js

@@ -0,0 +1,106 @@
+import { nanoid } from "nanoid";
+export class MemoryStore {
+    observations = new Map();
+    handlers = new Set();
+    on(handler) {
+        this.handlers.add(handler);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    async appendObservation(input) {
+        const observation = {
+            ...input,
+            id: createMemoryId(),
+            createdAt: Date.now(),
+        };
+        this.observations.set(observation.id, observation);
+        this.emit({ type: "observation_appended", observation });
+        return observation;
+    }
+    async recall(query) {
+        let candidates = Array.from(this.observations.values());
+        if (query.scope) {
+            candidates = candidates.filter((observation) => observation.scope === query.scope);
+        }
+        if (query.tags?.length) {
+            candidates = candidates.filter((observation) => query.tags.some((tag) => observation.tags.includes(tag)));
+        }
+        if (query.minPriority) {
+            const minRank = priorityRank(query.minPriority);
+            candidates = candidates.filter((observation) => priorityRank(observation.priority) >= minRank);
+        }
+        if (query.query) {
+            const terms = tokenize(query.query);
+            candidates = candidates.sort((a, b) => textScore(b, terms) - textScore(a, terms));
+        }
+        else {
+            candidates.sort((a, b) => b.createdAt - a.createdAt);
+        }
+        return candidates.slice(0, query.limit ?? 10);
+    }
+    async getSnapshot() {
+        const observations = Array.from(this.observations.values()).sort((a, b) => a.createdAt - b.createdAt);
+        const updatedAt = Date.now();
+        return {
+            observations,
+            estimatedTokens: {
+                observations: estimateTokens(observations.map((item) => item.content).join("\n")),
+            },
+            updatedAt,
+        };
+    }
+    async replaceObservations(observations) {
+        this.observations.clear();
+        for (const observation of observations) {
+            this.observations.set(observation.id, observation);
+        }
+        this.emit({ type: "observations_replaced", observations });
+    }
+    render(snapshot) {
+        const observationLines = snapshot.observations.map(formatObservation);
+        return [
+            "## Observations",
+            observationLines.length > 0 ? observationLines.join("\n") : "(none)",
+        ].join("\n");
+    }
+    emit(event) {
+        for (const handler of this.handlers) {
+            handler(event);
+        }
+    }
+}
+function createMemoryId() {
+    return `mem_${nanoid(12)}`;
+}
+function priorityRank(priority) {
+    return priority === "high" ? 3 : priority === "medium" ? 2 : 1;
+}
+function priorityMarker(priority) {
+    return priority === "high" ? "HIGH" : priority === "medium" ? "MED" : "LOW";
+}
+function formatObservation(observation) {
+    const time = observation.timeOfDay ? ` ${observation.timeOfDay}` : "";
+    const referenced = observation.referencedDate ? ` [ref: ${observation.referencedDate}]` : "";
+    return `- ${priorityMarker(observation.priority)} ${observation.observedDate}${time}${referenced} ${observation.content}`;
+}
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean));
+}
+function textScore(observation, terms) {
+    const text = `${observation.content} ${observation.tags.join(" ")}`.toLowerCase();
+    let score = priorityRank(observation.priority);
+    for (const term of terms) {
+        if (text.includes(term)) {
+            score += 1;
+        }
+    }
+    return score;
+}
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=store.js.map

package/dist/src/memory/store.js.map

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

package/dist/src/model-resolution/duet-gateway.d.ts

@@ -0,0 +1,35 @@
+import { type Model } from "@earendil-works/pi-ai";
+/**
+ * The Duet gateway proxies Vercel's AI Gateway 1:1 — same path layout, same
+ * request/response contract — and authenticates with a `DUET_API_KEY` token
+ * scoped to a single org. Rather than ship a parallel model registry, the
+ * `duet-gateway` provider piggybacks on the underlying `vercel-ai-gateway`
+ * model definitions and only swaps `baseUrl` to point at Duet (or a custom
+ * URL via `DUET_GATEWAY_BASE_URL`).
+ *
+ * Auth flows through pi-ai's existing vercel-ai-gateway path, which reads
+ * `AI_GATEWAY_API_KEY` — the CLI shims that env var from `DUET_API_KEY` at
+ * startup so users only need to set the duet token.
+ */
+export declare const DUET_GATEWAY_PROVIDER = "duet-gateway";
+export declare const DUET_GATEWAY_API_KEY_ENV = "DUET_API_KEY";
+export declare const DUET_GATEWAY_BASE_URL_ENV = "DUET_GATEWAY_BASE_URL";
+export declare function isDuetGatewayModelName(modelName: string): boolean;
+export declare function getDuetGatewayBaseUrl(): string;
+/**
+ * Resolve a `duet-gateway:<modelId>` string to a Model.
+ *
+ * Looks up the matching vercel-ai-gateway model and clones it with a Duet
+ * gateway baseUrl. Returns undefined when the underlying gateway model
+ * doesn't exist, mirroring `getModel`'s contract.
+ */
+export declare function resolveDuetGatewayModel(modelId: string): Model<any> | undefined;
+/**
+ * If `DUET_API_KEY` is set but `AI_GATEWAY_API_KEY` is not, copy it across so
+ * the underlying vercel-ai-gateway provider auth path resolves. Idempotent.
+ *
+ * Called early in CLI startup. No-op when either var is missing or
+ * `AI_GATEWAY_API_KEY` is already set (caller wins).
+ */
+export declare function shimDuetApiKeyToAiGateway(): void;
+//# sourceMappingURL=duet-gateway.d.ts.map

package/dist/src/model-resolution/duet-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duet-gateway.d.ts","sourceRoot":"","sources":["../../../src/model-resolution/duet-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAK7D;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,qBAAqB,iBAAkB,CAAC;AACrD,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AACvD,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAQ/E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD"}

package/dist/src/model-resolution/duet-gateway.js

@@ -0,0 +1,56 @@
+import { getModel } from "@earendil-works/pi-ai";
+const PROVIDER_PREFIX = "duet-gateway";
+const DEFAULT_BASE_URL = "https://duet.so/api/v1/ai-gateway";
+/**
+ * The Duet gateway proxies Vercel's AI Gateway 1:1 — same path layout, same
+ * request/response contract — and authenticates with a `DUET_API_KEY` token
+ * scoped to a single org. Rather than ship a parallel model registry, the
+ * `duet-gateway` provider piggybacks on the underlying `vercel-ai-gateway`
+ * model definitions and only swaps `baseUrl` to point at Duet (or a custom
+ * URL via `DUET_GATEWAY_BASE_URL`).
+ *
+ * Auth flows through pi-ai's existing vercel-ai-gateway path, which reads
+ * `AI_GATEWAY_API_KEY` — the CLI shims that env var from `DUET_API_KEY` at
+ * startup so users only need to set the duet token.
+ */
+export const DUET_GATEWAY_PROVIDER = PROVIDER_PREFIX;
+export const DUET_GATEWAY_API_KEY_ENV = "DUET_API_KEY";
+export const DUET_GATEWAY_BASE_URL_ENV = "DUET_GATEWAY_BASE_URL";
+export function isDuetGatewayModelName(modelName) {
+    return modelName.startsWith(`${PROVIDER_PREFIX}:`);
+}
+export function getDuetGatewayBaseUrl() {
+    return process.env[DUET_GATEWAY_BASE_URL_ENV] ?? DEFAULT_BASE_URL;
+}
+/**
+ * Resolve a `duet-gateway:<modelId>` string to a Model.
+ *
+ * Looks up the matching vercel-ai-gateway model and clones it with a Duet
+ * gateway baseUrl. Returns undefined when the underlying gateway model
+ * doesn't exist, mirroring `getModel`'s contract.
+ */
+export function resolveDuetGatewayModel(modelId) {
+    const upstream = getModel("vercel-ai-gateway", modelId);
+    if (!upstream)
+        return undefined;
+    return {
+        ...upstream,
+        baseUrl: getDuetGatewayBaseUrl(),
+    };
+}
+/**
+ * If `DUET_API_KEY` is set but `AI_GATEWAY_API_KEY` is not, copy it across so
+ * the underlying vercel-ai-gateway provider auth path resolves. Idempotent.
+ *
+ * Called early in CLI startup. No-op when either var is missing or
+ * `AI_GATEWAY_API_KEY` is already set (caller wins).
+ */
+export function shimDuetApiKeyToAiGateway() {
+    if (process.env.AI_GATEWAY_API_KEY)
+        return;
+    const duetKey = process.env[DUET_GATEWAY_API_KEY_ENV];
+    if (!duetKey)
+        return;
+    process.env.AI_GATEWAY_API_KEY = duetKey;
+}
+//# sourceMappingURL=duet-gateway.js.map

package/dist/src/model-resolution/duet-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duet-gateway.js","sourceRoot":"","sources":["../../../src/model-resolution/duet-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,uBAAuB,CAAC;AAE7D,MAAM,eAAe,GAAG,cAAc,CAAC;AACvC,MAAM,gBAAgB,GAAG,mCAAmC,CAAC;AAE7D;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AACrD,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAC;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEjE,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,eAAe,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,gBAAgB,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,mBAA0B,EAAE,OAAc,CAA2B,CAAC;IAChG,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,OAAO;QACL,GAAG,QAAQ;QACX,OAAO,EAAE,qBAAqB,EAAE;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAAE,OAAO;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,OAAO,CAAC;AAC3C,CAAC"}

package/dist/src/model-resolution/index.d.ts

@@ -0,0 +1,31 @@
+import { type Model } from "@earendil-works/pi-ai";
+/**
+ * Resolves which provider:modelId the CLI talks to, plus the provenance for
+ * that decision (explicit flag, inferred from env, or built-in fallback). The
+ * shape lives in its own module so cli.ts stays focused on argv parsing and
+ * the I/O harness — provider list changes don't touch the CLI surface.
+ */
+export interface ModelResolution {
+    modelName: string;
+    /** explicit: CLI flag; inferred: provider env var present; default: built-in fallback. */
+    source: "explicit" | "inferred" | "default";
+    /** Provider env var that triggered inference, e.g. "ANTHROPIC_API_KEY". */
+    envVar?: string;
+    /** True when the env var was loaded from <workdir>/.env rather than the shell. */
+    fromDotenv?: boolean;
+}
+export declare const DEFAULT_CLI_MODEL: string;
+export declare const DEFAULT_CLI_MEMORY_MODEL: string;
+export declare function resolveModelName(model: string): Model<any>;
+/**
+ * Same selection logic as resolveCliModel, but picks each provider's cheaper
+ * observational-memory model.
+ */
+export declare function resolveCliMemoryModel(memoryModelName: string | undefined, dotenvKeys: Set<string>): ModelResolution;
+/**
+ * Resolve the user-visible model and report provenance so callers can show
+ * "inferred from ANTHROPIC_API_KEY in .env" etc.
+ */
+export declare function resolveCliModel(modelName: string | undefined, dotenvKeys: Set<string>): ModelResolution;
+export declare function describeModelResolution(resolution: ModelResolution): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/model-resolution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/model-resolution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAQ1E;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC5C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiED,eAAO,MAAM,iBAAiB,QAAoC,CAAC;AACnE,eAAO,MAAM,wBAAwB,QAA2C,CAAC;AAEjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAgB1D;AAUD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,eAAe,CAEjB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,eAAe,CAEjB;AA8BD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAO3E"}

package/dist/src/model-resolution/index.js

@@ -0,0 +1,129 @@
+import { findEnvKeys, getModel } from "@earendil-works/pi-ai";
+import { DUET_GATEWAY_API_KEY_ENV, isDuetGatewayModelName, resolveDuetGatewayModel, } from "./duet-gateway.js";
+/**
+ * Provider inference order. Entries are tried top-to-bottom; the first one
+ * with a present env var wins. `customEnvVar` covers providers pi-ai's
+ * `findEnvKeys` doesn't know about (currently only `duet-gateway`).
+ *
+ * `duet-gateway` sits before `vercel-ai-gateway` because the CLI startup shim
+ * copies `DUET_API_KEY` into `AI_GATEWAY_API_KEY`, which would otherwise route
+ * through Vercel's gateway directly when the user only set `DUET_API_KEY`.
+ */
+const MODEL_PROVIDER_INFERENCE = [
+    {
+        provider: "anthropic",
+        model: "anthropic:claude-opus-4-7",
+    },
+    {
+        provider: "duet-gateway",
+        model: "duet-gateway:anthropic/claude-opus-4.7",
+        customEnvVar: () => (process.env[DUET_GATEWAY_API_KEY_ENV] ? DUET_GATEWAY_API_KEY_ENV : null),
+    },
+    {
+        provider: "vercel-ai-gateway",
+        model: "vercel-ai-gateway:anthropic/claude-opus-4.7",
+    },
+    {
+        provider: "openrouter",
+        model: "openrouter:anthropic/claude-opus-4.7",
+    },
+    {
+        provider: "openai",
+        model: "openai:gpt-5.5",
+    },
+];
+const MEMORY_MODEL_PROVIDER_INFERENCE = [
+    {
+        provider: "anthropic",
+        model: "anthropic:claude-haiku-4-5",
+    },
+    {
+        provider: "duet-gateway",
+        model: "duet-gateway:anthropic/claude-haiku-4.5",
+        customEnvVar: () => (process.env[DUET_GATEWAY_API_KEY_ENV] ? DUET_GATEWAY_API_KEY_ENV : null),
+    },
+    {
+        provider: "vercel-ai-gateway",
+        model: "vercel-ai-gateway:anthropic/claude-haiku-4.5",
+    },
+    {
+        provider: "openrouter",
+        model: "openrouter:anthropic/claude-haiku-4.5",
+    },
+    {
+        provider: "openai",
+        model: "openai:gpt-5.4-mini",
+    },
+];
+export const DEFAULT_CLI_MODEL = MODEL_PROVIDER_INFERENCE[0].model;
+export const DEFAULT_CLI_MEMORY_MODEL = MEMORY_MODEL_PROVIDER_INFERENCE[0].model;
+export function resolveModelName(model) {
+    const separator = model.indexOf(":");
+    if (separator === -1) {
+        throw new Error("Models must use provider:modelId syntax");
+    }
+    if (isDuetGatewayModelName(model)) {
+        const modelId = model.slice(separator + 1);
+        const resolved = resolveDuetGatewayModel(modelId);
+        if (!resolved) {
+            throw new Error(`Unknown duet-gateway model: ${modelId}`);
+        }
+        return resolved;
+    }
+    const provider = model.slice(0, separator);
+    const modelId = model.slice(separator + 1);
+    return getModel(provider, modelId);
+}
+function lookupProviderEnvVar(entry) {
+    if (entry.customEnvVar) {
+        return entry.customEnvVar() ?? undefined;
+    }
+    const envVars = findEnvKeys(entry.provider);
+    return envVars && envVars.length > 0 ? envVars[0] : undefined;
+}
+/**
+ * Same selection logic as resolveCliModel, but picks each provider's cheaper
+ * observational-memory model.
+ */
+export function resolveCliMemoryModel(memoryModelName, dotenvKeys) {
+    return resolveCliModelWith(memoryModelName, MEMORY_MODEL_PROVIDER_INFERENCE, dotenvKeys);
+}
+/**
+ * Resolve the user-visible model and report provenance so callers can show
+ * "inferred from ANTHROPIC_API_KEY in .env" etc.
+ */
+export function resolveCliModel(modelName, dotenvKeys) {
+    return resolveCliModelWith(modelName, MODEL_PROVIDER_INFERENCE, dotenvKeys);
+}
+function resolveCliModelWith(modelName, providerInference, dotenvKeys) {
+    if (modelName)
+        return { modelName, source: "explicit" };
+    const inferred = findInferredProviderEntry(providerInference);
+    if (inferred) {
+        return {
+            modelName: inferred.entry.model,
+            source: "inferred",
+            envVar: inferred.envVar,
+            fromDotenv: dotenvKeys.has(inferred.envVar),
+        };
+    }
+    return { modelName: providerInference[0].model, source: "default" };
+}
+function findInferredProviderEntry(providerInference) {
+    for (const entry of providerInference) {
+        const envVar = lookupProviderEnvVar(entry);
+        if (envVar)
+            return { entry, envVar };
+    }
+    return undefined;
+}
+export function describeModelResolution(resolution) {
+    if (resolution.source === "explicit")
+        return "explicit CLI flag";
+    if (resolution.source === "inferred") {
+        const where = resolution.fromDotenv ? "<workdir>/.env" : "shell environment";
+        return `inferred from ${resolution.envVar} in ${where}`;
+    }
+    return "built-in default (no provider env vars set)";
+}
+//# sourceMappingURL=index.js.map

package/dist/src/model-resolution/index.js.map

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

package/dist/src/session/session-manager.d.ts

@@ -0,0 +1,45 @@
+import type { TurnRunnerConfig } from "../types/config.js";
+import type { TurnEvent, TurnMode, TurnOptions } from "../types/protocol.js";
+import { Session, type SessionTurnRunner } from "./session.js";
+export declare const DEFAULT_DUET_DIR = ".duet";
+export declare const DEFAULT_DUET_HOME: string;
+export declare const DEFAULT_SESSION_STORAGE_DIR: string;
+export declare const DEFAULT_MEMORY_DB_PATH: string;
+export interface SessionManagerCreateInput {
+    /** Optional fixed id; the manager generates one when omitted. */
+    sessionId?: string;
+    /** Routing mode for the new session. */
+    mode?: TurnMode;
+    /**
+     * When provided, the manager dispatches this prompt as the first turn after
+     * setup completes. Omit to leave the session idle until the caller sends a
+     * prompt directly.
+     */
+    prompt?: string;
+    options?: TurnOptions;
+}
+export interface SessionManagerOptions {
+    sessionStoragePath?: string;
+    createRunner?: (sessionId: string) => SessionTurnRunner;
+}
+export type SessionManagerEvent = {
+    sessionId: string;
+    event: TurnEvent;
+};
+export type SessionManagerEventHandler = (event: SessionManagerEvent) => void;
+export declare class SessionManager {
+    private readonly options;
+    private readonly sessions;
+    private readonly eventHandlers;
+    private readonly sessionStoragePath;
+    readonly config: TurnRunnerConfig;
+    constructor(config: TurnRunnerConfig, options?: SessionManagerOptions);
+    subscribe(handler: SessionManagerEventHandler): () => void;
+    create(input: SessionManagerCreateInput): Session;
+    get(sessionId: string): Session | undefined;
+    resume(sessionId: string): Session;
+    dispose(): Promise<void>;
+    private createSession;
+    private emit;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/src/session/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/session/session-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE/D,eAAO,MAAM,gBAAgB,UAAU,CAAC;AACxC,eAAO,MAAM,iBAAiB,QAAoC,CAAC;AACnE,eAAO,MAAM,2BAA2B,QAAsC,CAAC;AAC/E,eAAO,MAAM,sBAAsB,QAAuC,CAAC;AAE3E,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,iBAAiB,CAAC;CACzD;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAE9E,qBAAa,cAAc;IAQvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAGhC,MAAM,EAAE,gBAAgB,EACP,OAAO,GAAE,qBAA0B;IAMtD,SAAS,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,IAAI;IAO1D,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO;IAkBjD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQ5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,IAAI;CAKb"}