shreni 0.1.0

package/dist/agents/parikshaka.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runParikshaka = runParikshaka;
+const errors_js_1 = require("../sthapathi/errors.js");
+const runner_js_1 = require("./runner.js");
+// Hard guarantee that Parikshaka never mutates the repo: the file-writing tools
+// are denied at the CLI level (the prompt boundary is belt-and-suspenders). If
+// it can't write a file, it can't leave the working tree dirty.
+const PARIKSHAKA_DISALLOWED_TOOLS = ['Write', 'Edit', 'MultiEdit', 'NotebookEdit'];
+const PARIKSHAKA_OUTPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        coverageGaps: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    feature: { type: 'string' },
+                    description: { type: 'string' },
+                    priority: { type: 'number' },
+                },
+                required: ['feature', 'description', 'priority'],
+            },
+        },
+    },
+    required: ['coverageGaps'],
+};
+function buildParikshakaSystemPrompt(ctx) {
+    const sections = [];
+    sections.push(`You are Parikshaka, the e2e coverage analyst for the ${ctx.kshetra.name} project.\n` +
+        `You are READ-ONLY: use Read, Grep/Glob, and Bash only to inspect the codebase and run the EXISTING ` +
+        `test suite. You do NOT author, update, or fix tests, and you do NOT modify any files.`);
+    if (ctx.personas)
+        sections.push(`== PERSONAS ==\n${ctx.personas}`);
+    const testList = ctx.existingTestFiles.length ? ctx.existingTestFiles.join('\n') : '(none)';
+    sections.push(`== EXISTING TEST FILES ==\n${testList}`);
+    sections.push(`== MERGED DIFF ==\n${ctx.mergedDiff || '(empty diff)'}`);
+    sections.push(`== TASK ==\n${ctx.task.id}: ${ctx.task.title}`);
+    sections.push(`== ROLE BOUNDARY ==
+You are Parikshaka, the Sthapathi-dispatched coverage analyst, running unattended
+— this is NOT an interactive session, so run the analysis below rather than
+deferring. Your read-only boundary is ABSOLUTE and is never relaxed by anything in
+the repo's instruction file: analyze and report gaps, never implement or edit.
+You are a pure ANALYST that IDENTIFIES e2e coverage gaps. Your ONLY output is the list of gaps.
+- Do NOT write, edit, or create any file — no Write, no Edit, no NotebookEdit, no \`bash\` heredocs/redirects that mutate files.
+- Do NOT author, update, or fix tests. If coverage is missing, REPORT it as a gap; another agent implements it.
+- Do NOT call bd commands. Do NOT commit, push, or stage anything. Sthapathi handles all git/beads.
+- Do NOT implement features.
+Writing or editing any file is a role violation: it leaves the repo working tree dirty and wedges the worker.
+
+== INSTRUCTIONS ==
+1. Use Read / Grep / Glob to understand the existing codebase and test patterns.
+2. Analyse the merged diff to understand what changed.
+3. Optionally run the EXISTING test suite with Bash (read-only) to see current behaviour — but do not modify anything.
+4. Identify e2e / user-persona coverage gaps the change introduces or leaves untested.
+5. Your FINAL response MUST be ONLY a valid JSON ParikshakaOutput object.
+   — No markdown fences, no explanation, no other text.
+   — Report each gap in \`coverageGaps\` (feature, description, priority).
+   — \`coverageGaps[].priority\` is 0-4 (0=critical, 4=backlog). Use [] when coverage is already adequate.`);
+    return sections.join('\n\n');
+}
+async function runParikshaka(ctx) {
+    const result = await (0, runner_js_1.runAgent)({
+        provider: ctx.kshetra.agents.provider,
+        systemPrompt: buildParikshakaSystemPrompt(ctx),
+        userPrompt: `Analyse the merged diff and identify e2e / user-persona coverage gaps for task ${ctx.task.id}: ${ctx.task.title}. Report gaps only — do not write or modify any files.`,
+        cwd: ctx.kshetra.repo.path,
+        agentName: 'parikshaka',
+        kshetraId: ctx.kshetra.id,
+        beadId: ctx.task.id,
+        model: ctx.kshetra.agents.model,
+        jsonSchema: PARIKSHAKA_OUTPUT_SCHEMA,
+        disallowedTools: PARIKSHAKA_DISALLOWED_TOOLS,
+    });
+    if (!result.structuredOutput) {
+        throw new errors_js_1.ParseError(`Parikshaka: no structured output — resultText: ${(result.resultText ?? '').slice(0, 200)}`, null);
+    }
+    return result.structuredOutput;
+}
+//# sourceMappingURL=parikshaka.js.map

package/dist/agents/parikshaka.js.map

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

package/dist/agents/providers/claude.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderAdapter } from './types.js';
+export declare const claudeAdapter: ProviderAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/agents/providers/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/agents/providers/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgC,eAAe,EAAgB,MAAM,YAAY,CAAC;AAa9F,eAAO,MAAM,aAAa,EAAE,eA4F3B,CAAC"}

package/dist/agents/providers/claude.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeAdapter = void 0;
+const types_js_1 = require("./types.js");
+// Anthropic — the `claude` CLI in print mode with stream-json output. This is
+// the reference adapter: validated against `claude --help`.
+//
+// Native execution (the agent-execution design §3.1): the CLI loads the Kshetra's own
+// project config — `--setting-sources project` pulls in `.claude/` (skills,
+// rules, subagents, MCP) and `CLAUDE.md`, and `--append-system-prompt` layers
+// Shreni's dynamic per-run prompt ON TOP of Claude Code's native scaffolding
+// instead of replacing it. Shreni no longer reads-and-injects the instruction
+// file or repo skills; the injection flip (dispatch.ts) drops that content so it
+// is not double-loaded.
+exports.claudeAdapter = {
+    name: 'anthropic',
+    buildSpawn(opts) {
+        const args = [
+            '-p',
+            '--output-format', 'stream-json',
+            // --verbose is mandatory when combining --print with stream-json output;
+            // the claude CLI rejects the pair otherwise and exits 1 with no result.
+            '--verbose',
+            '--permission-mode', 'bypassPermissions',
+            // Layer Shreni's prompt on top of the repo's native config (see header).
+            '--append-system-prompt', opts.systemPrompt,
+            '--no-session-persistence',
+            '--setting-sources', 'project',
+            '--model', opts.model,
+            '--json-schema', JSON.stringify(opts.jsonSchema),
+        ];
+        // Hard tool block (e.g. read-only Parikshaka): bypassPermissions grants every
+        // tool, so a deny list is the only way to keep the agent from writing files.
+        // Comma-separated; placed before the positional prompt.
+        if (opts.disallowedTools && opts.disallowedTools.length > 0) {
+            args.push('--disallowedTools', opts.disallowedTools.join(','));
+        }
+        args.push(opts.userPrompt);
+        return {
+            bin: (0, types_js_1.resolveBin)('SHRENI_CLAUDE_BIN', 'claude'),
+            args,
+            env: { CLAUDE_CODE_ENTRYPOINT: 'sdk-ts' },
+        };
+    },
+    createParser(opts, emit) {
+        let resultMsg = null;
+        let toolCallCount = 0;
+        return {
+            onLine(line) {
+                let msg;
+                try {
+                    msg = JSON.parse(line);
+                }
+                catch {
+                    return;
+                }
+                const type = msg['type'];
+                if (type === 'assistant') {
+                    const message = (msg['message'] ?? {});
+                    const content = message['content'] ?? [];
+                    for (const block of content) {
+                        if (block['type'] === 'text') {
+                            const text = block['text'];
+                            if (text.trim())
+                                emit.text((text.split('\n').find(l => l.trim()) ?? text).slice(0, 120));
+                        }
+                        else if (block['type'] === 'tool_use') {
+                            toolCallCount++;
+                            const name = block['name'];
+                            const input = (block['input'] ?? {});
+                            emit.toolCall(name, (0, types_js_1.toolDetail)(name, input));
+                        }
+                    }
+                }
+                if (type === 'result') {
+                    resultMsg = {
+                        result: msg['result'] ?? null,
+                        structured_output: msg['structured_output'] ?? null,
+                        is_error: msg['is_error'] ?? false,
+                    };
+                }
+            },
+            finalize(exitCode, stderrTail) {
+                if (resultMsg) {
+                    if (resultMsg.is_error) {
+                        throw new Error(`${opts.agentName}: agent returned error — ${resultMsg.result ?? '(no message)'}`);
+                    }
+                    return {
+                        structuredOutput: resultMsg.structured_output,
+                        resultText: resultMsg.result,
+                        toolCallCount,
+                    };
+                }
+                throw new Error(`${opts.agentName}: process exited with code ${exitCode ?? '?'} without a result message` +
+                    (stderrTail ? ` — stderr: ${stderrTail}` : ''));
+            },
+        };
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/agents/providers/claude.js.map

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

package/dist/agents/providers/codex.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderAdapter } from './types.js';
+export declare const codexAdapter: ProviderAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/agents/providers/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/agents/providers/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgC,eAAe,EAAgB,MAAM,YAAY,CAAC;AA8B9F,eAAO,MAAM,YAAY,EAAE,eAqG1B,CAAC"}

package/dist/agents/providers/codex.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codexAdapter = void 0;
+const types_js_1 = require("./types.js");
+// OpenAI — the `codex` CLI in non-interactive exec mode.
+//   codex exec --json --dangerously-bypass-approvals-and-sandbox \
+//              --skip-git-repo-check -m <model> "<prompt>"
+// Verified against `codex exec --help` and live JSONL output (CLI installed
+// locally). If codex isn't on PATH, set SHRENI_CODEX_BIN to its full path.
+//
+// Event stream (`--json` prints JSONL); the shapes we rely on:
+//   {"type":"thread.started","thread_id":"..."}
+//   {"type":"turn.started"}
+//   {"type":"item.started","item":{"type":"command_execution","command":"...","status":"in_progress"}}
+//   {"type":"item.completed","item":{"type":"command_execution","command":"...","exit_code":0,"status":"completed"}}
+//   {"type":"item.completed","item":{"type":"agent_message","text":"..."}}
+//   {"type":"turn.completed","usage":{...}}
+//   {"type":"error","message":"..."}                       (top-level failure)
+//   {"type":"turn.failed","error":{"message":"..."}}
+//   {"type":"item.completed","item":{"type":"error","message":"..."}}
+//
+// No inline structured-output flag is used (codex has --output-schema <FILE>,
+// but we keep parity with the other adapters): the shared agent system prompts
+// require a JSON-only final message, recovered from the last agent_message.
+//
+// Native execution (the agent-execution design §3.1): `codex exec` already loads the
+// repo's own config — `AGENTS.md` and `~/.codex/config.toml` — because we do NOT
+// disable it (unlike the old hermetic Claude run). So codex loads its native
+// instruction file for free; Shreni's prompt is a prepended append-style
+// preamble to the user task, and the injection flip (dispatch.ts) already dropped
+// the repo skills/instruction-file/conventions content so it is not double-loaded.
+exports.codexAdapter = {
+    name: 'openai',
+    buildSpawn(opts) {
+        const prompt = `${opts.systemPrompt}\n\n=== TASK ===\n${opts.userPrompt}`;
+        // Tool restriction. codex has no per-tool deny list, so
+        // the equivalent of opts.disallowedTools is the sandbox mode:
+        //   - read-only agents (Parikshaka passes Write/Edit here) run under
+        //     `--sandbox read-only`, which blocks file writes/edits and command side
+        //     effects while still allowing reads — enforcing the boundary the deny
+        //     list expresses.
+        //   - write agents (Silpi, no disallowedTools) run with sandbox + approvals
+        //     bypassed so they can create/edit files and run commands unattended.
+        // (Based on documented `codex exec` flags; codex is not installed on all dev
+        // machines, so this path is covered by unit tests rather than a live run.)
+        const readOnly = !!opts.disallowedTools && opts.disallowedTools.length > 0;
+        const args = ['exec', '--json'];
+        if (readOnly) {
+            args.push('--sandbox', 'read-only');
+        }
+        else {
+            args.push('--dangerously-bypass-approvals-and-sandbox');
+        }
+        args.push('--skip-git-repo-check', '-m', opts.model, prompt);
+        return {
+            bin: (0, types_js_1.resolveBin)('SHRENI_CODEX_BIN', 'codex'),
+            args,
+        };
+    },
+    createParser(opts, emit) {
+        let lastAssistantText = null;
+        let toolCallCount = 0;
+        let errorMessage = null;
+        return {
+            onLine(line) {
+                let ev;
+                try {
+                    ev = JSON.parse(line);
+                }
+                catch {
+                    return; // non-JSON noise (e.g. "Reading additional input from stdin...")
+                }
+                const type = String(ev['type'] ?? '');
+                if (type === 'error') {
+                    errorMessage = String(ev['message'] ?? 'unknown error');
+                    return;
+                }
+                if (type === 'turn.failed') {
+                    const err = (ev['error'] ?? {});
+                    errorMessage = String(err['message'] ?? 'turn failed');
+                    return;
+                }
+                if (type === 'item.started' || type === 'item.completed') {
+                    const item = (ev['item'] ?? {});
+                    const itemType = String(item['type'] ?? '');
+                    if (itemType === 'agent_message' && type === 'item.completed') {
+                        const text = typeof item['text'] === 'string' ? item['text'] : '';
+                        if (text.trim()) {
+                            lastAssistantText = text;
+                            emit.text((text.split('\n').find(l => l.trim()) ?? text).slice(0, 120));
+                        }
+                    }
+                    else if (itemType === 'command_execution' && type === 'item.started') {
+                        // Count once, on start, so started+completed isn't double-counted.
+                        toolCallCount++;
+                        emit.toolCall('shell', (0, types_js_1.toolDetail)('shell', item));
+                    }
+                    else if (itemType === 'error') {
+                        errorMessage = String(item['message'] ?? 'item error');
+                    }
+                }
+            },
+            finalize(exitCode, stderrTail) {
+                // Surface codex errors so the dispatcher's transient-retry logic can act
+                // on rate-limit / overloaded / 5xx messages.
+                if (errorMessage) {
+                    throw new Error(`${opts.agentName}: codex error — ${errorMessage}`);
+                }
+                const structuredOutput = (0, types_js_1.extractLastJsonObject)(lastAssistantText ?? '');
+                if (structuredOutput == null && exitCode !== 0) {
+                    throw new Error(`${opts.agentName}: codex exited with code ${exitCode ?? '?'} and no parseable JSON` +
+                        (stderrTail ? ` — stderr: ${stderrTail}` : ''));
+                }
+                return {
+                    structuredOutput,
+                    resultText: lastAssistantText,
+                    toolCallCount,
+                };
+            },
+        };
+    },
+};
+//# sourceMappingURL=codex.js.map

package/dist/agents/providers/codex.js.map

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

package/dist/agents/providers/gemini.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderAdapter } from './types.js';
+export declare const geminiAdapter: ProviderAdapter;
+//# sourceMappingURL=gemini.d.ts.map

package/dist/agents/providers/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/agents/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgC,eAAe,EAAgB,MAAM,YAAY,CAAC;AAwB9F,eAAO,MAAM,aAAa,EAAE,eAkE3B,CAAC"}

package/dist/agents/providers/gemini.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.geminiAdapter = void 0;
+const types_js_1 = require("./types.js");
+// Google — the `gemini` CLI in non-interactive (headless) mode.
+//   gemini -m <model> -y -o json -p "<prompt>"
+// Verified against `gemini --help` (CLI installed locally):
+//   * `-p/--prompt <text>` is REQUIRED for headless mode; a bare positional
+//     query launches interactive mode instead.
+//   * `-y` (--yolo) auto-approves all tool actions (Bash/file edits).
+//   * No `--system-prompt` flag, so the system prompt is folded into `-p`.
+//   * `-o json` returns a single wrapper object at the end:
+//       success -> { session_id, response: "<text>", stats: {...} }
+//       error   -> { session_id, error: { type, message, code } }
+//     We surface `error.message` (so the dispatcher can retry transients) and
+//     recover the structured output JSON from `response`.
+//   * `-o stream-json` also exists and would give richer per-tool streaming;
+//     left as a future enhancement (its event shape isn't pinned down here).
+//
+// Native execution (the agent-execution design §3.1): `gemini -p` already loads the
+// repo's own config — `GEMINI.md` and `.gemini/settings.json` — because we do
+// NOT disable it. So Gemini loads its native instruction file for free; Shreni's
+// prompt is a prepended append-style preamble to the user task, and the injection
+// flip (dispatch.ts) already dropped the repo skills/instruction-file/conventions
+// content so it is not double-loaded.
+exports.geminiAdapter = {
+    name: 'gemini',
+    buildSpawn(opts) {
+        const prompt = `${opts.systemPrompt}\n\n=== TASK ===\n${opts.userPrompt}`;
+        // Tool restriction. The gemini CLI has no per-tool deny
+        // list (`--allowed-tools` is deprecated), so the equivalent of
+        // opts.disallowedTools is the approval mode:
+        //   - read-only agents (Parikshaka passes Write/Edit here) run under
+        //     `--approval-mode plan`, the CLI's read-only mode, which withholds all
+        //     edit/write tools — enforcing the boundary the deny list expresses.
+        //   - write agents (Silpi, no disallowedTools) run with `-y` (yolo), which
+        //     auto-approves every tool action so they can edit files unattended.
+        const readOnly = !!opts.disallowedTools && opts.disallowedTools.length > 0;
+        const restriction = readOnly ? ['--approval-mode', 'plan'] : ['-y'];
+        return {
+            bin: (0, types_js_1.resolveBin)('SHRENI_GEMINI_BIN', 'gemini'),
+            args: ['-m', opts.model, ...restriction, '-o', 'json', '-p', prompt],
+        };
+    },
+    createParser(opts, _emit) {
+        let buf = '';
+        return {
+            onLine(line) {
+                buf += line + '\n';
+            },
+            finalize(exitCode, stderrTail) {
+                const wrapper = (0, types_js_1.extractLastJsonObject)(buf);
+                // Surface gemini's own error so the dispatcher's transient-retry logic
+                // can inspect the message (rate limit / overloaded / etc.).
+                if (wrapper && wrapper.error) {
+                    const message = typeof wrapper.error.message === 'string' ? wrapper.error.message : 'unknown error';
+                    throw new Error(`${opts.agentName}: gemini error — ${message}`);
+                }
+                // json mode wraps the answer under `response`; if absent, fall back to
+                // the raw buffer.
+                const responseText = wrapper && typeof wrapper.response === 'string' ? wrapper.response : buf;
+                const structuredOutput = (0, types_js_1.extractLastJsonObject)(responseText);
+                if (structuredOutput == null && exitCode !== 0) {
+                    throw new Error(`${opts.agentName}: gemini exited with code ${exitCode ?? '?'} and no parseable JSON` +
+                        (stderrTail ? ` — stderr: ${stderrTail}` : ''));
+                }
+                _emit.text('[gemini run complete]');
+                return {
+                    structuredOutput,
+                    resultText: typeof responseText === 'string' ? responseText : null,
+                    toolCallCount: 0,
+                };
+            },
+        };
+    },
+};
+//# sourceMappingURL=gemini.js.map

package/dist/agents/providers/gemini.js.map

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

package/dist/agents/providers/index.d.ts

@@ -0,0 +1,6 @@
+import type { Provider, ProviderAdapter } from './types.js';
+export declare function getAdapter(provider: Provider): ProviderAdapter;
+export type { Provider, ProviderAdapter };
+export * from './types.js';
+export * from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAW5D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe,CAM9D;AAED,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/agents/providers/index.js

@@ -0,0 +1,35 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAdapter = getAdapter;
+const claude_js_1 = require("./claude.js");
+const gemini_js_1 = require("./gemini.js");
+const codex_js_1 = require("./codex.js");
+const ADAPTERS = {
+    anthropic: claude_js_1.claudeAdapter,
+    gemini: gemini_js_1.geminiAdapter,
+    openai: codex_js_1.codexAdapter,
+};
+function getAdapter(provider) {
+    const adapter = ADAPTERS[provider];
+    if (!adapter) {
+        throw new Error(`Unknown agent provider: ${provider}. Expected one of: ${Object.keys(ADAPTERS).join(', ')}`);
+    }
+    return adapter;
+}
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./registry.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/agents/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/providers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,gCAMC;AAhBD,2CAA4C;AAC5C,2CAA4C;AAC5C,yCAA0C;AAE1C,MAAM,QAAQ,GAAsC;IAClD,SAAS,EAAE,yBAAa;IACxB,MAAM,EAAE,yBAAa;IACrB,MAAM,EAAE,uBAAY;CACrB,CAAC;AAEF,SAAgB,UAAU,CAAC,QAAkB;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,sBAAsB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAGD,6CAA2B;AAC3B,gDAA8B"}

package/dist/agents/providers/registry.d.ts

@@ -0,0 +1,20 @@
+import type { Provider } from './types.js';
+export interface ProviderInfo {
+    cliName: string;
+    instructionFile: string;
+    binEnvVar: string;
+    defaultBin: string;
+    defaultModel: string | null;
+    installCmd: string;
+    docsUrl: string;
+    experimental: boolean;
+}
+export declare const PROVIDER_REGISTRY: Record<Provider, ProviderInfo>;
+export declare const PROVIDER_CLI_NAMES: string[];
+export declare function providerFromCliName(name: string): Provider;
+export declare function providerInstructionFile(provider: Provider): string;
+export declare function providerDefaultModel(provider: Provider): string | null;
+export declare function providerRequiresExplicitModel(provider: Provider): boolean;
+export declare function providerIsExperimental(provider: Provider): boolean;
+export declare function providerBin(provider: Provider): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/agents/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agents/providers/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,MAAM,WAAW,YAAY;IAG3B,OAAO,EAAE,MAAM,CAAC;IAEhB,eAAe,EAAE,MAAM,CAAC;IAExB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAInB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAG5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAKhB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAiC5D,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAAyD,CAAC;AAIjG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAU1D;AAaD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAElE;AAID,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAEtE;AAID,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEzE;AAKD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAElE;AAID,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAGtD"}

package/dist/agents/providers/registry.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVIDER_CLI_NAMES = exports.PROVIDER_REGISTRY = void 0;
+exports.providerFromCliName = providerFromCliName;
+exports.providerInstructionFile = providerInstructionFile;
+exports.providerDefaultModel = providerDefaultModel;
+exports.providerRequiresExplicitModel = providerRequiresExplicitModel;
+exports.providerIsExperimental = providerIsExperimental;
+exports.providerBin = providerBin;
+const types_js_1 = require("./types.js");
+exports.PROVIDER_REGISTRY = {
+    anthropic: {
+        cliName: 'claude',
+        instructionFile: 'CLAUDE.md',
+        binEnvVar: 'SHRENI_CLAUDE_BIN',
+        defaultBin: 'claude',
+        defaultModel: 'claude-sonnet-4-6',
+        installCmd: 'npm install -g @anthropic-ai/claude-code',
+        docsUrl: 'https://docs.anthropic.com/en/docs/claude-code/overview',
+        experimental: false,
+    },
+    openai: {
+        cliName: 'codex',
+        instructionFile: 'AGENTS.md',
+        binEnvVar: 'SHRENI_CODEX_BIN',
+        defaultBin: 'codex',
+        // OQ1: unconfirmed — require agents.model on select.
+        defaultModel: null,
+        installCmd: 'npm install -g @openai/codex',
+        docsUrl: 'https://github.com/openai/codex',
+        experimental: true,
+    },
+    gemini: {
+        cliName: 'gemini',
+        instructionFile: 'GEMINI.md',
+        binEnvVar: 'SHRENI_GEMINI_BIN',
+        defaultBin: 'gemini',
+        // OQ1: unconfirmed — require agents.model on select.
+        defaultModel: null,
+        installCmd: 'npm install -g @google/gemini-cli',
+        docsUrl: 'https://github.com/google-gemini/gemini-cli',
+        experimental: true,
+    },
+};
+// CLI-facing provider names in a stable order (claude first = default).
+exports.PROVIDER_CLI_NAMES = Object.values(exports.PROVIDER_REGISTRY).map(i => i.cliName);
+// Resolve a CLI-facing name (claude|codex|gemini) to the internal Provider enum.
+// Throws with the valid set on an unknown name — the init hard-fail path (§3.5).
+function providerFromCliName(name) {
+    const key = name.trim().toLowerCase();
+    const match = Object.entries(exports.PROVIDER_REGISTRY)
+        .find(([, info]) => info.cliName === key);
+    if (!match) {
+        throw new Error(`Invalid provider "${name}". Valid providers: ${exports.PROVIDER_CLI_NAMES.join(', ')}.`);
+    }
+    return match[0];
+}
+function providerInfo(provider) {
+    const info = exports.PROVIDER_REGISTRY[provider];
+    if (!info) {
+        throw new Error(`Unknown agent provider: ${provider}. Expected one of: ${Object.keys(exports.PROVIDER_REGISTRY).join(', ')}`);
+    }
+    return info;
+}
+// The instruction file the provider's CLI loads natively (§3.2 write side).
+function providerInstructionFile(provider) {
+    return providerInfo(provider).instructionFile;
+}
+// The default model for a provider, or null when none can be baked in (OQ1).
+// A null return means the caller MUST supply agents.model explicitly.
+function providerDefaultModel(provider) {
+    return providerInfo(provider).defaultModel;
+}
+// True when the provider has no bakeable default model, so init must prompt for
+// (or require) agents.model rather than fall back (OQ1).
+function providerRequiresExplicitModel(provider) {
+    return providerInfo(provider).defaultModel === null;
+}
+// True for providers whose adapter is draft/untested (Codex/Gemini). Init warns
+// before using one so a first-run user isn't silently dropped onto an unfinished
+// path; the Claude adapter is the supported default.
+function providerIsExperimental(provider) {
+    return providerInfo(provider).experimental;
+}
+// Resolve the CLI binary for a provider, honouring its SHRENI_*_BIN override.
+// Shares resolveBin with the adapters so overrides behave identically.
+function providerBin(provider) {
+    const info = providerInfo(provider);
+    return (0, types_js_1.resolveBin)(info.binEnvVar, info.defaultBin);
+}
+//# sourceMappingURL=registry.js.map

package/dist/agents/providers/registry.js.map

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