@askthew/mcp-plugin 0.4.10 → 0.4.12

package/dist/cloud-client.d.ts

@@ -0,0 +1,80 @@
+export type CloudTokenFile = {
+    token: string;
+    install_id: string;
+    tier?: "free" | "paid";
+    workspace_id?: string | null;
+    token_purpose?: "conversation" | "device";
+    api_url?: string;
+};
+export type Fetcher = typeof fetch;
+export type CloudClientOptions = {
+    apiUrl?: string;
+    token?: string;
+    fetcher?: Fetcher;
+    env?: NodeJS.ProcessEnv;
+};
+export declare function loadCloudToken(env?: NodeJS.ProcessEnv): CloudTokenFile | null;
+export declare function saveCloudToken(tokenFile: CloudTokenFile, env?: NodeJS.ProcessEnv): void;
+export declare class AskTheWCloudClient {
+    private readonly apiUrl;
+    private readonly token?;
+    private readonly fetcher;
+    constructor(options?: CloudClientOptions);
+    hasToken(): boolean;
+    request(path: string, init?: RequestInit): Promise<{
+        ok: boolean;
+        status: number;
+        body: any;
+    }>;
+    captureSignal(payload: Record<string, unknown>): Promise<{
+        ok: boolean;
+        status: number;
+        body: any;
+    }>;
+    listSignals(input?: {
+        sessionId?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<{
+        body: unknown;
+        ok: boolean;
+        status: number;
+    }>;
+    createDecision(payload: Record<string, unknown>): Promise<{
+        ok: boolean;
+        status: number;
+        body: any;
+    }>;
+    listDecisions(input?: {
+        limit?: number;
+    }): Promise<{
+        body: unknown;
+        ok: boolean;
+        status: number;
+    }>;
+    recap(input: Record<string, unknown>): Promise<{
+        ok: boolean;
+        status: number;
+        body: any;
+    }>;
+    coach(input: Record<string, unknown>): Promise<{
+        ok: boolean;
+        status: number;
+        body: any;
+    }>;
+}
+export declare function startSignup(input: {
+    email: string;
+    apiUrl?: string;
+    clientHint?: string;
+    fetcher?: Fetcher;
+}): Promise<any>;
+export declare function completeSignup(input: {
+    email: string;
+    code: string;
+    apiUrl?: string;
+    clientHint?: string;
+    tokenPurpose?: "conversation" | "device";
+    fetcher?: Fetcher;
+    env?: NodeJS.ProcessEnv;
+}): Promise<any>;

package/dist/cloud-client.js

@@ -0,0 +1,150 @@
+import { cloudTokenPath, readJsonFile, writePrivateJson } from "./lib/paths.js";
+function trimBaseUrl(value) {
+    return (value?.trim() || "https://app.askthew.com").replace(/\/+$/, "");
+}
+export function loadCloudToken(env = process.env) {
+    return readJsonFile(cloudTokenPath(env));
+}
+export function saveCloudToken(tokenFile, env = process.env) {
+    writePrivateJson(cloudTokenPath(env), tokenFile);
+}
+function snakeSignal(payload) {
+    return {
+        kind: payload.kind,
+        summary: payload.summary,
+        session_id: payload.sessionId,
+        sequence: payload.sequence,
+        idempotency_key: payload.idempotencyKey,
+        client_id: payload.clientId,
+        scope_key: payload.scopeKey,
+        evidence: payload.evidence,
+        files_touched: payload.filesTouched,
+        commands_run: payload.commandsRun,
+        metadata: payload.metadata,
+    };
+}
+function camelize(value) {
+    if (Array.isArray(value))
+        return value.map(camelize);
+    if (typeof value !== "object" || value === null)
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
+        key.replace(/_([a-z])/g, (_, char) => char.toUpperCase()),
+        camelize(entry),
+    ]));
+}
+export class AskTheWCloudClient {
+    apiUrl;
+    token;
+    fetcher;
+    constructor(options = {}) {
+        const tokenFile = loadCloudToken(options.env);
+        this.apiUrl = trimBaseUrl(options.apiUrl ?? tokenFile?.api_url);
+        this.token = options.token ?? tokenFile?.token;
+        this.fetcher = options.fetcher ?? fetch;
+    }
+    hasToken() {
+        return Boolean(this.token);
+    }
+    async request(path, init = {}) {
+        if (!this.token) {
+            return {
+                ok: false,
+                status: 401,
+                body: {
+                    ok: false,
+                    code: "needs_signup",
+                    message: "Ask The W needs signup. Call askthew_start_signup, then askthew_complete_signup.",
+                },
+            };
+        }
+        const response = await this.fetcher(`${this.apiUrl}/api/v1/agent${path}`, {
+            ...init,
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.token}`,
+                ...(init.headers ?? {}),
+            },
+        });
+        const body = await response.json().catch(() => ({}));
+        return { ok: response.ok, status: response.status, body };
+    }
+    async captureSignal(payload) {
+        return this.request("/signals", {
+            method: "POST",
+            body: JSON.stringify(snakeSignal(payload)),
+        });
+    }
+    async listSignals(input = {}) {
+        const params = new URLSearchParams();
+        if (input.sessionId)
+            params.set("session_id", input.sessionId);
+        if (input.since)
+            params.set("since", input.since);
+        if (input.limit)
+            params.set("limit", String(input.limit));
+        const result = await this.request(`/signals${params.size ? `?${params.toString()}` : ""}`);
+        return { ...result, body: camelize(result.body) };
+    }
+    async createDecision(payload) {
+        const body = {
+            content: payload.content,
+            source_signal_ids: payload.sourceSignalIds,
+            status: payload.status,
+            outcome_id: payload.outcomeId,
+        };
+        return this.request("/decisions", { method: "POST", body: JSON.stringify(body) });
+    }
+    async listDecisions(input = {}) {
+        const params = new URLSearchParams();
+        if (input.limit)
+            params.set("limit", String(input.limit));
+        const result = await this.request(`/decisions${params.size ? `?${params.toString()}` : ""}`);
+        return { ...result, body: camelize(result.body) };
+    }
+    async recap(input) {
+        return this.request("/recap", {
+            method: "POST",
+            body: JSON.stringify({ since: input.since, max_signals: input.maxSignals }),
+        });
+    }
+    async coach(input) {
+        return this.request("/coach", {
+            method: "POST",
+            body: JSON.stringify({ focus: input.focus }),
+        });
+    }
+}
+export async function startSignup(input) {
+    const base = trimBaseUrl(input.apiUrl);
+    const response = await (input.fetcher ?? fetch)(`${base}/api/v1/agent/signup`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ email: input.email, client_hint: input.clientHint }),
+    });
+    return response.json();
+}
+export async function completeSignup(input) {
+    const base = trimBaseUrl(input.apiUrl);
+    const response = await (input.fetcher ?? fetch)(`${base}/api/v1/agent/verify`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            email: input.email,
+            code: input.code,
+            client_hint: input.clientHint,
+            token_purpose: input.tokenPurpose ?? "device",
+        }),
+    });
+    const body = await response.json();
+    if (response.ok && body?.ok && body.token && body.install_id) {
+        saveCloudToken({
+            token: body.token,
+            install_id: body.install_id,
+            tier: "free",
+            token_purpose: input.tokenPurpose ?? "device",
+            api_url: base,
+        }, input.env);
+    }
+    return body;
+}

package/dist/index.d.ts

@@ -1,168 +1,65 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
+import { type Fetcher } from "./cloud-client.js";
+import { Outbox } from "./outbox.js";
 export declare const codingSessionSignalSchema: z.ZodObject<{
     sessionId: z.ZodString;
     sequence: z.ZodNumber;
     kind: z.ZodEnum<["setup_complete", "session_checkpoint", "direction_change", "implementation_update", "verification_result", "final_summary"]>;
     summary: z.ZodString;
+    idempotencyKey: z.ZodEffects<z.ZodString, string, string>;
+    clientId: z.ZodOptional<z.ZodEnum<["claude_code", "codex", "cursor", "web_agent"]>>;
+    scopeKey: z.ZodDefault<z.ZodString>;
     evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
         role: z.ZodEnum<["user", "assistant", "system"]>;
         excerpt: z.ZodString;
-        kind: z.ZodOptional<z.ZodEnum<["excerpt", "diff", "prompt_diff"]>>;
-        diff: z.ZodOptional<z.ZodString>;
-        before: z.ZodOptional<z.ZodString>;
-        after: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         role: "user" | "assistant" | "system";
         excerpt: string;
-        diff?: string | undefined;
-        kind?: "diff" | "excerpt" | "prompt_diff" | undefined;
-        before?: string | undefined;
-        after?: string | undefined;
     }, {
         role: "user" | "assistant" | "system";
         excerpt: string;
-        diff?: string | undefined;
-        kind?: "diff" | "excerpt" | "prompt_diff" | undefined;
-        before?: string | undefined;
-        after?: string | undefined;
     }>, "many">>;
     filesTouched: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     commandsRun: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    sessionId: string;
     kind: "setup_complete" | "session_checkpoint" | "direction_change" | "implementation_update" | "verification_result" | "final_summary";
-    sequence: number;
     summary: string;
+    sessionId: string;
+    sequence: number;
+    idempotencyKey: string;
+    scopeKey: string;
     evidence: {
         role: "user" | "assistant" | "system";
         excerpt: string;
-        diff?: string | undefined;
-        kind?: "diff" | "excerpt" | "prompt_diff" | undefined;
-        before?: string | undefined;
-        after?: string | undefined;
     }[];
     filesTouched: string[];
     commandsRun: string[];
     metadata: Record<string, unknown>;
+    clientId?: "claude_code" | "codex" | "cursor" | "web_agent" | undefined;
 }, {
-    sessionId: string;
     kind: "setup_complete" | "session_checkpoint" | "direction_change" | "implementation_update" | "verification_result" | "final_summary";
-    sequence: number;
     summary: string;
+    sessionId: string;
+    sequence: number;
+    idempotencyKey: string;
+    clientId?: "claude_code" | "codex" | "cursor" | "web_agent" | undefined;
+    scopeKey?: string | undefined;
     evidence?: {
         role: "user" | "assistant" | "system";
         excerpt: string;
-        diff?: string | undefined;
-        kind?: "diff" | "excerpt" | "prompt_diff" | undefined;
-        before?: string | undefined;
-        after?: string | undefined;
     }[] | undefined;
     filesTouched?: string[] | undefined;
     commandsRun?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
 }>;
 export type CodingSessionSignal = z.infer<typeof codingSessionSignalSchema>;
-export declare const provenanceSignalSchema: z.ZodObject<{
-    source: z.ZodString;
-    decision: z.ZodString;
-    rationale: z.ZodString;
-    confidence: z.ZodNumber;
-    framework: z.ZodOptional<z.ZodString>;
-    filesAffected: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    sessionId: z.ZodString;
-    pendingApproval: z.ZodOptional<z.ZodBoolean>;
-    originatingPrompt: z.ZodOptional<z.ZodString>;
-    installToken: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    sessionId: string;
-    metadata: Record<string, unknown>;
-    source: string;
-    decision: string;
-    rationale: string;
-    confidence: number;
-    filesAffected: string[];
-    framework?: string | undefined;
-    pendingApproval?: boolean | undefined;
-    originatingPrompt?: string | undefined;
-    installToken?: string | undefined;
-}, {
-    sessionId: string;
-    source: string;
-    decision: string;
-    rationale: string;
-    confidence: number;
-    metadata?: Record<string, unknown> | undefined;
-    framework?: string | undefined;
-    filesAffected?: string[] | undefined;
-    pendingApproval?: boolean | undefined;
-    originatingPrompt?: string | undefined;
-    installToken?: string | undefined;
-}>;
-export type ProvenanceSignal = z.infer<typeof provenanceSignalSchema>;
-type AskTheWConfig = {
-    redaction?: {
-        enabled?: boolean;
-    };
-    digest?: {
-        footer?: boolean;
-    };
-};
-export declare function loadAskTheWConfig(env?: NodeJS.ProcessEnv): AskTheWConfig;
-export declare function redactProvenanceSignal(input: ProvenanceSignal): {
-    sessionId: string;
-    metadata: Record<string, unknown>;
-    source: string;
-    decision: string;
-    rationale: string;
-    confidence: number;
-    filesAffected: string[];
-    framework?: string | undefined;
-    pendingApproval?: boolean | undefined;
-    originatingPrompt?: string | undefined;
-    installToken?: string | undefined;
-};
-export declare function redactCodingSessionSignal(input: CodingSessionSignal): {
-    sessionId: string;
-    kind: "setup_complete" | "session_checkpoint" | "direction_change" | "implementation_update" | "verification_result" | "final_summary";
-    sequence: number;
-    summary: string;
-    evidence: {
-        role: "user" | "assistant" | "system";
-        excerpt: string;
-        diff?: string | undefined;
-        kind?: "diff" | "excerpt" | "prompt_diff" | undefined;
-        before?: string | undefined;
-        after?: string | undefined;
-    }[];
-    filesTouched: string[];
-    commandsRun: string[];
-    metadata: Record<string, unknown>;
-};
 export interface AskTheWMcpServerOptions {
-    credentials?: {
-        installToken?: string;
-        userId?: string;
-        apiKey?: string;
-        serverName?: string;
-        clientId?: string;
-        clientLabel?: string;
-        hostType?: "claude_code" | "codex" | "cursor";
-    };
-    apiBaseUrl?: string;
-    fetchImpl?: typeof fetch;
-    runtimeMetadata?: Record<string, unknown> | (() => Record<string, unknown>);
-    sendStartupHeartbeat?: boolean;
+    apiUrl?: string;
+    fetcher?: Fetcher;
+    env?: NodeJS.ProcessEnv;
+    outbox?: Outbox;
 }
-export declare function normalizeInstallTokenInput(token: string | undefined): string;
 export declare function createAskTheWMcpServer(options?: AskTheWMcpServerOptions): McpServer;
-export declare function runInitializeHandshake(input?: {
-    entrypoint?: string;
-    env?: NodeJS.ProcessEnv;
-    timeoutMs?: number;
-}): Promise<{
-    serverInfoVersion?: string;
-}>;
-export {};
+export declare function runStdioServer(options?: AskTheWMcpServerOptions): Promise<void>;