@clien-ai/mcp 0.1.3 → 0.1.4

package/README.md

@@ -68,6 +68,25 @@ the top 3 threats", etc.
 
 ---
 
+## Recipes: composing beyond the hero
+
+`clien_research` is the hero — the recommended default for validating an idea
+end to end. Alongside it, the server exposes granular primitives (`create_persona`,
+`interview_persona`, `list_projects` / `create_project`, `list_reports` /
+`get_report`, `clien_research_status`) you can sequence for targeted, cheaper
+checks.
+
+See [`docs/recipes/`](../docs/recipes/) for the supported compositions:
+
+- [Competitor spot-check](../docs/recipes/competitor-spot-check.md) — read `competitors[]` from a report instead of commissioning a new study
+- [Pivot viability](../docs/recipes/pivot-viability.md) — research a pivot and compare it against the original
+- [New-market persona validation](../docs/recipes/new-market-persona-validation.md) — `create_persona` → `interview_persona`, no credits, no full run
+
+Rule of thumb: for a **full** validation, call the hero; reach for a primitive
+composition only for a **narrow, cheaper probe**.
+
+---
+
 ## Inputs
 
 | Field          | Type                     | Required | Default | Notes                                                                                            |

package/dist/server.js

@@ -1,8 +1,10 @@
 /**
  * MCP stdio server entry point.
  *
- * Registers the `clien_research` tool. Auth happens lazily on first tool call
- * so the server can announce its tool list without a browser interruption.
+ * The tool surface lives in `tools/registry.ts` — both `tools/list` and
+ * `tools/call` iterate the `TOOLS` array, so adding a tool needs no edits here.
+ * Auth happens lazily on first tool call so the server can announce its tool
+ * list without a browser interruption.
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -10,8 +12,8 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextpro
 import { loadConfig, PACKAGE_NAME, PACKAGE_VERSION } from './config.js';
 import { ensureSession, } from './auth/oauth.js';
 import { clearTokens, loadRefreshToken, saveRefreshToken, withTokenLock, } from './auth/storage.js';
-import { ResearchToolError, runResearch, } from './tools/research.js';
-import { StatusToolError, getResearchStatus, } from './tools/status.js';
+import { ToolError } from './tools/errors.js';
+import { TOOLS } from './tools/registry.js';
 function log(...args) {
     // stderr only — stdout is the MCP transport.
     console.error('[clien-mcp]', ...args);
@@ -29,88 +31,6 @@ async function defaultBrowserOpener() {
         await fn(url);
     };
 }
-/**
- * Input schema for the tool advert. Hand-rolled JSON Schema so we avoid the
- * `zod-to-json-schema` dependency. Must stay in sync with `ResearchInputSchema`
- * in `src/tools/research.ts` — the Zod parser is still the source of truth at
- * runtime; this is only the spec advertised to the caller.
- *
- * Drift surfaces silently: the Zod parser still accepts the input, but strict
- * MCP clients (`additionalProperties: false`) strip undeclared fields before
- * they reach the parser, and LLM callers never learn the field exists.
- * Enforcement: `__tests__/schema-contract.test.ts` walks both schemas and
- * fails if their property keys or required-field sets diverge. Exported here
- * so that test can import it. See
- * `docs/solutions/design-patterns/cross-package-schema-duplication-contract-2026-05-12.md`.
- */
-export const RESEARCH_INPUT_SCHEMA = {
-    type: 'object',
-    properties: {
-        idea: {
-            type: 'string',
-            minLength: 1,
-            maxLength: 10_000,
-            description: 'The product idea, feature hypothesis, or research question to validate. ' +
-                'Can be a one-liner or several paragraphs — more context yields a better report.',
-        },
-        depth: {
-            type: 'string',
-            enum: ['quick', 'deep'],
-            default: 'deep',
-            description: '"deep" (default) runs a 15-25 minute full research pass. ' +
-                '"quick" caps cost and runs a tighter pass.',
-        },
-        project_id: {
-            type: 'string',
-            format: 'uuid',
-            description: 'Optional Clien.ai project UUID to attach this run to. When omitted, ' +
-                'the run is standalone and not associated with any project.',
-        },
-        project_name: {
-            type: 'string',
-            minLength: 1,
-            maxLength: 100,
-            description: 'Name for a new Clien.ai project to attach this run to. You SHOULD ' +
-                'supply this whenever `project_id` is not set, otherwise the ' +
-                'resulting report will not be discoverable in the Clien.ai web UI. ' +
-                'Derive a short (2-4 word) human-readable name from the idea — ' +
-                'typically the product name. Guidance on when to create a new ' +
-                'project vs. reuse an existing one: create a NEW project (supply a ' +
-                'fresh `project_name`) for each distinct research idea or product ' +
-                'concept; REUSE an existing `project_id` only when the user ' +
-                'explicitly asks to add follow-up research to a prior run on the ' +
-                'same idea. Ignored when `project_id` is also provided.',
-        },
-    },
-    required: ['idea'],
-    additionalProperties: false,
-};
-/**
- * Hand-rolled JSON Schema advert for `clien_research_status`. Same
- * Zod-vs-JSON-schema duplication rules as RESEARCH_INPUT_SCHEMA above:
- * the runtime parser in tools/status.ts:StatusInputSchema is the source
- * of truth; this is the advert. Drift is caught by the schema-contract
- * test in __tests__/schema-contract.test.ts.
- */
-export const RESEARCH_STATUS_INPUT_SCHEMA = {
-    type: 'object',
-    properties: {
-        job_id: {
-            type: 'string',
-            format: 'uuid',
-            description: 'UUID of the research job to query. Returned in the `_meta.job_id` ' +
-                'field of a prior `clien_research` call, surfaced in error ' +
-                'messages when a run dropped mid-flight (e.g. "MCP error -32000"), ' +
-                'and printed to the MCP server\'s stderr log as ' +
-                '`[clien-mcp] research started job_id=<uuid>` at run start. Use ' +
-                'this tool to RECOVER an in-flight job instead of calling ' +
-                '`clien_research` again — calling research again would spawn a ' +
-                'new run and debit another 5 credits for the same outcome.',
-        },
-    },
-    required: ['job_id'],
-    additionalProperties: false,
-};
 export function createMcpServer() {
     const config = loadConfig();
     // Per-instance session cache. Scoping this to the closure (rather than the
@@ -142,31 +62,11 @@ export function createMcpServer() {
     }
     const server = new Server({ name: PACKAGE_NAME, version: PACKAGE_VERSION }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: [
-            {
-                name: 'clien_research',
-                description: 'Run a full product-research pass on an idea. Returns a markdown report plus ' +
-                    'structured report_data (hypotheses, competitors[], key findings). Typical wall time ' +
-                    '15-25 minutes; progress is streamed via notifications/progress. ' +
-                    'First call opens a browser for one-time OAuth login; subsequent calls reuse the stored refresh token. ' +
-                    'IMPORTANT: if this call fails mid-flight with "MCP error -32000: Connection closed", ' +
-                    'do NOT call clien_research again — that spawns a new run and debits another 5 credits for the same idea. ' +
-                    'Instead call `clien_research_status` with the job_id from the prior call\'s `_meta.job_id` ' +
-                    '(or from the `[clien-mcp] research started job_id=…` line in the MCP server\'s stderr log).',
-                inputSchema: RESEARCH_INPUT_SCHEMA,
-            },
-            {
-                name: 'clien_research_status',
-                description: 'Fetch the current state of an existing `clien_research` job. Use this to ' +
-                    'recover a run that disconnected with -32000 mid-flight (the job keeps running ' +
-                    'on the backend; this tool re-attaches a read view) and to poll for completion. ' +
-                    'If the job is complete, returns the full markdown report and structured report_data ' +
-                    'in the same shape `clien_research` would have returned — no need to call research again. ' +
-                    'If the job is still running, returns a brief status summary. If the job failed or ' +
-                    'was cancelled, returns the failure reason. Read-only: no credit cost, no side effects.',
-                inputSchema: RESEARCH_STATUS_INPUT_SCHEMA,
-            },
-        ],
+        tools: TOOLS.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.jsonSchema,
+        })),
     }));
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const toolName = request.params.name;
@@ -176,7 +76,8 @@ export function createMcpServer() {
         // inside the try-catch would convert it to a tool-level `isError`
         // response — the wrong shape, and a regression caught by
         // server.test.ts > 'unknown tool name surfaces an error'.
-        if (toolName !== 'clien_research' && toolName !== 'clien_research_status') {
+        const tool = TOOLS.find((t) => t.name === toolName);
+        if (!tool) {
             throw new Error(`Unknown tool: ${toolName}`);
         }
         // Per MCP spec, `progressToken` may be a string OR a number, and `0` or
@@ -203,46 +104,28 @@ export function createMcpServer() {
             : undefined;
         try {
             const session = await getSession();
-            if (toolName === 'clien_research') {
-                const result = await runResearch(request.params.arguments, {
-                    config,
-                    session,
-                    onProgress,
-                    invalidateSession,
-                });
-                return {
-                    content: result.content,
-                    _meta: result._meta,
-                };
-            }
-            if (toolName === 'clien_research_status') {
-                const result = await getResearchStatus(request.params.arguments, {
-                    config,
-                    session,
-                    invalidateSession,
-                });
-                return {
-                    content: result.content,
-                    _meta: result._meta,
-                };
-            }
-            // Unreachable: the pre-try unknown-tool guard above narrows toolName
-            // to the two valid names. Kept as a defense-in-depth fallback.
-            throw new Error(`Unknown tool: ${toolName}`);
+            const result = await tool.handler(request.params.arguments, {
+                config,
+                session,
+                onProgress,
+                invalidateSession,
+            });
+            return {
+                content: result.content,
+                _meta: result._meta,
+            };
         }
         catch (err) {
-            const message = err instanceof ResearchToolError || err instanceof StatusToolError
+            const message = err instanceof ToolError
                 ? err.userMessage
                 : err instanceof Error
                     ? err.message
                     : String(err);
             // Preserve the job_id on error responses so the host AI can pivot to
             // `clien_research_status` (or surface the id to the user) without
-            // having to parse it out of the human-readable error text. Both error
+            // having to parse it out of the human-readable error text. Tool error
             // classes carry a `jobId` field when one is known.
-            const errorJobId = err instanceof ResearchToolError || err instanceof StatusToolError
-                ? err.jobId
-                : undefined;
+            const errorJobId = err instanceof ToolError ? err.jobId : undefined;
             log('tool error:', message);
             return {
                 isError: true,

package/dist/server.js.map

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

package/dist/tools/errors.js

@@ -0,0 +1,23 @@
+/**
+ * Shared base class for tool-level errors.
+ *
+ * Every registry tool signals a user-recoverable failure by throwing a
+ * subclass of `ToolError`. The server's `CallTool` catch block maps any
+ * `ToolError` to a tool-level `{ isError: true, content, _meta.job_id? }`
+ * response (as opposed to a JSON-RPC protocol error). Carrying `userMessage`
+ * and the optional `jobId` on a single base means the dispatch needs exactly
+ * one `instanceof ToolError` check regardless of how many tools the registry
+ * holds — see `src/server.ts`.
+ */
+export class ToolError extends Error {
+    userMessage;
+    jobId;
+    constructor(userMessage, opts = {}) {
+        super(userMessage);
+        this.userMessage = userMessage;
+        this.jobId = opts.jobId;
+        if (opts.cause !== undefined)
+            this.cause = opts.cause;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/tools/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,WAAW,CAAQ;IACnB,KAAK,CAAS;IACvB,YAAY,WAAmB,EAAE,OAA4C,EAAE;QAC7E,KAAK,CAAC,WAAW,CAAC,CAAA;QAClB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACvB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAG,IAA4B,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAChF,CAAC;CACF"}

package/dist/tools/interview.js

@@ -0,0 +1,263 @@
+/**
+ * `interview_persona` — stateful, full-lifecycle interview tool over the
+ * interview REST API (FUL-17 lifecycle + FUL-43 conversational turn). Lets an
+ * agent drive a real multi-turn interview with a persona: start it, exchange
+ * turns (each returns the persona's FULL reply), read the transcript, and
+ * complete/reopen — reusing the same lifecycle as the web app (greeting seed,
+ * auto-summary on message thresholds, message-count maintenance), so an
+ * MCP-driven interview is indistinguishable from a web one in the DB.
+ *
+ * Like `personas.ts` / `projects.ts` this is a thin bearer-auth HTTP client: it
+ * reuses the shared `apiCall` from `research.ts` (401→refresh→retry, per-endpoint
+ * timeouts). No new HTTP machinery.
+ *
+ * One tool, many actions (an `action` discriminator on a FLAT object schema —
+ * the registry type and the schema-contract test both assume a `z.ZodObject`, so
+ * a `discriminatedUnion` is off the table). Per-action required fields are
+ * enforced in the handler, not via `.superRefine` (which would yield a
+ * `ZodEffects`, not a `ZodObject`).
+ *
+ * Contract (all bearer-authenticated, ownership derived from the parent project):
+ *   - start      → POST  /api/interviews                { projectId, personaId, withFirstMessage:true, ephemeral } → { interview, personaName, firstMessageContent }
+ *   - turn       → POST  /api/interviews/{id}/turn      { content } → { reply, message, userMessage, messageCount }
+ *   - transcript → GET   /api/interviews/{id}           → { interview }
+ *   - complete   → PATCH /api/interviews/{id}           { status:'completed' } → { interview }
+ *   - reopen     → PATCH /api/interviews/{id}           { status:'active' }    → { interview }
+ *
+ * The backend stamps `source='mcp'` automatically for bearer callers (FUL-21);
+ * `ephemeral: true` on `start` sets `include_in_insights=false`.
+ *
+ * Scope note: a `turn` generates a real AI reply, metered today only by the
+ * monthly usage limit. Per-turn credit debiting is deferred to FUL-33 (the turn
+ * endpoint and the generalized per-tool spend RPC / cost table aren't built yet).
+ */
+import { z } from 'zod';
+import { ToolError } from './errors.js';
+import { apiCall, categorizeFetchError, truncate, } from './research.js';
+const INTERVIEW_FETCH_TIMEOUT_MS = 60_000;
+/** Upper bound on a turn's question — matches the server's `MESSAGE_CONTENT_MAX`. */
+const CONTENT_MAX = 10_000;
+export const InterviewPersonaInputSchema = z.object({
+    action: z
+        .enum(['start', 'turn', 'transcript', 'complete', 'reopen'])
+        .describe('What to do this call. Drive a full interview as a loop: `start` once to open an ' +
+        'interview (seeds the persona\'s greeting), then `turn` repeatedly — send a question, ' +
+        'read the persona\'s full reply, decide the next question. `transcript` re-reads the ' +
+        'whole conversation. `complete` closes the interview when you\'ve learned enough ' +
+        '(5-12 turns is typical); `reopen` resumes a completed one.'),
+    projectId: z
+        .string()
+        .uuid()
+        .optional()
+        .describe('action=start: UUID of the project the interview belongs to. Get it from `list_projects` ' +
+        'or `create_project`. You are 404\'d if you do not own it.'),
+    personaId: z
+        .string()
+        .uuid()
+        .optional()
+        .describe('action=start: UUID of the persona to interview (must belong to `projectId`). Get it from ' +
+        '`create_persona` (`_meta.persona.id`).'),
+    interviewId: z
+        .string()
+        .uuid()
+        .optional()
+        .describe('action=turn/transcript/complete/reopen: UUID of the interview to act on. Returned by ' +
+        '`start` in `_meta.interview.id`.'),
+    content: z
+        .string()
+        .trim()
+        .min(1, 'content must be non-empty')
+        .max(CONTENT_MAX, `content too long (max ${CONTENT_MAX} chars)`)
+        .optional()
+        .describe('action=turn: the next question to ask the persona. The persona\'s full reply comes back ' +
+        'in the tool result text (and `_meta.reply`).'),
+    ephemeral: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('action=start: set true for a scratch/throwaway interview that should NOT count toward the ' +
+        'project\'s aggregate insights (sets include_in_insights=false). Leave false (the default) ' +
+        'for a real interview you want reflected in project-level analysis.'),
+});
+export class InterviewToolError extends ToolError {
+}
+function formatZodError(error) {
+    return error.issues.map((i) => `${i.path.join('.') || 'input'}: ${i.message}`).join('; ');
+}
+function makeCtx(deps) {
+    return { config: deps.config, session: deps.session, fetch: deps.fetch ?? fetch };
+}
+/**
+ * Shared non-ok handling, mirroring `personas.ts`: 401 drops the cached session
+ * (so the next tool call rebuilds from disk) and surfaces a re-auth message;
+ * 404 means the interview/project isn't owned by the caller; 400 surfaces the
+ * server's validation detail; everything else surfaces a generic HTTP error.
+ */
+async function throwForResponse(response, deps, action) {
+    const category = categorizeFetchError(response.status);
+    if (category === 'auth') {
+        if (response.refreshError?.kind !== 'transient')
+            deps.invalidateSession?.();
+        throw new InterviewToolError('Session expired. Re-run any Clien.ai tool to re-authenticate, then try again.');
+    }
+    if (response.status === 404) {
+        throw new InterviewToolError(`Could not ${action} — interview or project not found, or you don't own it. ` +
+            'Confirm the ids (list_projects / the id from `start`).');
+    }
+    const text = await response.text().catch(() => '');
+    let detail = truncate(text, 200);
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed?.error)
+            detail = `${parsed.error}${parsed.code ? ` (${parsed.code})` : ''}`;
+    }
+    catch {
+        // non-JSON body — fall back to the truncated raw text
+    }
+    if (response.status === 400) {
+        throw new InterviewToolError(`Could not ${action} — ${detail}`);
+    }
+    throw new InterviewToolError(`Failed to ${action} (HTTP ${response.status}): ${detail}`);
+}
+/** Run one `apiCall`, converting timeout/abort into a clear tool error. */
+async function call(ctx, method, path, action, body) {
+    try {
+        return await apiCall(ctx, method, path, {
+            ...(body ? { body } : {}),
+            timeoutMs: INTERVIEW_FETCH_TIMEOUT_MS,
+        });
+    }
+    catch (err) {
+        const e = err;
+        if (e.name === 'AbortError' || e.name === 'TimeoutError') {
+            throw new InterviewToolError(`Request to ${action} timed out after ${INTERVIEW_FETCH_TIMEOUT_MS / 1000}s. ` +
+                'It may or may not have been applied — fetch the transcript before retrying.');
+        }
+        throw err;
+    }
+}
+async function readJson(response) {
+    return (await response.json().catch(() => null));
+}
+function formatTranscript(interview) {
+    const messages = interview.messages ?? [];
+    const lines = messages.map((m) => {
+        const speaker = m.role === 'assistant' ? 'Persona' : 'Interviewer';
+        return `${speaker}: ${m.content ?? ''}`;
+    });
+    const header = `Interview ${interview.id ?? '?'} — status: ${interview.status ?? 'unknown'}, ` +
+        `${messages.length} message${messages.length === 1 ? '' : 's'}.`;
+    return lines.length > 0 ? `${header}\n\n${lines.join('\n\n')}` : header;
+}
+async function startInterview(input, ctx, deps) {
+    if (!input.projectId || !input.personaId) {
+        throw new InterviewToolError("action 'start' requires projectId and personaId.");
+    }
+    const response = await call(ctx, 'POST', '/api/interviews', 'start interview', {
+        projectId: input.projectId,
+        personaId: input.personaId,
+        withFirstMessage: true,
+        ephemeral: input.ephemeral,
+    });
+    if (!response.ok)
+        await throwForResponse(response, deps, 'start interview');
+    const json = await readJson(response);
+    const interview = json?.interview;
+    if (!interview?.id) {
+        throw new InterviewToolError('Interview creation returned no interview id; the operation may not have succeeded.');
+    }
+    const who = json?.personaName ? ` with ${json.personaName}` : '';
+    const greeting = json?.firstMessageContent ? `\nGreeting: ${json.firstMessageContent}` : '';
+    const insightsNote = input.ephemeral
+        ? ' Marked ephemeral — excluded from project insights.'
+        : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Started interview ${interview.id}${who}.${insightsNote}${greeting}\n` +
+                    "Ask questions with action='turn'; close it with action='complete' when done.",
+            },
+        ],
+        _meta: { interview, personaName: json?.personaName, firstMessageContent: json?.firstMessageContent },
+    };
+}
+async function sendTurn(input, ctx, deps) {
+    if (!input.interviewId || !input.content) {
+        throw new InterviewToolError("action 'turn' requires interviewId and content.");
+    }
+    const response = await call(ctx, 'POST', `/api/interviews/${input.interviewId}/turn`, 'send interview turn', { content: input.content });
+    if (!response.ok)
+        await throwForResponse(response, deps, 'send interview turn');
+    const json = await readJson(response);
+    const reply = json?.reply;
+    if (typeof reply !== 'string' || reply.length === 0) {
+        throw new InterviewToolError('Turn returned no persona reply; the turn may not have succeeded.');
+    }
+    return {
+        content: [{ type: 'text', text: reply }],
+        _meta: {
+            reply,
+            messageCount: json?.messageCount,
+            message: json?.message,
+            userMessage: json?.userMessage,
+        },
+    };
+}
+async function fetchTranscript(input, ctx, deps) {
+    if (!input.interviewId) {
+        throw new InterviewToolError("action 'transcript' requires interviewId.");
+    }
+    const response = await call(ctx, 'GET', `/api/interviews/${input.interviewId}`, 'fetch transcript');
+    if (!response.ok)
+        await throwForResponse(response, deps, 'fetch transcript');
+    const json = await readJson(response);
+    const interview = json?.interview;
+    if (!interview?.id) {
+        throw new InterviewToolError('Transcript fetch returned no interview.');
+    }
+    return {
+        content: [{ type: 'text', text: formatTranscript(interview) }],
+        _meta: { interview },
+    };
+}
+async function setStatus(input, ctx, deps, status) {
+    const action = status === 'completed' ? 'complete' : 'reopen';
+    if (!input.interviewId) {
+        throw new InterviewToolError(`action '${action}' requires interviewId.`);
+    }
+    const response = await call(ctx, 'PATCH', `/api/interviews/${input.interviewId}`, `${action} interview`, { status });
+    if (!response.ok)
+        await throwForResponse(response, deps, `${action} interview`);
+    const json = await readJson(response);
+    const interview = json?.interview;
+    if (!interview?.id) {
+        throw new InterviewToolError(`Could not ${action} interview — no interview returned.`);
+    }
+    const verb = status === 'completed' ? 'Completed' : 'Reopened';
+    return {
+        content: [{ type: 'text', text: `${verb} interview ${interview.id} (status: ${interview.status ?? status}).` }],
+        _meta: { interview },
+    };
+}
+export async function interviewPersona(input, deps) {
+    const parsed = InterviewPersonaInputSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new InterviewToolError(`Invalid input — ${formatZodError(parsed.error)}`);
+    }
+    const ctx = makeCtx(deps);
+    const data = parsed.data;
+    switch (data.action) {
+        case 'start':
+            return startInterview(data, ctx, deps);
+        case 'turn':
+            return sendTurn(data, ctx, deps);
+        case 'transcript':
+            return fetchTranscript(data, ctx, deps);
+        case 'complete':
+            return setStatus(data, ctx, deps, 'completed');
+        case 'reopen':
+            return setStatus(data, ctx, deps, 'active');
+    }
+}
+//# sourceMappingURL=interview.js.map

package/dist/tools/interview.js.map

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