@duetso/agent 0.2.6 → 0.3.1

package/dist/src/cli/connect.js

@@ -0,0 +1,265 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+import { printConnectHelp } from "./help.js";
+import { usageError } from "./shared.js";
+import { probeConnectedProvider, } from "../connected-providers/capability-probe.js";
+import { installFakeIssuerIfConfigured } from "../connected-providers/fake-issuer.js";
+import { connectedProviders, resolveConnectedProviderAlias, } from "../connected-providers/registry.js";
+import { createConnectedProviderStore, } from "../connected-providers/store.js";
+export async function runConnectCommand(args, io = {}) {
+    const write = io.write ?? ((text) => process.stdout.write(text));
+    const writeError = io.writeError ?? ((text) => process.stderr.write(text));
+    const store = io.store ?? createConnectedProviderStore();
+    let status = false;
+    let json = false;
+    let deviceCode = false;
+    let noBrowser = false;
+    let disconnect;
+    let target;
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        switch (arg) {
+            case "--status":
+                status = true;
+                break;
+            case "--json":
+                json = true;
+                break;
+            case "--device-code":
+                deviceCode = true;
+                break;
+            case "--no-browser":
+                noBrowser = true;
+                break;
+            case "--disconnect": {
+                const value = args[++index];
+                if (!value || value.startsWith("-"))
+                    usageError("Missing value for --disconnect");
+                disconnect = resolveProvider(value);
+                break;
+            }
+            case "--help":
+            case "-h":
+                (io.printHelp ?? printConnectHelp)();
+                return;
+            default:
+                if (arg.startsWith("-"))
+                    usageError(`Unknown connect option: ${arg}`);
+                if (target !== undefined)
+                    usageError(`Unexpected connect argument: ${arg}`);
+                target = resolveProvider(arg);
+        }
+    }
+    if (!status && disconnect === undefined && target === undefined) {
+        if (json)
+            usageError("--json requires --status or a provider");
+        (io.printHelp ?? printConnectHelp)();
+        return;
+    }
+    const operationCount = Number(status) + Number(disconnect !== undefined) + Number(target !== undefined);
+    if (operationCount > 1)
+        usageError("Choose one of provider login, --status, or --disconnect");
+    if ((deviceCode || noBrowser) && target === undefined) {
+        usageError("--device-code and --no-browser require a provider login");
+    }
+    if (disconnect !== undefined) {
+        const existing = await store.get(disconnect);
+        if (!existing)
+            usageError(`${providerLabel(disconnect)} is not connected`);
+        await store.remove(disconnect);
+        if (json)
+            writeEvent(write, { type: "complete", provider: disconnect, state: "disconnected" });
+        else
+            write(`Disconnected ${providerLabel(disconnect)}.\n`);
+        return;
+    }
+    if (status) {
+        const connections = await store.read();
+        if (json) {
+            write(`${JSON.stringify({ connections: connections.map(toStatusJson) })}\n`);
+            return;
+        }
+        if (connections.length === 0) {
+            write("No connected providers. Run `duet connect chatgpt`.\n");
+            return;
+        }
+        write(`${connections.map(formatConnection).join("\n")}\n`);
+        return;
+    }
+    if (target !== undefined) {
+        await connectProvider(target, {
+            ...io,
+            store,
+            write,
+            writeError,
+            json,
+            // --no-browser only suppresses URL auto-open; it never changes the
+            // OAuth flow. Device-code mode is forced by --device-code, machine
+            // output, or a non-interactive stdin.
+            forceDeviceCode: deviceCode || json || !(io.interactive ?? Boolean(process.stdin.isTTY)),
+            noBrowser,
+        });
+    }
+}
+function resolveProvider(value) {
+    return resolveConnectedProviderAlias(value) ?? usageError(`Unknown connected provider: ${value}`);
+}
+function toStatusJson(connection) {
+    return {
+        provider: connection.provider,
+        connectedAt: connection.connectedAt,
+        eligibility: connection.eligibility,
+        ...(connection.eligibilityCheckedAt === undefined
+            ? {}
+            : { eligibilityCheckedAt: connection.eligibilityCheckedAt }),
+        ...(connection.lastRefreshAt === undefined ? {} : { lastRefreshAt: connection.lastRefreshAt }),
+    };
+}
+function formatConnection(connection) {
+    const state = connection.eligibility === "plan_ineligible" ? "plan not eligible" : "connected";
+    return `${providerLabel(connection.provider)} — ${state}`;
+}
+function providerLabel(provider) {
+    return connectedProviders().find(({ id }) => id === provider)?.label ?? provider;
+}
+async function connectProvider(id, options) {
+    installFakeIssuerIfConfigured(options.env ?? process.env);
+    const entry = connectedProviders().find((candidate) => candidate.id === id);
+    if (!entry)
+        throw new Error("Connected provider is not registered.");
+    const now = options.now ?? (() => Date.now());
+    const emit = (event) => writeEvent(options.write, event);
+    let credentials;
+    try {
+        credentials = await entry.oauth().login({
+            onAuth: ({ url }) => {
+                options.writeError(`Open ${url} to connect ${entry.label}.\n`);
+                if (!options.noBrowser)
+                    openUrl(url, options.openUrl);
+            },
+            onDeviceCode: ({ userCode, verificationUri, expiresInSeconds }) => {
+                if (options.json) {
+                    emit({
+                        type: "device_code",
+                        provider: id,
+                        verificationUri,
+                        userCode,
+                        expiresAt: now() + (expiresInSeconds ?? 900) * 1000,
+                    });
+                }
+                else {
+                    options.writeError(`User code: ${userCode}\nVerification URL: ${verificationUri}\n`);
+                }
+                if (!options.noBrowser && !options.json)
+                    openUrl(verificationUri, options.openUrl);
+            },
+            onPrompt: async ({ message, allowEmpty }) => {
+                if (id === "github-copilot" && allowEmpty && !options.prompt)
+                    return "";
+                return (options.prompt ?? promptInput)(message);
+            },
+            onProgress: () => {
+                if (!options.json)
+                    options.writeError(`Connecting ${entry.label}…\n`);
+            },
+            onSelect: async () => (options.forceDeviceCode ? "device_code" : "browser"),
+        });
+    }
+    catch (error) {
+        const code = loginErrorCode(error);
+        if (options.json)
+            emit({ type: "error", provider: id, code });
+        throw new Error(loginErrorMessage(code));
+    }
+    if (options.json)
+        emit({ type: "progress", provider: id, code: "probing_capability" });
+    else
+        options.writeError(`Checking ${entry.label} plan eligibility…\n`);
+    const result = await runProbe(options.probe ?? probeConnectedProvider, id, credentials);
+    const checkedAt = now();
+    await options.store.withLock(id, async () => ({
+        next: {
+            provider: id,
+            credentials,
+            connectedAt: checkedAt,
+            eligibility: result.eligibility,
+            eligibilityCheckedAt: checkedAt,
+        },
+        result: undefined,
+    }));
+    if (result.eligibility === "unknown") {
+        if (options.json)
+            emit({ type: "error", provider: id, code: "capability_unknown" });
+        throw new Error(`${entry.label} connected, but plan eligibility could not be confirmed.`);
+    }
+    const state = result.eligibility === "eligible" ? "connected" : "plan_ineligible";
+    if (options.json) {
+        emit({ type: "complete", provider: id, state });
+        return;
+    }
+    if (result.eligibility === "plan_ineligible") {
+        options.write(`Connected ${entry.label} — plan not eligible.\n`);
+        return;
+    }
+    const coverage = result.servedModelIds.length
+        ? ` — plan covers ${result.servedModelIds.join(", ")}`
+        : "";
+    options.write(`Connected ${entry.label}${coverage}.\n`);
+}
+async function runProbe(probe, id, credentials) {
+    try {
+        return await probe(id, credentials);
+    }
+    catch {
+        return {
+            eligibility: "unknown",
+            servedModelIds: [],
+            detail: "Capability probe request failed.",
+        };
+    }
+}
+function writeEvent(write, event) {
+    write(`${JSON.stringify(event)}\n`);
+}
+function loginErrorCode(error) {
+    const message = error instanceof Error ? error.message.toLowerCase() : "";
+    if (message.includes("denied"))
+        return "login_denied";
+    if (message.includes("expired") || message.includes("timed out"))
+        return "login_expired";
+    if (message.includes("cancel"))
+        return "login_cancelled";
+    return "login_failed";
+}
+function loginErrorMessage(code) {
+    switch (code) {
+        case "login_denied":
+            return "Connected-provider login was denied.";
+        case "login_expired":
+            return "Connected-provider device code expired.";
+        case "login_cancelled":
+            return "Connected-provider login was cancelled.";
+        default:
+            return "Connected-provider login failed.";
+    }
+}
+function openUrl(url, override) {
+    if (override) {
+        override(url);
+        return;
+    }
+    const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "explorer" : "xdg-open";
+    const child = spawn(command, [url], { detached: true, stdio: "ignore" });
+    child.on("error", () => undefined);
+    child.unref();
+}
+async function promptInput(message) {
+    const terminal = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        return await terminal.question(`${message} `);
+    }
+    finally {
+        terminal.close();
+    }
+}
+//# sourceMappingURL=connect.js.map

package/dist/src/cli/connect.js.map

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

package/dist/src/cli/help.d.ts

@@ -7,6 +7,7 @@
 export declare const DEFAULT_RESUME_HISTORY_MESSAGES = 5;
 export declare function printRunHelp(packageName: string): void;
 export declare function printLoginHelp(): void;
+export declare function printConnectHelp(): void;
 export declare function printEnvHelp(): void;
 export declare function printSkillsHelp(): void;
 export declare function printMemoryHelp(): void;

package/dist/src/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/cli/help.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA6FtD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAqBrC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAsBnC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAqBtC;AAED,wBAAgB,eAAe,IAAI,IAAI,CA4DtC;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CA8BzC;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAwC5C;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAuC7C;AAED,wBAAgB,cAAc,IAAI,IAAI,CAsCrC;AAED,wBAAgB,cAAc,IAAI,IAAI,CAgErC;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAiB5C;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAe1D"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/cli/help.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA+FtD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAqBrC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAiBvC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAsBnC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAqBtC;AAED,wBAAgB,eAAe,IAAI,IAAI,CA4DtC;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAgCzC;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CA0C5C;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAuC7C;AAED,wBAAgB,cAAc,IAAI,IAAI,CAsCrC;AAED,wBAAgB,cAAc,IAAI,IAAI,CA0ErC;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAiB5C;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAe1D"}

package/dist/src/cli/help.js

@@ -13,6 +13,7 @@ duet — An opinionated full-stack agent runner
 USAGE
   duet [options] [prompt]
   duet login --workspace <slug> [--no-browser]
+  duet connect [--status [--json] | --disconnect <provider>]
   duet env [--env-file <path>] [--import [path]|--keys]
   duet skills [--workdir <path>]
   duet memory [--db <path>] [--json] [filters]
@@ -23,6 +24,7 @@ USAGE
 
 COMMANDS
   login                    Sign in via device flow; saves a workspace-scoped DUET_API_KEY (recommended)
+  connect                  Show or remove connected ChatGPT and GitHub Copilot subscriptions
   env                      Manually create or update the shared duet env file with provider API keys
   skills                   List installed skills + collisions as JSON
   memory                   Browse memories in a TUI, or query them with --json/filters (alias: memories)
@@ -68,7 +70,7 @@ INTERACTIVE
 MODELS
   The default is the routed frontier tier. Use frontier, balanced, or economy
   to select a routing policy, or a concrete shorthand to bypass routing and pin.
-  Concrete names include opus-4.8, sonnet-4.6, haiku-4.5, and gpt-5.5.
+  Concrete names include opus, sonnet, haiku, and sol (versionless families), or versioned forms like opus-4.8.
   They map to the first configured router that supports that model.
   Full provider:modelId syntax is also supported, e.g. duet:anthropic/claude-opus-4.8.
   --provider pins that provider's concrete default; the memory model remains concrete.
@@ -80,7 +82,7 @@ MODELS
 
 EXAMPLES
   duet "build a REST API with Express and TypeScript"
-  duet -m gpt-5.5 "analyze the performance of our test suite"
+  duet -m sol "analyze the performance of our test suite"
   duet --memory-model sonnet-4.6 "summarize this repo"
   duet --provider openrouter "explain this codebase"
   duet --provider duet "refactor the auth module"
@@ -93,7 +95,7 @@ EXAMPLES
   duet login --workspace acme
   duet env
   duet memory
-  duet model -m openai/gpt-5.5 "write a haiku about gateways"
+  duet model -m openai/gpt-5.6-sol "write a haiku about gateways"
   duet model -m black-forest-labs/flux-1.1-pro -o art.png "a fox in snow"
   duet train ./docs/my-project
   duet send-feedback "the TUI flickers when..."
@@ -122,6 +124,24 @@ OVERRIDES
   login. Model traffic uses DUET_GATEWAY_BASE_URL.
 `);
 }
+export function printConnectHelp() {
+    console.log(`
+duet connect — Manage connected model-provider subscriptions
+
+USAGE
+  duet connect <chatgpt|copilot> [--device-code] [--no-browser] [--json]
+  duet connect --status [--json]
+  duet connect --disconnect <chatgpt|copilot> [--json]
+
+OPTIONS
+  --device-code            Force device-code login (the only VM-valid mode)
+  --no-browser             Do not open the verification URI automatically
+  --status                 List connected providers
+  --json                   Stream login/disconnect events as NDJSON; status stays an envelope
+  --disconnect <provider>  Remove stored credentials for chatgpt or copilot
+  -h, --help               Show this help
+`);
+}
 export function printEnvHelp() {
     console.log(`
 duet env — Create or update a shared duet env file
@@ -233,14 +253,14 @@ export function printMemoryAddHelp() {
 duet memory add — Write a single user-added note memory
 
 USAGE
-  duet memory add [options] <content>
-  echo "<content>" | duet memory add [options]
+  duet memory add [options] [--store <folder> | --db <file>] <content>
+  echo "<content>" | duet memory add [options] [--store <folder> | --db <file>]
 
 DESCRIPTION
-  Stores a note memory into the same ~/.duet/memory.db the runner reads, so
-  it surfaces in the next session. Notes get a small ranking bump above
-  reflections (far below a 'duet train' corpus) and stay eligible for
-  'duet memory reflect' compaction, folding like any observation once aged.
+  Stores a note in exactly one backend. With no backend flag, the note is
+  written to the nearest ancestor .agents/memories directory (created on
+  demand). --store writes a markdown memory file; --db retains the legacy
+  observational-row behavior. Passing more than one backend is a usage error.
 
   Content comes from the positional arguments, or from stdin when none are
   given so longer memories can be piped in.
@@ -251,9 +271,11 @@ OPTIONS
   --session <id>           Stamp the row's authoring session; omit to leave it
                            global/unattributed
   --tag <tag>              Attach a label; repeat to add several
-  --db <path>              Memory database path (default: ~/.duet/memory.db)
-  --json                   Emit the stored memory as one canonical JSON object
-                           (with packScore) instead of the confirmation line
+  --store <folder>         Memory-file directory to write
+  --db <file>              PGlite file to write instead of a memory store
+  --json                   Emit the stored memory as JSON instead of the
+                           confirmation line (DB rows include packScore;
+                           file rows include slug + store provenance)
   --wait <seconds>         Seconds to wait for the cross-process open-lock
                            (default: 30; 0 fails immediately)
   -h, --help               Show this help
@@ -295,6 +317,8 @@ OPTIONS
   --json                   Emit a bare JSON array of canonical memory objects
                            (best-first) with packScore + relevanceScore
   --db <path>              Memory database path (default: ~/.duet/memory.db)
+                           This command is DB-only; --store is rejected because
+                           store memories are already loaded into agent context
   --wait <seconds>         Seconds to wait for the cross-process open-lock
                            (default: 30; 0 fails immediately)
   -h, --help               Show this help
@@ -356,7 +380,7 @@ DESCRIPTION
   generations write files and print each path. Auth uses DUET_API_KEY.
 
 OPTIONS
-  -m, --model <name>       Gateway model id, e.g. openai/gpt-5.5 (required)
+  -m, --model <name>       Gateway model id, e.g. openai/gpt-5.6-sol (required)
   --type text|image|video  Override the catalog-inferred request type
   --image <path>           Input image: vision context (text), edit source
                            (image), or still to animate (video)
@@ -373,7 +397,7 @@ OPTIONS
   -h, --help               Show this help
 
 EXAMPLES
-  duet model -m openai/gpt-5.5 "write a haiku about gateways"
+  duet model -m openai/gpt-5.6-sol "write a haiku about gateways"
   duet model -m bfl/flux-pro-1.1 -o art.png "a fox in snow"
   duet model -m google/gemini-2.5-flash-image --type image --image src.png "add a hat"
   duet model -m bytedance/seedance-2.0 --type video -o clip.mp4 "slow pan over dunes"
@@ -384,11 +408,13 @@ export function printTrainHelp() {
 duet train — Ingest a project corpus into one durable memory observation
 
 USAGE
-  duet train <folder> [--slug <name>] [--model <name>] [--db <path>] [--wait <seconds>]
-  duet train list [--db <path>] [--json] [--wait <seconds>]
-  duet train show <slug> [--db <path>] [--json] [--wait <seconds>]
-  duet train update <slug> --content-file <path> [--db <path>] [--json] [--wait <seconds>]
-  duet train delete <slug> [--db <path>] [--json] [--wait <seconds>]
+  duet train <folder> [--slug <name>] [--model <name>]
+             [--store <folder> | --db <file>] [--wait <seconds>]
+  duet train list [--store <folder>]... [--db <file>]... [--json] [--wait <seconds>]
+  duet train show <slug> [--store <folder>]... [--db <file>]... [--json] [--wait <seconds>]
+  duet train update <slug> --content-file <path>
+             [--store <folder>]... [--db <file>]... [--json] [--wait <seconds>]
+  duet train delete <slug> [--store <folder>]... [--db <file>]... [--json] [--wait <seconds>]
 
 DESCRIPTION
   Launches a duet agent with the corpus folder as its working directory.
@@ -399,15 +425,23 @@ DESCRIPTION
 
     .duet-train.json  — structured handoff with headline + observation.
 
-  'train' then persists the synthesis into ~/.duet/memory.db as a manual
-  (user-curated) row (tagged 'train' and 'train:<slug>'), archives the
-  corpus under ~/.duet/train/<memory-id>/, removes the handoff file, and
-  prints the observation content to stdout so what you see is what landed
-  in memory.
+  'train' then persists the synthesis into exactly one backend and archives
+  the corpus under ~/.duet/train/<memory-id>/. With no backend flag it writes
+  a markdown file under the nearest ancestor .agents/memories directory,
+  creating that directory when needed. --db retains the legacy manual-row
+  behavior. Passing more than one backend to create is a usage error.
+
+  Reads accept repeatable --store and --db flags. Any explicit backend flags
+  replace discovery; stores are consulted in flag order before DBs. Without
+  flags, reads union inherited stores from cwd toward the filesystem root,
+  then ~/.duet/memory.db. Duplicate slugs resolve to the first source, while
+  surviving entries are listed newest-first. show/update/delete use that same
+  first-source precedence.
 
   The management subcommands all key on the user-facing <slug> (resolved
   to the underlying row internally):
-    list    — every training (one row per slug), joined to its archive
+    list    — every visible store entry or DB training (one row per slug),
+              joined to its archive
               manifest to show slug, headline, model, file count, date,
               and memory id.
     show    — the same metadata plus the full synthesized observation text
@@ -419,17 +453,17 @@ DESCRIPTION
     delete  — permanently remove the row and its corpus archive.
   Pass --json to any of them for machine-readable output.
 
-  Subsequent runs against the same slug replace the prior row in place,
-  so the memory pool does not bloat. Writing the row as a manual row
-  earns it a ranking boost in the memory pack (via manualBias) and exempts
-  it from 'duet memory reflect' compaction; deleting it via 'duet memory'
-  also removes its archive. Note: train loads the corpus folder's .env (for provider
-  credentials), so check folders you did not author before training.
+  Subsequent runs against the same slug replace the prior target entry, so
+  the memory pool does not bloat. On --db, the legacy manual row keeps its
+  ranking boost and reflection exemption. Note: train loads the corpus
+  folder's .env (for provider credentials), so check folders you did not
+  author before training.
 
 OPTIONS
   --slug <name>            Override the corpus slug (default: sanitized folder basename)
   --model <name>           Model used by the synthesis sub-agent (default: same resolution as 'duet run')
-  --db <path>              Memory database path (default: ~/.duet/memory.db)
+  --store <folder>         Memory-file directory; repeat on read/manage commands
+  --db <file>              PGlite path; repeat on read/manage commands
   --wait <seconds>         Seconds to wait for the cross-process open-lock
                            (default: 30; 0 fails immediately)
   -h, --help               Show this help

package/dist/src/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAEjD,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;gDAuBkC,WAAW;;;;;;;;;;;;;gHAaqD,+BAA+B;;;;;oFAK3D,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDxG,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;wEAY0D,qBAAqB;;;;;;;CAO5F,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;yDAa2C,qBAAqB;;;;;;IAM1E,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;CAChC,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;CAmBb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Db,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Bb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Db,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;CAeb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,CAAC,GAAG,CAAC;oCACsB,WAAW;;;;;;;;;;;;CAY9C,CAAC,CAAC;AACH,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAEjD,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;gDAyBkC,WAAW;;;;;;;;;;;;;gHAaqD,+BAA+B;;;;;oFAK3D,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDxG,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;wEAY0D,qBAAqB;;;;;;;CAO5F,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;CAeb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;yDAa2C,qBAAqB;;;;;;IAM1E,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;CAChC,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;CAmBb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Db,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Bb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;CAeb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,CAAC,GAAG,CAAC;oCACsB,WAAW;;;;;;;;;;;;CAY9C,CAAC,CAAC;AACH,CAAC"}

package/dist/src/cli/memory-add.d.ts

@@ -1,7 +1,11 @@
 import { type EmbedFn } from "../memory/embedding.js";
+import { type MemorySourceFlags } from "../memory/store/sources.js";
 import type { ObservationPriority, ObservationSource } from "../types/memory.js";
 type SourceKind = ObservationSource["kind"];
 interface AddCommandOptions {
+    /** Explicit backend flags; empty means flagless store discovery. */
+    sourceFlags: MemorySourceFlags;
+    /** Compatibility projection for callers that inspect a single selected DB. */
     dbPath: string;
     /** Positional content joined with spaces; empty when the caller pipes via stdin instead. */
     content: string;
@@ -11,7 +15,7 @@ interface AddCommandOptions {
     tags: string[];
     /** Session that authored the row; omitted leaves the row global/unattributed. */
     sessionId?: string;
-    /** Emit one canonical memory JSON object instead of the human line. */
+    /** Emit the selected backend's JSON record instead of the human line. */
     json: boolean;
     waitBudgetMs?: number;
 }
@@ -20,6 +24,8 @@ interface AddCommandIO {
     stdin: NodeJS.ReadableStream & {
         isTTY?: boolean;
     };
+    /** Working directory used for relative paths and flagless source discovery. */
+    cwd?: string;
     /**
      * Embedding client for the synchronous insert-time embed. Defaults to
      * the Duet endpoint client; tests inject a stub (or a throwing one) to
@@ -28,21 +34,20 @@ interface AddCommandIO {
     embed?: EmbedFn;
 }
 /**
- * Run `duet memory add` — write a single user-added note row into the same
- * `~/.duet/memory.db` the runner reads from, so it surfaces in the next
- * session. Stored as `kind: "note"` with no `sessionId`, so it lands in the
- * cross-session global pack with a small `noteBias` bump (above reflections,
- * far below a `duet train` corpus) and stays eligible for `duet memory
- * reflect` compaction, folding like any other observation once aged.
+ * Run `duet memory add` — write one curated note to a memory-file store or
+ * the legacy observational DB. Flagless writes create the nearest agent's
+ * `.agents/memories` directory. DB notes retain their ranking, reflection,
+ * session-attribution, and synchronous-embedding behavior; file notes retain
+ * priority/source/tags in frontmatter and are loaded through store context.
  *
  * Content comes from the positional arguments, or from stdin when none are
  * given so callers can pipe longer text (`echo "…" | duet memory add`).
  *
- * The embedding is written synchronously alongside the row (no backfill
- * worker runs in this one-shot process), so `duet memory recall` and the
- * next session's `recall_memory` reach it semantically right away. When
- * embeddings are unavailable the add still succeeds and the next runner's
- * backfill pass embeds the row.
+ * For DB targets, the embedding is written synchronously alongside the row
+ * (no backfill worker runs in this one-shot process), so `duet memory recall`
+ * and the next session's `recall_memory` reach it semantically right away.
+ * When embeddings are unavailable the add still succeeds and the next
+ * runner's backfill pass embeds the row.
  */
 export declare function runMemoryAddCommand(args: string[], io?: AddCommandIO): Promise<void>;
 /**
@@ -50,6 +55,6 @@ export declare function runMemoryAddCommand(args: string[], io?: AddCommandIO):
  * when `--help` was handled. Pure (no I/O) so it can be unit-tested; stdin
  * fallback for empty content happens later in {@link resolveContent}.
  */
-export declare function parseMemoryAddArgs(args: string[]): AddCommandOptions | undefined;
+export declare function parseMemoryAddArgs(args: string[], cwd?: string): AddCommandOptions | undefined;
 export {};
 //# sourceMappingURL=memory-add.d.ts.map

package/dist/src/cli/memory-add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-add.d.ts","sourceRoot":"","sources":["../../../src/cli/memory-add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAOjF,KAAK,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE5C,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,yEAAyE;IACzE,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,YAA+D,GAClE,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,GAAG,SAAS,CA+DhF"}
+{"version":3,"file":"memory-add.d.ts","sourceRoot":"","sources":["../../../src/cli/memory-add.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAYjF,KAAK,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE5C,UAAU,iBAAiB;IACzB,oEAAoE;IACpE,WAAW,EAAE,iBAAiB,CAAC;IAC/B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,yEAAyE;IACzE,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,YAA+D,GAClE,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,MAAsB,GAC1B,iBAAiB,GAAG,SAAS,CAiE/B"}