@wiro-ai/wiro-mcp 1.3.3 → 1.4.0

package/dist/utils/agent-turns.d.ts

@@ -0,0 +1,354 @@
+import { z } from 'zod';
+import { type WiroClient } from '../client.js';
+import type { NextAction } from './structured.js';
+import { type AgentMessage } from './agent-message.js';
+import { type AgentTarget } from './agent-targets.js';
+import { type MediaItem } from './media.js';
+import { type ToolCallContext } from './poll.js';
+import { type StudioRun } from './studio-runs.js';
+import { summarizeWorkflowReply, type AttachedWorkflow, type WorkflowArtifactSummary, type WorkflowListResult } from './workflow-agent.js';
+export declare const agentTurnOutputSchema: {
+    agent: z.ZodString;
+    agentKind: z.ZodEnum<["studio", "workflow-agent", "deployed"]>;
+    session: z.ZodString;
+    sessionCreated: z.ZodOptional<z.ZodBoolean>;
+    done: z.ZodBoolean;
+    message: z.ZodObject<{
+        messageId: z.ZodString;
+        state: z.ZodEnum<["submitted", "running", "completed", "failed", "cancelled"]>;
+        status: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<["user_turn", "agent_message", "model_change", "voice_call"]>>;
+        userText: z.ZodOptional<z.ZodString>;
+        reply: z.ZodOptional<z.ZodString>;
+        replyTruncated: z.ZodOptional<z.ZodBoolean>;
+        mediaUrls: z.ZodArray<z.ZodString, "many">;
+        toolsUsed: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            status: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            status?: string | undefined;
+        }, {
+            name: string;
+            status?: string | undefined;
+        }>, "many">;
+        attachments: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            type?: string | undefined;
+            name?: string | undefined;
+        }, {
+            url: string;
+            type?: string | undefined;
+            name?: string | undefined;
+        }>, "many">;
+        model: z.ZodOptional<z.ZodString>;
+        creditsUsed: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        endedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        state: "completed" | "submitted" | "running" | "failed" | "cancelled";
+        messageId: string;
+        mediaUrls: string[];
+        toolsUsed: {
+            name: string;
+            status?: string | undefined;
+        }[];
+        attachments: {
+            url: string;
+            type?: string | undefined;
+            name?: string | undefined;
+        }[];
+        model?: string | undefined;
+        kind?: "user_turn" | "agent_message" | "model_change" | "voice_call" | undefined;
+        createdAt?: string | undefined;
+        endedAt?: string | undefined;
+        userText?: string | undefined;
+        reply?: string | undefined;
+        replyTruncated?: boolean | undefined;
+        creditsUsed?: number | null | undefined;
+    }, {
+        status: string;
+        state: "completed" | "submitted" | "running" | "failed" | "cancelled";
+        messageId: string;
+        mediaUrls: string[];
+        toolsUsed: {
+            name: string;
+            status?: string | undefined;
+        }[];
+        attachments: {
+            url: string;
+            type?: string | undefined;
+            name?: string | undefined;
+        }[];
+        model?: string | undefined;
+        kind?: "user_turn" | "agent_message" | "model_change" | "voice_call" | undefined;
+        createdAt?: string | undefined;
+        endedAt?: string | undefined;
+        userText?: string | undefined;
+        reply?: string | undefined;
+        replyTruncated?: boolean | undefined;
+        creditsUsed?: number | null | undefined;
+    }>;
+    partialReply: z.ZodOptional<z.ZodString>;
+    background: z.ZodOptional<z.ZodBoolean>;
+    modelChange: z.ZodOptional<z.ZodObject<{
+        fromModel: z.ZodOptional<z.ZodString>;
+        toModel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        fromModel?: string | undefined;
+        toModel?: string | undefined;
+    }, {
+        fromModel?: string | undefined;
+        toModel?: string | undefined;
+    }>>;
+    llmCostUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    modelRuns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        modelTitle: z.ZodOptional<z.ZodString>;
+        status: z.ZodString;
+        state: z.ZodEnum<["running", "completed", "failed", "cancelled"]>;
+        outputs: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            mimeType: z.ZodOptional<z.ZodString>;
+            sizeBytes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            name?: string | undefined;
+            mimeType?: string | undefined;
+            sizeBytes?: number | null | undefined;
+        }, {
+            url: string;
+            name?: string | undefined;
+            mimeType?: string | undefined;
+            sizeBytes?: number | null | undefined;
+        }>, "many">;
+        text: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        costUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        endedAt: z.ZodOptional<z.ZodString>;
+        elapsedSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        status: string;
+        state: "completed" | "running" | "failed" | "cancelled";
+        outputs: {
+            url: string;
+            name?: string | undefined;
+            mimeType?: string | undefined;
+            sizeBytes?: number | null | undefined;
+        }[];
+        model?: string | undefined;
+        text?: string | undefined;
+        prompt?: string | undefined;
+        costUsd?: number | null | undefined;
+        createdAt?: string | undefined;
+        endedAt?: string | undefined;
+        elapsedSeconds?: number | null | undefined;
+        modelTitle?: string | undefined;
+    }, {
+        id: string;
+        status: string;
+        state: "completed" | "running" | "failed" | "cancelled";
+        outputs: {
+            url: string;
+            name?: string | undefined;
+            mimeType?: string | undefined;
+            sizeBytes?: number | null | undefined;
+        }[];
+        model?: string | undefined;
+        text?: string | undefined;
+        prompt?: string | undefined;
+        costUsd?: number | null | undefined;
+        createdAt?: string | undefined;
+        endedAt?: string | undefined;
+        elapsedSeconds?: number | null | undefined;
+        modelTitle?: string | undefined;
+    }>, "many">>;
+    modelRunsPending: z.ZodOptional<z.ZodBoolean>;
+    attachedWorkflow: z.ZodOptional<z.ZodObject<{
+        fullSlug: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        updatetime: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        fullSlug: string;
+        updatetime: string;
+        title?: string | undefined;
+    }, {
+        url: string;
+        fullSlug: string;
+        updatetime: string;
+        title?: string | undefined;
+    }>>;
+    workflows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        status: z.ZodEnum<["valid", "invalid", "oversize", "incomplete"]>;
+        valid: z.ZodBoolean;
+        artifactHash: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        nodeCount: z.ZodOptional<z.ZodNumber>;
+        models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        issues: z.ZodArray<z.ZodString, "many">;
+        issueCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        status: "incomplete" | "valid" | "invalid" | "oversize";
+        valid: boolean;
+        issues: string[];
+        index: number;
+        issueCount: number;
+        description?: string | undefined;
+        title?: string | undefined;
+        models?: string[] | undefined;
+        artifactHash?: string | undefined;
+        nodeCount?: number | undefined;
+    }, {
+        status: "incomplete" | "valid" | "invalid" | "oversize";
+        valid: boolean;
+        issues: string[];
+        index: number;
+        issueCount: number;
+        description?: string | undefined;
+        title?: string | undefined;
+        models?: string[] | undefined;
+        artifactHash?: string | undefined;
+        nodeCount?: number | undefined;
+    }>, "many">>;
+    workflowList: z.ZodOptional<z.ZodObject<{
+        search: z.ZodOptional<z.ZodString>;
+        limit: z.ZodNumber;
+        total: z.ZodOptional<z.ZodNumber>;
+        rows: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            fullSlug: z.ZodString;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            url: string;
+            fullSlug: string;
+            updatedAt?: string | undefined;
+        }, {
+            title: string;
+            url: string;
+            fullSlug: string;
+            updatedAt?: string | undefined;
+        }>, "many">;
+        instruction: z.ZodString;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        rows: {
+            title: string;
+            url: string;
+            fullSlug: string;
+            updatedAt?: string | undefined;
+        }[];
+        instruction: string;
+        error?: string | undefined;
+        search?: string | undefined;
+        total?: number | undefined;
+    }, {
+        limit: number;
+        rows: {
+            title: string;
+            url: string;
+            fullSlug: string;
+            updatedAt?: string | undefined;
+        }[];
+        instruction: string;
+        error?: string | undefined;
+        search?: string | undefined;
+        total?: number | undefined;
+    }>>;
+    notes: z.ZodArray<z.ZodString, "many">;
+    nextAction: z.ZodOptional<z.ZodObject<{
+        tool: z.ZodString;
+        arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        arguments: Record<string, unknown>;
+        tool: string;
+        reason: string;
+    }, {
+        arguments: Record<string, unknown>;
+        tool: string;
+        reason: string;
+    }>>;
+};
+export interface AgentTurnResult {
+    [key: string]: unknown;
+    agent: string;
+    agentKind: AgentTarget['kind'];
+    session: string;
+    sessionCreated?: boolean;
+    done: boolean;
+    message: AgentMessage;
+    partialReply?: string;
+    background?: boolean;
+    modelChange?: {
+        fromModel?: string;
+        toModel?: string;
+    };
+    llmCostUsd?: number | null;
+    modelRuns?: StudioRun[];
+    modelRunsPending?: boolean;
+    attachedWorkflow?: AttachedWorkflow;
+    workflows?: WorkflowArtifactSummary[];
+    workflowList?: WorkflowListResult;
+    notes: string[];
+    nextAction?: NextAction;
+}
+export interface CollectTurnOptions {
+    client: WiroClient;
+    target: AgentTarget;
+    messageId: string;
+    /** The session Detail is addressed with; undefined only for deployed agents. */
+    session: string | undefined;
+    waitSeconds: number;
+    extra?: ToolCallContext;
+    /** Set by send: the status Send reported, used until the row is readable. */
+    sentStatus?: string;
+    /** Unix seconds just before Send, for when the row has no createdat yet. */
+    sentAt?: number;
+    /** Send with wait_seconds 0 returns without reading the row. */
+    skipRead?: boolean;
+    /** Set by send when reading the queued turn failed: it is reported as pending, never as an error. */
+    readFailure?: unknown;
+    includeUserText?: boolean;
+    sessionCreated?: boolean;
+    modelChange?: {
+        fromModel?: string;
+        toModel?: string;
+    };
+    attachedWorkflow?: AttachedWorkflow;
+}
+export declare function notFoundMessage(target: AgentTarget): string;
+interface ProjectedMessage {
+    message: AgentMessage;
+    partialReply?: string;
+    workflowReply?: ReturnType<typeof summarizeWorkflowReply>;
+}
+/** The public message; for the Workflow Agent the reply keeps only the prose. */
+export declare function projectAgentMessage(target: AgentTarget, row: Record<string, unknown>, includeUserText: boolean): ProjectedMessage;
+export declare function collectTurn(options: CollectTurnOptions): Promise<AgentTurnResult>;
+/**
+ * Files to present once the turn is over: every model run output, and the
+ * reply's own URLs when they point at a media file rather than a web page.
+ * Only files on Wiro's own hosts count; anything else stays a plain link.
+ */
+export declare function turnMediaItems(result: AgentTurnResult): MediaItem[];
+/** The tool result content: the text, then the media as resource links. */
+export declare function turnContent(target: AgentTarget, result: AgentTurnResult): import("./media.js").MediaContentBlock[];
+export declare function formatTurn(target: AgentTarget, result: AgentTurnResult): string;
+export {};
+//# sourceMappingURL=agent-turns.d.ts.map

package/dist/utils/agent-turns.d.ts.map

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