@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/dist/lib/brand/media-manifest.js

@@ -0,0 +1,98 @@
+// media-manifest — emit deterministic brand assets + a public/media.manifest.json.
+// SVG placeholders built from the BrandKit palette render immediately; real
+// bitmap generation (DALL-E, Replicate, Modal) replaces SVG content in place
+// without changing the manifest contract.
+import fs from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { ensureDir } from '../fs.js';
+function initialsFor(kit) {
+    return kit.brandName
+        .split(/\s+/)
+        .map((w) => w[0] ?? '')
+        .filter(Boolean)
+        .slice(0, 2)
+        .join('')
+        .toUpperCase();
+}
+function brandFingerprint(kit) {
+    return [
+        kit.brandName,
+        kit.palette.primary,
+        kit.palette.accent,
+        kit.palette.background,
+        kit.typography.sans,
+    ].join('|');
+}
+function logoSvg(kit, size) {
+    const init = initialsFor(kit) || 'S';
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${size} ${size}" width="${size}" height="${size}">
+  <rect width="${size}" height="${size}" rx="${Math.round(size * 0.18)}" fill="hsl(${kit.palette.primary})"/>
+  <text x="50%" y="50%" text-anchor="middle" dy="0.35em" fill="hsl(${kit.palette.background})" font-family="${kit.typography.sans}" font-size="${Math.round(size * 0.42)}" font-weight="700">${init}</text>
+</svg>
+`;
+}
+function heroBgSvg(kit, w, h) {
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${w} ${h}" width="${w}" height="${h}">
+  <defs>
+    <linearGradient id="g" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="hsl(${kit.palette.primary})" stop-opacity="0.95"/>
+      <stop offset="50%" stop-color="hsl(${kit.palette.accent})" stop-opacity="0.85"/>
+      <stop offset="100%" stop-color="hsl(${kit.palette.background})" stop-opacity="1"/>
+    </linearGradient>
+  </defs>
+  <rect width="${w}" height="${h}" fill="url(#g)"/>
+</svg>
+`;
+}
+function ogSvg(kit) {
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630" width="1200" height="630">
+  <rect width="1200" height="630" fill="hsl(${kit.palette.background})"/>
+  <rect x="0" y="530" width="1200" height="100" fill="hsl(${kit.palette.primary})"/>
+  <text x="80" y="280" fill="hsl(${kit.palette.foreground})" font-family="${kit.typography.sans}" font-size="72" font-weight="700">${escapeXml(kit.brandName)}</text>
+  <text x="80" y="360" fill="hsl(${kit.palette.foreground})" font-family="${kit.typography.sans}" font-size="32" font-weight="400" opacity="0.8">${escapeXml(kit.tagline)}</text>
+</svg>
+`;
+}
+function faviconSvg(kit) {
+    return logoSvg(kit, 32);
+}
+function appIconSvg(kit) {
+    return logoSvg(kit, 512);
+}
+function escapeXml(s) {
+    return s.replace(/[<>&"']/g, (c) => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;', '"': '&quot;', "'": '&apos;' })[c]);
+}
+export function buildMediaManifest(kit) {
+    const assets = [
+        { path: 'public/logo.svg', purpose: 'logo', spec: { width: 256, height: 256, format: 'svg' } },
+        { path: 'public/hero-bg.svg', purpose: 'hero-bg', spec: { width: 1920, height: 1080, format: 'svg' } },
+        { path: 'public/og-image.svg', purpose: 'og', spec: { width: 1200, height: 630, format: 'svg' } },
+        { path: 'public/favicon.svg', purpose: 'favicon', spec: { width: 32, height: 32, format: 'svg' } },
+        { path: 'public/app-icon.svg', purpose: 'app-icon', spec: { width: 512, height: 512, format: 'svg' } },
+    ];
+    const files = [
+        { path: 'public/logo.svg', body: logoSvg(kit, 256) },
+        { path: 'public/hero-bg.svg', body: heroBgSvg(kit, 1920, 1080) },
+        { path: 'public/og-image.svg', body: ogSvg(kit) },
+        { path: 'public/favicon.svg', body: faviconSvg(kit) },
+        { path: 'public/app-icon.svg', body: appIconSvg(kit) },
+    ];
+    const manifest = {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        assets,
+        brandFingerprint: brandFingerprint(kit),
+    };
+    files.push({ path: 'public/media.manifest.json', body: JSON.stringify(manifest, null, 2) + '\n' });
+    return { manifest, files };
+}
+export async function generateMediaManifest(kit, outDir) {
+    const result = buildMediaManifest(kit);
+    for (const f of result.files) {
+        const abs = join(outDir, f.path);
+        await ensureDir(dirname(abs));
+        await fs.writeFile(abs, f.body, 'utf8');
+    }
+    return result;
+}
+//# sourceMappingURL=media-manifest.js.map

package/dist/lib/brand/media-manifest.js.map

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

package/dist/lib/brand/user-segments.d.ts

@@ -0,0 +1,7 @@
+export type UserSegment = 'power-user' | 'smb' | 'enterprise';
+export declare function inferSegment(prompt: string): UserSegment | null;
+export declare const SEGMENT_DEFAULTS: Record<UserSegment, {
+    headline: string;
+    steps: string[];
+}>;
+export declare function segmentDefaultsAsMarkdown(segment: UserSegment): string;

package/dist/lib/brand/user-segments.js

@@ -0,0 +1,81 @@
+// User-segment targeting. The prompt often implies a customer shape that
+// should drive defaults: a "team management dashboard" is SMB; a "SAML SSO
+// + audit logs + role hierarchy" prompt is enterprise; a "keyboard-shortcut
+// code editor" is power-user. Emit segment-specific hints in AGENTS.md.
+import { hasAny } from '../keywords.js';
+const ENTERPRISE_SIGNALS = [
+    'saml', 'sso', 'okta', 'azure ad', 'entra id',
+    'audit log', 'audit trail', 'role hierarchy', 'rbac',
+    'compliance', 'soc2', 'iso 27001', 'fedramp', 'hipaa baa',
+    'department', 'org chart', 'organization hierarchy',
+    'seat-based pricing', 'per-seat licensing', 'contract terms',
+    'dpa', 'bcp', 'procurement',
+];
+const SMB_SIGNALS = [
+    'small business', 'smb', 'smb saas',
+    'single owner', 'solo founder',
+    'stripe checkout', 'stripe subscription',
+    'team management', 'simple crm', 'invoice customers',
+    'onboarding flow', 'quick setup',
+];
+const POWER_USER_SIGNALS = [
+    'keyboard shortcut', 'cli', 'vim keybinding', 'hotkey',
+    'dense layout', 'command palette', 'quick switcher',
+    'power user', 'advanced user', 'expert mode',
+    'macro', 'scripting',
+    'ide-like', 'editor-first',
+];
+export function inferSegment(prompt) {
+    if (hasAny(prompt, ENTERPRISE_SIGNALS))
+        return 'enterprise';
+    if (hasAny(prompt, POWER_USER_SIGNALS))
+        return 'power-user';
+    if (hasAny(prompt, SMB_SIGNALS))
+        return 'smb';
+    return null;
+}
+export const SEGMENT_DEFAULTS = {
+    'power-user': {
+        headline: 'Build for fluency',
+        steps: [
+            'Ship keyboard shortcuts on every core action (open, search, save, submit) — use cmdk or kbar.',
+            'Dense default layout: -2 px vertical padding vs SMB defaults; more rows per viewport.',
+            'Command palette (Cmd+K) as the first-class nav — mouse navigation is a fallback.',
+            'No tooltips on well-known icons; power users hate them.',
+            'Expose raw JSON / YAML editing surfaces where the UI would otherwise hide them.',
+        ],
+    },
+    smb: {
+        headline: 'Single-owner simplicity',
+        steps: [
+            'One admin, no role hierarchy. Stripe Checkout (not Billing Portal) for the first flow.',
+            'Onboarding wizard: 3 steps max, skip-able, remembered in localStorage until completion.',
+            'Default empty states with "Add your first X" CTAs — don\'t show a table skeleton with nothing in it.',
+            'Ship email-only auth (better-auth magic links or Stripe login links) — no SSO.',
+            'Stripe webhook → send welcome email on first paid invoice; this is the win moment.',
+        ],
+    },
+    enterprise: {
+        headline: 'Ship for procurement',
+        steps: [
+            'SSO (SAML + OIDC) as the default auth path — not an afterthought. Use better-auth or WorkOS.',
+            'Role hierarchy: at least {owner, admin, member, viewer}; enforce at the middleware layer.',
+            'Immutable audit log for every state-changing action, with actor + timestamp + before/after.',
+            'SOC2 control surface page: list sub-processors, data retention, incident response contact.',
+            'DPA + BCP templates under docs/legal/; the procurement team will ask.',
+            'Rate limits + quotas PER ORG (not per API key) — enterprise accounts have N users sharing a tenant.',
+        ],
+    },
+};
+export function segmentDefaultsAsMarkdown(segment) {
+    const d = SEGMENT_DEFAULTS[segment];
+    return [
+        `## User-segment defaults — ${segment}`,
+        '',
+        `_${d.headline}_`,
+        '',
+        ...d.steps.map((s, i) => `${i + 1}. ${s}`),
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=user-segments.js.map

package/dist/lib/brand/user-segments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-segments.js","sourceRoot":"","sources":["../../../src/lib/brand/user-segments.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAIvC,MAAM,kBAAkB,GAAG;IACzB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;IAC7C,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM;IACpD,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW;IACzD,YAAY,EAAE,WAAW,EAAE,wBAAwB;IACnD,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB;IAC5D,KAAK,EAAE,KAAK,EAAE,aAAa;CAC5B,CAAA;AAED,MAAM,WAAW,GAAG;IAClB,gBAAgB,EAAE,KAAK,EAAE,UAAU;IACnC,cAAc,EAAE,cAAc;IAC9B,iBAAiB,EAAE,qBAAqB;IACxC,iBAAiB,EAAE,YAAY,EAAE,mBAAmB;IACpD,iBAAiB,EAAE,aAAa;CACjC,CAAA;AAED,MAAM,kBAAkB,GAAG;IACzB,mBAAmB,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ;IACtD,cAAc,EAAE,iBAAiB,EAAE,gBAAgB;IACnD,YAAY,EAAE,eAAe,EAAE,aAAa;IAC5C,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,cAAc;CAC3B,CAAA;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;QAAE,OAAO,YAAY,CAAA;IAC3D,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;QAAE,OAAO,YAAY,CAAA;IAC3D,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAGxB;IACH,YAAY,EAAE;QACZ,QAAQ,EAAE,mBAAmB;QAC7B,KAAK,EAAE;YACL,+FAA+F;YAC/F,uFAAuF;YACvF,kFAAkF;YAClF,yDAAyD;YACzD,iFAAiF;SAClF;KACF;IACD,GAAG,EAAE;QACH,QAAQ,EAAE,yBAAyB;QACnC,KAAK,EAAE;YACL,wFAAwF;YACxF,yFAAyF;YACzF,sGAAsG;YACtG,gFAAgF;YAChF,oFAAoF;SACrF;KACF;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,sBAAsB;QAChC,KAAK,EAAE;YACL,8FAA8F;YAC9F,2FAA2F;YAC3F,6FAA6F;YAC7F,4FAA4F;YAC5F,uEAAuE;YACvE,qGAAqG;SACtG;KACF;CACF,CAAA;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAoB;IAC5D,MAAM,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACnC,OAAO;QACL,8BAA8B,OAAO,EAAE;QACvC,EAAE;QACF,IAAI,CAAC,CAAC,QAAQ,GAAG;QACjB,EAAE;QACF,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/lib/brand/voice.d.ts

@@ -0,0 +1,10 @@
+import type { BrandKit } from './index.js';
+export type VoiceRegister = 'formal' | 'casual' | 'technical' | 'playful' | 'neutral';
+export declare const INDUSTRY_VOICE: Record<string, VoiceRegister>;
+export declare function defaultVoiceForIndustry(industry: string | undefined): VoiceRegister;
+export interface VoiceApplyResult {
+    kit: BrandKit;
+    voice: VoiceRegister;
+    source: 'llm' | 'deterministic';
+}
+export declare function applyVoice(kit: BrandKit, voice: VoiceRegister): Promise<VoiceApplyResult>;

package/dist/lib/brand/voice.js

@@ -0,0 +1,92 @@
+// voice — rewrite BrandKit copy in a target voice register.
+// LLM path uses AxLLM when a router key is present. Deterministic fallback
+// applies a word-substitution table so the output is stable in tests + offline.
+import { ax } from '@ax-llm/ax';
+import { createLLM, isLLMAvailable } from '../llm.js';
+export const INDUSTRY_VOICE = {
+    fitness: 'casual',
+    fintech: 'formal',
+    healthcare: 'technical',
+    legal: 'formal',
+    crypto: 'technical',
+    ecommerce: 'casual',
+    edtech: 'casual',
+    realestate: 'formal',
+    travel: 'casual',
+    saas: 'neutral',
+};
+export function defaultVoiceForIndustry(industry) {
+    if (!industry)
+        return 'neutral';
+    return INDUSTRY_VOICE[industry.toLowerCase()] ?? 'neutral';
+}
+const voiceRewriter = ax('originalCopy:string, targetVoice:string, brandName:string -> rewrittenCopy:string');
+// Deterministic substitution table — same input always produces the same
+// output. Not great prose, but stable for tests + offline operation.
+const SUBSTITUTIONS = {
+    formal: [
+        [/\bget\b/gi, 'obtain'],
+        [/\bhelp\b/gi, 'assist'],
+        [/\bbuild\b/gi, 'construct'],
+        [/\bawesome\b/gi, 'exceptional'],
+        [/!+/g, '.'],
+    ],
+    casual: [
+        [/\butilize\b/gi, 'use'],
+        [/\bobtain\b/gi, 'get'],
+        [/\btherefore\b/gi, 'so'],
+        [/\bassist\b/gi, 'help'],
+    ],
+    technical: [
+        [/\bset up\b/gi, 'configure'],
+        [/\bfix\b/gi, 'remediate'],
+        [/\buse\b/gi, 'leverage'],
+        [/\bfast\b/gi, 'low-latency'],
+    ],
+    playful: [
+        [/\bbuild\b/gi, 'craft'],
+        [/\.+$/, '!'],
+    ],
+    neutral: [],
+};
+function rewriteDeterministic(text, voice) {
+    let out = text;
+    for (const [pattern, replacement] of SUBSTITUTIONS[voice]) {
+        out = out.replace(pattern, replacement);
+    }
+    return out;
+}
+async function rewriteLLM(text, voice, brandName) {
+    if (!isLLMAvailable())
+        return null;
+    try {
+        const llm = createLLM();
+        const out = (await voiceRewriter.forward(llm, {
+            originalCopy: text,
+            targetVoice: voice,
+            brandName,
+        }));
+        return out.rewrittenCopy ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function applyVoice(kit, voice) {
+    if (voice === 'neutral' || voice === kit.voice) {
+        return { kit, voice, source: 'deterministic' };
+    }
+    const llmTagline = await rewriteLLM(kit.tagline, voice, kit.brandName);
+    const llmHeadline = await rewriteLLM(kit.heroHeadline, voice, kit.brandName);
+    const llmSubheadline = await rewriteLLM(kit.heroSubheadline, voice, kit.brandName);
+    const source = llmTagline && llmHeadline && llmSubheadline ? 'llm' : 'deterministic';
+    const nextKit = {
+        ...kit,
+        voice,
+        tagline: llmTagline ?? rewriteDeterministic(kit.tagline, voice),
+        heroHeadline: llmHeadline ?? rewriteDeterministic(kit.heroHeadline, voice),
+        heroSubheadline: llmSubheadline ?? rewriteDeterministic(kit.heroSubheadline, voice),
+    };
+    return { kit: nextKit, voice, source };
+}
+//# sourceMappingURL=voice.js.map

package/dist/lib/brand/voice.js.map

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

package/dist/lib/bridge.d.ts

@@ -0,0 +1,38 @@
+import { type BridgeSession } from '@tangle-network/tcloud';
+type BridgeHarness = 'kimi-code' | 'claude-code' | 'codex' | 'sandbox';
+interface BridgeOptions {
+    /** Which CLI harness to drive. Defaults to 'kimi-code'. */
+    harness?: BridgeHarness;
+    /** Harness-specific model name. Defaults per harness:
+     * kimi-code=kimi-for-coding, claude-code=sonnet, codex=gpt-5-codex.
+     * Note: when going through the router (paths 2/3), the wire form
+     * adds a `bridge/` prefix automatically (`bridge/<harness>/<model>`);
+     * direct mode (path 1) sends `<harness>/<model>` straight to
+     * cli-bridge which strips the bridge/ prefix internally anyway. */
+    model?: string;
+    /** Session resume slug. REQUIRED — follow-up calls with the same
+     * slug land on the same CLI conversation without re-tokenizing
+     * prior turns. Use stable identifiers like `proposal-<id>` or
+     * `pr-<n>`. */
+    resume: string;
+}
+/**
+ * Minimal session shape returned by direct mode. Matches the subset of
+ * tcloud.BridgeSession that the proposer actually uses (`ask`, `stream`,
+ * `turn`, `withResume`, `model`). cli-bridge handles session resume
+ * via the `session_id` body field; we thread the resume slug into
+ * every request so multi-turn picks up the same CLI conversation.
+ */
+interface DirectBridgeSession {
+    ask(message: string): Promise<string>;
+    stream(message: string): AsyncGenerator<string>;
+    turn(messages: Array<{
+        role: 'system' | 'user' | 'assistant';
+        content: string;
+    }>): Promise<string>;
+    withResume(newResume: string): DirectBridgeSession;
+    readonly model: string;
+    readonly resume: string;
+}
+export declare function createBridge(opts: BridgeOptions): BridgeSession | DirectBridgeSession;
+export {};

package/dist/lib/bridge.js

@@ -0,0 +1,130 @@
+// Bridge sessions — subscription-backed coding harnesses (Kimi Code,
+// Claude Code, Codex) routed through one of three paths. Session-resumable
+// by a caller-chosen slug, so multi-turn proposer runs don't re-tokenize
+// prior context and can be iterated on CI fail or review feedback.
+//
+// Three dispatch paths:
+//
+//   1. Direct local (preferred for dev): SDK → cli-bridge directly,
+//      no router involvement. cli-bridge is OpenAI-compatible
+//      (`/v1/chat/completions`) — we just point a TCloudClient at
+//      its baseURL and call chat() with model='<harness>/<model>'.
+//      Triggered when CLI_BRIDGE_URL + CLI_BRIDGE_BEARER are set.
+//      Auth: BRIDGE_BEARER (local). No router gate, no billing
+//      passthrough — pure local execution.
+//
+//   2. BYOB-via-router (preferred for tunneled local + observability):
+//      SDK → router.tangle.tools/api → server-side fetch to your
+//      cli-bridge URL. The router still gates on BRIDGE_UNLOCK and
+//      applies billing/observability; only harness execution location
+//      changes. Triggered when CLI_BRIDGE_URL + TCLOUD_API_KEY +
+//      BRIDGE_UNLOCK are all set. Note: the URL must be reachable
+//      FROM the router box, so for a local laptop you need a tunnel
+//      (ngrok / cloudflare tunnel / tailscale funnel) — pure
+//      127.0.0.1 only works if both you and the router are on the
+//      same machine.
+//
+//   3. Production (default): SDK → router → shared cli-bridge inside
+//      the router's docker network. Triggered when only
+//      TCLOUD_API_KEY + BRIDGE_UNLOCK are set. Needs the prod bridge
+//      to be deployed with the harness names you're calling.
+//
+// Path-1 is what most local sessions want. The proposer's API
+// (`session.ask(task)`, `session.stream(...)`, `withResume(id)`)
+// is uniform across all three.
+import { TCloudClient } from '@tangle-network/tcloud';
+const DEFAULT_MODELS = {
+    'kimi-code': 'kimi-for-coding',
+    'claude-code': 'sonnet',
+    codex: 'gpt-5-codex',
+    // For sandbox the "model" slot holds the AgentProfile id (cataloged
+    // in cli-bridge's profiles/ dir). Callers MUST pass model explicitly
+    // — there's no useful default since profile choice IS the dispatch.
+    sandbox: '',
+};
+const ROUTER_API_BASE = 'https://router.tangle.tools/api';
+/** True when at least one dispatch path has the env it needs. */
+function isBridgeAvailable() {
+    const direct = process.env['CLI_BRIDGE_URL'] && process.env['CLI_BRIDGE_BEARER'];
+    const router = (process.env['TCLOUD_API_KEY'] ?? process.env['TANGLE_API_KEY']) && process.env['BRIDGE_UNLOCK'];
+    return Boolean(direct || router);
+}
+function createDirectBridge(opts) {
+    const baseURL = process.env['CLI_BRIDGE_URL'].replace(/\/+$/, '') + '/v1';
+    const bearer = process.env['CLI_BRIDGE_BEARER'];
+    const harness = opts.harness ?? 'kimi-code';
+    const model = opts.model ?? DEFAULT_MODELS[harness];
+    const fullModel = `${harness}/${model}`;
+    // tcloud's chat() POSTs to ${baseURL}/chat/completions — exactly
+    // cli-bridge's mounted path. We pass session_id as an extra body
+    // field; cli-bridge's chat-completions route accepts it.
+    const tcloud = new TCloudClient({ apiKey: bearer, baseURL });
+    function build(resume) {
+        return {
+            get model() { return fullModel; },
+            get resume() { return resume; },
+            async ask(message) {
+                const result = await tcloud.chat({
+                    model: fullModel,
+                    messages: [{ role: 'user', content: message }],
+                    // @ts-expect-error session_id is cli-bridge-specific; tcloud's
+                    // ChatOptions doesn't declare it but the body is forwarded.
+                    session_id: resume,
+                });
+                return result.choices[0]?.message?.content ?? '';
+            },
+            async *stream(message) {
+                const it = tcloud.chatStream({
+                    model: fullModel,
+                    messages: [{ role: 'user', content: message }],
+                    // @ts-expect-error session_id pass-through (see ask).
+                    session_id: resume,
+                });
+                for await (const chunk of it) {
+                    const delta = chunk.choices?.[0]?.delta?.content;
+                    if (delta)
+                        yield delta;
+                }
+            },
+            async turn(messages) {
+                const result = await tcloud.chat({
+                    model: fullModel,
+                    messages,
+                    // @ts-expect-error session_id pass-through (see ask).
+                    session_id: resume,
+                });
+                return result.choices[0]?.message?.content ?? '';
+            },
+            withResume(newResume) { return build(newResume); },
+        };
+    }
+    return build(opts.resume);
+}
+export function createBridge(opts) {
+    const directUrl = process.env['CLI_BRIDGE_URL'];
+    const directBearer = process.env['CLI_BRIDGE_BEARER'];
+    const apiKey = process.env['TCLOUD_API_KEY'] ?? process.env['TANGLE_API_KEY'];
+    const unlock = process.env['BRIDGE_UNLOCK'];
+    // Path 1: direct local. Cleanest path when both are set and we don't
+    // also have router creds — skip the router entirely.
+    if (directUrl && directBearer && !(apiKey && unlock)) {
+        return createDirectBridge(opts);
+    }
+    // Paths 2 + 3: router. Need TCLOUD_API_KEY + BRIDGE_UNLOCK.
+    if (!apiKey) {
+        throw new Error('Missing TCLOUD_API_KEY (sk-tan-*) for router-mediated dispatch. For local-only use, set CLI_BRIDGE_URL + CLI_BRIDGE_BEARER instead.');
+    }
+    if (!unlock) {
+        throw new Error('Missing BRIDGE_UNLOCK for router-mediated dispatch. For local-only use, set CLI_BRIDGE_URL + CLI_BRIDGE_BEARER instead.');
+    }
+    const tcloud = new TCloudClient({ apiKey, baseURL: ROUTER_API_BASE });
+    const harness = opts.harness ?? 'kimi-code';
+    const model = opts.model ?? DEFAULT_MODELS[harness];
+    // Path 2: BYOB-via-router. Reminder: directUrl must be reachable
+    // FROM the router box (public tunnel for laptop dev).
+    const byobCfg = directUrl && directBearer
+        ? { bridgeUrl: directUrl, bridgeBearer: directBearer }
+        : {};
+    return tcloud.bridge({ harness, model, unlock, resume: opts.resume, ...byobCfg });
+}
+//# sourceMappingURL=bridge.js.map

package/dist/lib/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/lib/bridge.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,2EAA2E;AAC3E,yEAAyE;AACzE,mEAAmE;AACnE,EAAE;AACF,wBAAwB;AACxB,EAAE;AACF,oEAAoE;AACpE,8DAA8D;AAC9D,kEAAkE;AAClE,mEAAmE;AACnE,kEAAkE;AAClE,+DAA+D;AAC/D,2CAA2C;AAC3C,EAAE;AACF,uEAAuE;AACvE,iEAAiE;AACjE,mEAAmE;AACnE,sEAAsE;AACtE,iEAAiE;AACjE,kEAAkE;AAClE,oEAAoE;AACpE,6DAA6D;AAC7D,kEAAkE;AAClE,qBAAqB;AACrB,EAAE;AACF,qEAAqE;AACrE,wDAAwD;AACxD,qEAAqE;AACrE,6DAA6D;AAC7D,EAAE;AACF,8DAA8D;AAC9D,iEAAiE;AACjE,+BAA+B;AAE/B,OAAO,EAAE,YAAY,EAAsB,MAAM,wBAAwB,CAAA;AAqBzE,MAAM,cAAc,GAAkC;IACpD,WAAW,EAAE,iBAAiB;IAC9B,aAAa,EAAE,QAAQ;IACvB,KAAK,EAAE,aAAa;IACpB,oEAAoE;IACpE,qEAAqE;IACrE,oEAAoE;IACpE,OAAO,EAAE,EAAE;CACZ,CAAA;AAED,MAAM,eAAe,GAAG,iCAAiC,CAAA;AAEzD,iEAAiE;AACjE,SAAS,iBAAiB;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAChF,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IAC/G,OAAO,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,CAAA;AAClC,CAAC;AAkBD,SAAS,kBAAkB,CAAC,IAAmB;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK,CAAA;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAE,CAAA;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,WAAW,CAAA;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;IACnD,MAAM,SAAS,GAAG,GAAG,OAAO,IAAI,KAAK,EAAE,CAAA;IAEvC,iEAAiE;IACjE,iEAAiE;IACjE,yDAAyD;IACzD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;IAE5D,SAAS,KAAK,CAAC,MAAc;QAC3B,OAAO;YACL,IAAI,KAAK,KAAK,OAAO,SAAS,CAAA,CAAC,CAAC;YAChC,IAAI,MAAM,KAAK,OAAO,MAAM,CAAA,CAAC,CAAC;YAC9B,KAAK,CAAC,GAAG,CAAC,OAAe;gBACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;oBAC/B,KAAK,EAAE,SAAS;oBAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;oBAC9C,+DAA+D;oBAC/D,4DAA4D;oBAC5D,UAAU,EAAE,MAAM;iBACnB,CAAC,CAAA;gBACF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAA;YAClD,CAAC;YACD,KAAK,CAAC,CAAC,MAAM,CAAC,OAAe;gBAC3B,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC;oBAC3B,KAAK,EAAE,SAAS;oBAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;oBAC9C,sDAAsD;oBACtD,UAAU,EAAE,MAAM;iBACnB,CAAC,CAAA;gBACF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,EAAE,CAAC;oBAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAA;oBAChD,IAAI,KAAK;wBAAE,MAAM,KAAK,CAAA;gBACxB,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,QAAQ;gBACjB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;oBAC/B,KAAK,EAAE,SAAS;oBAChB,QAAQ;oBACR,sDAAsD;oBACtD,UAAU,EAAE,MAAM;iBACnB,CAAC,CAAA;gBACF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAA;YAClD,CAAC;YACD,UAAU,CAAC,SAAiB,IAAI,OAAO,KAAK,CAAC,SAAS,CAAC,CAAA,CAAC,CAAC;SAC1D,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IAE3C,qEAAqE;IACrE,qDAAqD;IACrD,IAAI,SAAS,IAAI,YAAY,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,qIAAqI,CACtI,CAAA;IACH,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,yHAAyH,CAC1H,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAA;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,WAAW,CAAA;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;IAEnD,iEAAiE;IACjE,sDAAsD;IACtD,MAAM,OAAO,GAAG,SAAS,IAAI,YAAY;QACvC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE;QACtD,CAAC,CAAC,EAAE,CAAA;IAEN,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;AACnF,CAAC"}

package/dist/lib/build-plan.d.ts

@@ -1,2 +1,45 @@
+import type { ProductBrief } from './product-brief.js';
 import type { BuildPlan, ComposeSpec, ResolvedComponents } from '../types.js';
+interface FirstStepEntry {
+    source: string;
+    step: string;
+}
+interface GotchaEntry {
+    source: string;
+    note: string;
+}
+interface PlaceholderEntry {
+    source: string;
+    path: string;
+    description: string;
+}
+export declare function gatherBuildHints(components: ResolvedComponents): {
+    pages: string[];
+    apiRoutes: string[];
+    componentNames: string[];
+    dataModels: string[];
+    integrations: string[];
+    architectureNotes: string[];
+    firstSteps: FirstStepEntry[];
+    gotchas: GotchaEntry[];
+    placeholders: PlaceholderEntry[];
+};
 export declare function generateBuildPlan(spec: ComposeSpec, components: ResolvedComponents): BuildPlan;
+export interface EnhanceArgs {
+    spec: ComposeSpec;
+    base: BuildPlan;
+    composedFiles: string[];
+}
+export type EnhancerFn = (args: EnhanceArgs) => Promise<BuildPlan>;
+export declare function __setTestEnhancer(fn: EnhancerFn | null): void;
+export declare function enhanceBuildPlanWithLLM(args: EnhanceArgs): Promise<BuildPlan>;
+/**
+ * Merge a ProductBrief into a BuildPlan. The brief is generated once (by
+ * planPrompt({ brief: true })) and reused here so context-pack doesn't pay
+ * for a second LLM call. Fields:
+ *   - vision, milestones, testingPlan, e2ePlan, securityConcerns, openQuestions
+ *     attach as new BuildPlan fields
+ *   - taskChecklist prepends to firstMoves (richer "what to do next")
+ */
+export declare function mergeBriefIntoBuildPlan(base: BuildPlan, brief: ProductBrief): BuildPlan;
+export {};