@poping/yome 0.0.2 → 0.0.4

package/dist/threadCli.js

@@ -0,0 +1,177 @@
+// cli/src/threadCli.ts — `yome thread <subcommand>` dispatcher.
+//
+// Subcommands:
+//   yome thread list
+//   yome thread share <session-id> --skill=<slug> [--out=<dir>] [--no-redact]
+//                                   [--submit] [--case-id=<id>] [--dry-run]
+//   yome thread submit <bundle-dir> --skill=<slug>
+//                                   [--case-id=<id>] [--dry-run] [--verbose]
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { buildShareBundle } from './threadShare.js';
+import { submitBundle } from './threadSubmit.js';
+import { listSessions } from './sessions.js';
+export async function runThreadSubcommand(args, flags) {
+    const sub = args[0];
+    switch (sub) {
+        case 'share':
+            return doShare(args.slice(1), flags);
+        case 'submit':
+            return doSubmit(args.slice(1), flags);
+        case 'list':
+        case 'ls':
+            return doList();
+        case undefined:
+        case 'help':
+        case '--help':
+            printThreadHelp();
+            return 0;
+        default:
+            console.error(`Unknown subcommand: yome thread ${sub}`);
+            printThreadHelp();
+            return 2;
+    }
+}
+function doShare(args, flags) {
+    const sessionId = args[0];
+    if (!sessionId) {
+        console.error('Usage: yome thread share <session-id> --skill=<slug> [--out=<dir>] [--no-redact]');
+        return 2;
+    }
+    if (!flags.skill) {
+        console.error('--skill=<slug> is required (e.g. --skill=@yome/ppt)');
+        return 2;
+    }
+    const outDir = flags.out
+        ? resolve(flags.out)
+        : join(homedir(), '.yome', 'shares', `${sessionId}-${Date.now()}`);
+    const result = buildShareBundle({
+        sessionId,
+        skillSlug: flags.skill,
+        outDir,
+        rules: flags.noRedact ? [] : undefined,
+    });
+    if (!result.ok) {
+        console.error(`✗ share failed: ${result.reason}`);
+        return 1;
+    }
+    console.log(`✓ wrote bundle → ${result.outDir}`);
+    console.log(`  messages: ${result.messageCount}   tool calls: ${result.toolCallCount}`);
+    if (result.hits.length === 0) {
+        console.log('  redaction: no hits');
+    }
+    else {
+        console.log('  redaction:');
+        for (const h of result.hits) {
+            const samples = h.samples.length === 0 ? '' : `   e.g. ${h.samples.map(s => JSON.stringify(s)).join(', ')}`;
+            console.log(`    ${h.rule.padEnd(20)} ×${h.count}${samples}`);
+        }
+    }
+    console.log('');
+    if (flags.submit) {
+        console.log('Submitting bundle as a PR …');
+        const submit = submitBundle({
+            bundleDir: result.outDir,
+            skillSlug: flags.skill,
+            caseId: flags.caseId,
+            dryRun: !!flags.dryRun,
+            verbose: !!flags.verbose,
+        });
+        if (!submit.ok) {
+            console.error(`✗ submit failed: ${submit.reason}`);
+            if (submit.cloneDir)
+                console.error(`  clone left at: ${submit.cloneDir}`);
+            return 1;
+        }
+        if (submit.prUrl) {
+            console.log(`✓ PR opened: ${submit.prUrl}`);
+        }
+        else {
+            console.log(`✓ dry-run prepared in: ${submit.cloneDir}`);
+            console.log(`  branch: ${submit.branch} (not pushed)`);
+        }
+        return 0;
+    }
+    console.log('Next: review files in the bundle, fill in fixtures.json,');
+    console.log(`then run: yome thread submit ${result.outDir} --skill=${flags.skill}`);
+    return 0;
+}
+function doSubmit(args, flags) {
+    const bundleDir = args[0];
+    if (!bundleDir) {
+        console.error('Usage: yome thread submit <bundle-dir> --skill=<slug> [--case-id=<id>] [--dry-run] [--verbose]');
+        return 2;
+    }
+    if (!flags.skill) {
+        console.error('--skill=<slug> is required (e.g. --skill=@yome/ppt)');
+        return 2;
+    }
+    const result = submitBundle({
+        bundleDir: resolve(bundleDir),
+        skillSlug: flags.skill,
+        caseId: flags.caseId,
+        dryRun: !!flags.dryRun,
+        verbose: !!flags.verbose,
+    });
+    if (!result.ok) {
+        console.error(`✗ submit failed: ${result.reason}`);
+        if (result.cloneDir)
+            console.error(`  clone left at: ${result.cloneDir}`);
+        return 1;
+    }
+    if (result.prUrl) {
+        console.log(`✓ PR opened: ${result.prUrl}`);
+    }
+    else {
+        console.log(`✓ dry-run prepared in: ${result.cloneDir}`);
+        console.log(`  branch: ${result.branch} (not pushed)`);
+    }
+    console.log(`  upstream: ${result.upstream}`);
+    console.log(`  case-id : ${result.caseId}`);
+    return 0;
+}
+function doList() {
+    const items = listSessions();
+    if (items.length === 0) {
+        console.log('No sessions found for this cwd.');
+        return 0;
+    }
+    const idW = Math.max(8, ...items.map(i => i.sessionId.length));
+    const titleW = Math.max(5, ...items.map(i => Math.min(60, i.title.length)));
+    const pad = (s, w) => s + ' '.repeat(Math.max(0, w - s.length));
+    const trunc = (s, n) => s.length > n ? s.slice(0, n - 1) + '…' : s;
+    console.log(`  ${pad('SESSION', idW)}  ${pad('TITLE', titleW)}  MSGS  MODIFIED`);
+    for (const i of items) {
+        console.log(`  ${pad(i.sessionId, idW)}  ${pad(trunc(i.title, titleW), titleW)}  ${String(i.messageCount).padStart(4)}  ${i.lastModified.toISOString().slice(0, 19)}`);
+    }
+    return 0;
+}
+function printThreadHelp() {
+    console.log(`
+yome thread — manage and share agent threads
+
+Subcommands:
+  share <session-id> --skill=<slug>    Build a redacted case bundle from a session
+                  [--out=<dir>]        (default: ~/.yome/shares/<id>-<ts>/)
+                  [--no-redact]        Disable the default redactor (NOT recommended)
+                  [--submit]           Open a PR to the skill repo right after share
+                  [--case-id=<id>]     Override the cases/<domain>/<id>/ name
+                  [--dry-run]          (with --submit) prepare the commit but don't push
+                  [--verbose]          Print every git/gh shell command
+
+  submit <bundle-dir> --skill=<slug>   Push an existing bundle as a PR
+                  [--case-id=<id>] [--dry-run] [--verbose]
+
+  list                                 List sessions in the current cwd
+
+Examples:
+  yome thread list
+  yome thread share 7c1f2e... --skill=@yome/ppt
+  yome thread share 7c1f2e... --skill=@yome/ppt --submit
+  yome thread submit ~/.yome/shares/7c1f2e-1745... --skill=@yome/ppt --dry-run
+
+Requires gh CLI authenticated (gh auth login). The token-less hub-bot relay
+path is planned for Phase 3 and not yet implemented.
+`);
+}
+//# sourceMappingURL=threadCli.js.map

package/dist/threadCli.js.map

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

package/dist/threadShare.d.ts

@@ -0,0 +1,21 @@
+import { type RedactionRule, type RuleHit } from './redact.js';
+export interface BuildBundleOptions {
+    sessionId: string;
+    /** Skill slug the bundle targets, e.g. "@yome/ppt". Goes into README. */
+    skillSlug: string;
+    /** Where to write the bundle directory. The dir is created (must not exist). */
+    outDir: string;
+    /** Override default rules. Pass [] to skip redaction entirely. */
+    rules?: RedactionRule[];
+}
+export type BuildBundleResult = {
+    ok: true;
+    outDir: string;
+    messageCount: number;
+    toolCallCount: number;
+    hits: RuleHit[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function buildShareBundle(opts: BuildBundleOptions): BuildBundleResult;

package/dist/threadShare.js

@@ -0,0 +1,121 @@
+// cli/src/threadShare.ts — Build a shareable case bundle from a session.
+//
+// Steps (per spec 9.1):
+//   1. Load all messages for <sessionId>
+//   2. Run ThreadRedactor over messages and trace
+//   3. Emit a directory bundle:
+//        thread.json       — redacted message timeline
+//        trace.json        — redacted tool_use/tool_result extracted from messages
+//        fixtures.json     — sandbox-friendly initial state stub (skill-specific)
+//        README.md         — human-readable summary + rule-hit table
+//
+// We intentionally do NOT make any network call here. The PR/fork submission
+// step (spec 9.1 step 5) is a follow-up command that consumes this bundle.
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadSessionMessages } from './sessions.js';
+import { DEFAULT_RULES, redactValue, totalHits, } from './redact.js';
+/**
+ * Walk an AgentMessage list to extract tool calls in order. Each tool_use
+ * is matched with its tool_result by id (results may live in the next user
+ * message per Anthropic format).
+ */
+function extractTrace(messages) {
+    const steps = [];
+    const indexById = new Map();
+    for (const msg of messages) {
+        const blocks = typeof msg.content === 'string'
+            ? [{ type: 'text', text: msg.content }]
+            : msg.content;
+        for (const block of blocks) {
+            if (block.type === 'tool_use') {
+                const tu = block;
+                const idx = steps.length;
+                indexById.set(tu.id, idx);
+                steps.push({ index: idx, toolUseId: tu.id, toolName: tu.name, input: tu.input });
+            }
+            else if (block.type === 'tool_result') {
+                const tr = block;
+                const idx = indexById.get(tr.tool_use_id);
+                if (idx !== undefined)
+                    steps[idx].result = tr.content;
+            }
+        }
+    }
+    return steps;
+}
+function renderReadme(opts) {
+    const hitTable = opts.hits.length === 0
+        ? '_No redactions applied — thread had no detectable PII / secrets / paths._'
+        : [
+            '| Rule | Count | Samples |',
+            '| --- | ---: | --- |',
+            ...opts.hits.map(h => `| \`${h.rule}\` | ${h.count} | ${h.samples.map(s => `\`${s.replace(/\|/g, '\\|')}\``).join(', ')} |`),
+        ].join('\n');
+    return `# Case for ${opts.skillSlug}
+
+Generated from session \`${opts.sessionId}\` by \`yome thread share\`.
+
+- Messages: **${opts.messageCount}**
+- Tool calls: **${opts.toolCallCount}**
+
+## Files
+
+- \`thread.json\` — full message timeline (redacted)
+- \`trace.json\` — flattened tool_use → tool_result steps (redacted)
+- \`fixtures.json\` — placeholder for sandbox-replay initial state; **fill in** the skill-specific world before opening a PR
+
+## Redaction summary
+
+${hitTable}
+
+## How this bundle is used
+
+The skill's GitHub repo \`cases/<slug>/\` accepts directories like this one
+as new replayable cases. Sandbox runs the skill against \`fixtures.json\`
+and compares the actual trace against \`trace.json\`.
+
+> Always re-read the redacted files yourself before opening a PR — the
+> redactor is a best-effort safety net, not a guarantee.
+`;
+}
+export function buildShareBundle(opts) {
+    const messages = loadSessionMessages(opts.sessionId);
+    if (messages.length === 0) {
+        return { ok: false, reason: `session ${opts.sessionId} has no messages (or does not exist for this cwd)` };
+    }
+    const rules = opts.rules ?? DEFAULT_RULES;
+    const trace = extractTrace(messages);
+    const redactedMessagesResult = redactValue(messages, rules);
+    const redactedTraceResult = redactValue(trace, rules);
+    // Aggregate hits across both walks for the README.
+    const hits = totalHits([redactedMessagesResult.hits, redactedTraceResult.hits]);
+    try {
+        mkdirSync(opts.outDir, { recursive: false });
+    }
+    catch (e) {
+        return { ok: false, reason: `outDir ${opts.outDir}: ${e.message}` };
+    }
+    writeFileSync(join(opts.outDir, 'thread.json'), JSON.stringify({ sessionId: opts.sessionId, skill: opts.skillSlug, messages: redactedMessagesResult.redacted }, null, 2));
+    writeFileSync(join(opts.outDir, 'trace.json'), JSON.stringify({ sessionId: opts.sessionId, skill: opts.skillSlug, steps: redactedTraceResult.redacted }, null, 2));
+    writeFileSync(join(opts.outDir, 'fixtures.json'), JSON.stringify({
+        $note: 'Fill in the sandbox-replay initial world for this skill before opening a PR.',
+        skill: opts.skillSlug,
+        skillStates: {},
+    }, null, 2));
+    writeFileSync(join(opts.outDir, 'README.md'), renderReadme({
+        skillSlug: opts.skillSlug,
+        sessionId: opts.sessionId,
+        messageCount: messages.length,
+        toolCallCount: trace.length,
+        hits,
+    }));
+    return {
+        ok: true,
+        outDir: opts.outDir,
+        messageCount: messages.length,
+        toolCallCount: trace.length,
+        hits,
+    };
+}
+//# sourceMappingURL=threadShare.js.map

package/dist/threadShare.js.map

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

package/dist/threadSubmit.d.ts

@@ -0,0 +1,32 @@
+export interface SubmitOptions {
+    /** Path to a bundle directory produced by `yome thread share`. */
+    bundleDir: string;
+    /** Skill slug (e.g. "@yome/ppt") — used to discover repo from manifest. */
+    skillSlug: string;
+    /** Case id; will be the name of the cases/<slug>/<caseId>/ directory. */
+    caseId?: string;
+    /** Override commit/PR title. Default: "case: add <caseId> for <skillSlug>". */
+    title?: string;
+    /** Override PR body. Default: a generated summary referencing the bundle README. */
+    body?: string;
+    /**
+     * If true, do everything **except** `git push` and `gh pr create` —
+     * useful for local diagnostics.
+     */
+    dryRun?: boolean;
+    /** Verbose: print every shelled command + its stdout. */
+    verbose?: boolean;
+}
+export type SubmitResult = {
+    ok: true;
+    prUrl?: string;
+    branch: string;
+    caseId: string;
+    cloneDir: string;
+    upstream: string;
+} | {
+    ok: false;
+    reason: string;
+    cloneDir?: string;
+};
+export declare function submitBundle(opts: SubmitOptions): SubmitResult;

package/dist/threadSubmit.js

@@ -0,0 +1,199 @@
+// cli/src/threadSubmit.ts — push a redacted bundle as a PR to a skill's repo.
+//
+// Spec 9.1 step 5 (token-bound path). The "no GitHub token / hub-bot relay"
+// path is deferred to Phase 3 once the hub backend exists.
+//
+// Pipeline (all done via the locally-installed `gh` CLI; we shell out and
+// never import @octokit/rest, keeping the CLI install tiny):
+//
+//   1.  Resolve target repo from skill manifest (slug → installed manifest →
+//       `repo` field, e.g. https://github.com/yome-official/yome-skill-ppt).
+//   2.  `gh auth status` — fail fast with a clear message if not signed in.
+//   3.  `gh repo fork <upstream> --clone --remote=false` into a tmp dir.
+//   4.  `git checkout -b case/<slug>-<caseId>`
+//   5.  Copy bundle/* → cases/<slugBase>/<caseId>/
+//   6.  `git add -A && git commit -m "<title>"` (signed-off optional)
+//   7.  `git push --set-upstream origin case/<slug>-<caseId>`
+//   8.  `gh pr create --repo <upstream> --title "..." --body "..."`
+//   9.  Return PR URL.
+//
+// We do NOT delete the tmp clone — leave it for the user to inspect / amend.
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, statSync, copyFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join, resolve } from 'node:path';
+import { readManifest } from './yomeSkills/manifest.js';
+import { installPathForSlug, parseSlug } from './yomeSkills/paths.js';
+const REPO_URL_RE = /^https?:\/\/github\.com\/([^/]+\/[^/.\s]+?)(?:\.git)?\/?$/;
+/**
+ * Look up a skill's upstream GitHub repo from `~/.yome/skills/<owner>/<name>/`.
+ * Falls back to the monorepo `skills/yome-skill-<domain>/` if not installed.
+ */
+function lookupUpstream(skillSlug) {
+    // 1. Try installed location first
+    const installPath = installPathForSlug(skillSlug);
+    let manifest = installPath ? readManifest(installPath) : null;
+    // 2. Fall back to monorepo
+    if (!manifest) {
+        const parsed = parseSlug(skillSlug);
+        if (parsed) {
+            const monorepoPath = resolve(process.cwd(), 'skills', `yome-skill-${parsed.name}`);
+            if (existsSync(join(monorepoPath, 'yome-skill.json'))) {
+                manifest = readManifest(monorepoPath);
+            }
+        }
+    }
+    if (!manifest) {
+        return { ok: false, reason: `skill ${skillSlug} not found locally — install it first or run from monorepo root` };
+    }
+    if (!manifest.repo) {
+        return { ok: false, reason: `skill ${skillSlug} manifest has no "repo" field — cannot determine upstream` };
+    }
+    const m = REPO_URL_RE.exec(manifest.repo.trim());
+    if (!m) {
+        return { ok: false, reason: `skill ${skillSlug} manifest "repo" is not a github.com URL: ${manifest.repo}` };
+    }
+    return { fullName: m[1], manifest };
+}
+/** Run a shell command, capturing stdout/stderr. Throws nothing — caller checks status. */
+function run(cmd, args, cwd, verbose) {
+    if (verbose) {
+        const inDir = cwd ? ` (in ${cwd})` : '';
+        // eslint-disable-next-line no-console
+        console.log(`$ ${cmd} ${args.join(' ')}${inDir}`);
+    }
+    const result = spawnSync(cmd, args, { cwd, encoding: 'utf-8', env: process.env });
+    if (verbose && result.stdout)
+        console.log(result.stdout.trimEnd());
+    if (verbose && result.stderr)
+        console.error(result.stderr.trimEnd());
+    return result;
+}
+function ghIsInstalled() {
+    const r = spawnSync('gh', ['--version'], { encoding: 'utf-8' });
+    return r.status === 0;
+}
+function ghIsAuthed(verbose) {
+    const r = run('gh', ['auth', 'status'], undefined, verbose);
+    if (r.status === 0)
+        return { ok: true };
+    return { ok: false, reason: r.stderr?.trim() || 'gh auth status failed (run: gh auth login)' };
+}
+function copyBundleInto(srcDir, dest) {
+    if (!existsSync(dest))
+        mkdirSync(dest, { recursive: true });
+    let count = 0;
+    for (const entry of readdirSync(srcDir)) {
+        if (entry === '.git' || entry === 'node_modules' || entry === '.DS_Store')
+            continue;
+        const s = join(srcDir, entry);
+        const d = join(dest, entry);
+        const st = statSync(s);
+        if (st.isDirectory()) {
+            count += copyBundleInto(s, d);
+        }
+        else if (st.isFile()) {
+            copyFileSync(s, d);
+            count++;
+        }
+    }
+    return count;
+}
+function defaultCaseId(bundleDir) {
+    // Bundles default to <sessionId>-<timestamp>; the basename is already unique.
+    return basename(bundleDir).slice(0, 60);
+}
+function defaultTitle(skillSlug, caseId) {
+    return `case: add ${caseId} for ${skillSlug}`;
+}
+function defaultBody(skillSlug, caseId, bundleDir) {
+    let bundleReadme = '';
+    try {
+        bundleReadme = readFileSync(join(bundleDir, 'README.md'), 'utf-8');
+    }
+    catch {
+        /* missing README is fine */
+    }
+    return `Adds a new replayable case for **${skillSlug}** under \`cases/${parseSlug(skillSlug)?.name ?? 'unknown'}/${caseId}/\`.
+
+Submitted via \`yome thread share --submit\`. The bundle was redacted on-device using the default ThreadRedactor rules (email / phone / api-key / path / mind).
+
+---
+
+${bundleReadme}`;
+}
+export function submitBundle(opts) {
+    if (!existsSync(opts.bundleDir)) {
+        return { ok: false, reason: `bundle directory does not exist: ${opts.bundleDir}` };
+    }
+    if (!existsSync(join(opts.bundleDir, 'thread.json'))) {
+        return { ok: false, reason: `${opts.bundleDir} is not a valid bundle (missing thread.json)` };
+    }
+    if (!ghIsInstalled()) {
+        return { ok: false, reason: 'gh CLI is not installed (https://cli.github.com). Install it then run: gh auth login' };
+    }
+    const auth = ghIsAuthed(!!opts.verbose);
+    if (!auth.ok) {
+        return { ok: false, reason: `gh CLI not authenticated: ${auth.reason}\nRun: gh auth login\n\n(The token-less hub-bot relay path is planned for Phase 3 and not yet implemented.)` };
+    }
+    const upstreamLookup = lookupUpstream(opts.skillSlug);
+    if ('ok' in upstreamLookup && upstreamLookup.ok === false)
+        return upstreamLookup;
+    const { fullName: upstream, manifest } = upstreamLookup;
+    const caseId = opts.caseId ?? defaultCaseId(opts.bundleDir);
+    const branch = `case/${manifest.domain}-${caseId}`;
+    const title = opts.title ?? defaultTitle(opts.skillSlug, caseId);
+    const body = opts.body ?? defaultBody(opts.skillSlug, caseId, opts.bundleDir);
+    // Clone into ~/.yome/shares/.work/<random>/<repo>
+    const workRoot = join(homedir(), '.yome', 'shares', '.work');
+    if (!existsSync(workRoot))
+        mkdirSync(workRoot, { recursive: true });
+    const tmpDir = mkdtempSync(join(workRoot, 'submit-'));
+    const cloneDir = join(tmpDir, basename(upstream));
+    // 1. fork + clone. `gh repo fork ... --clone -- <git-clone-args>` lets us
+    // pass `--depth` and the target directory through to git clone.
+    const forkResult = run('gh', ['repo', 'fork', upstream, '--clone', '--', '--depth=20', cloneDir], undefined, !!opts.verbose);
+    if (forkResult.status !== 0) {
+        return { ok: false, reason: `gh repo fork failed: ${forkResult.stderr?.trim()}`, cloneDir };
+    }
+    // 2. checkout new branch
+    const checkout = run('git', ['checkout', '-b', branch], cloneDir, !!opts.verbose);
+    if (checkout.status !== 0) {
+        return { ok: false, reason: `git checkout -b failed: ${checkout.stderr?.trim()}`, cloneDir };
+    }
+    // 3. copy bundle into cases/<domain>/<caseId>/
+    const targetRel = join('cases', manifest.domain, caseId);
+    const targetAbs = join(cloneDir, targetRel);
+    if (existsSync(targetAbs)) {
+        return { ok: false, reason: `cases/${manifest.domain}/${caseId}/ already exists in fork — pass a different --case-id`, cloneDir };
+    }
+    const copied = copyBundleInto(opts.bundleDir, targetAbs);
+    if (copied === 0) {
+        return { ok: false, reason: 'bundle is empty (no files copied)', cloneDir };
+    }
+    // 4. commit
+    const add = run('git', ['add', '-A'], cloneDir, !!opts.verbose);
+    if (add.status !== 0) {
+        return { ok: false, reason: `git add failed: ${add.stderr?.trim()}`, cloneDir };
+    }
+    const commit = run('git', ['commit', '-m', title], cloneDir, !!opts.verbose);
+    if (commit.status !== 0) {
+        return { ok: false, reason: `git commit failed: ${commit.stderr?.trim()}`, cloneDir };
+    }
+    if (opts.dryRun) {
+        return { ok: true, branch, caseId, cloneDir, upstream };
+    }
+    // 5. push
+    const push = run('git', ['push', '--set-upstream', 'origin', branch], cloneDir, !!opts.verbose);
+    if (push.status !== 0) {
+        return { ok: false, reason: `git push failed: ${push.stderr?.trim()}`, cloneDir };
+    }
+    // 6. open PR
+    const pr = run('gh', ['pr', 'create', '--repo', upstream, '--title', title, '--body', body, '--head', branch], cloneDir, !!opts.verbose);
+    if (pr.status !== 0) {
+        return { ok: false, reason: `gh pr create failed: ${pr.stderr?.trim()}`, cloneDir };
+    }
+    const prUrl = pr.stdout?.trim().split('\n').pop() || undefined;
+    return { ok: true, prUrl, branch, caseId, cloneDir, upstream };
+}
+//# sourceMappingURL=threadSubmit.js.map

package/dist/threadSubmit.js.map

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

package/dist/tools/askUser.d.ts

@@ -0,0 +1,20 @@
+import type { ToolDef } from '../types.js';
+export interface AskUserQuestion {
+    /** Full question text shown to the user (should end with `?`). */
+    question: string;
+    /** Short chip label shown above the option list (≤ 12 chars). */
+    header: string;
+    /** 2–4 options. Do NOT include "Other" — the UI auto-adds a custom-answer entry. */
+    options: {
+        label: string;
+        description?: string;
+    }[];
+}
+export interface AskUserResult {
+    /** Map: question text → answer string (the chosen label or the user's free-text). */
+    answers: Record<string, string>;
+    /** True if the user pressed Esc / cancelled all questions. */
+    cancelled?: boolean;
+}
+export declare function setAskUserHandler(fn: (questions: AskUserQuestion[]) => Promise<AskUserResult>): void;
+export declare const askUserTool: ToolDef;