@wiro-ai/wiro-mcp 1.3.4 → 1.4.1

package/dist/tools/list-agent-skills.js

@@ -0,0 +1,242 @@
+import { z } from 'zod';
+import { ApiResultError, asString, errorResult, isPlainObject, requireApiSuccess, } from '../utils/api.js';
+import { credentialSetupSchema, isPlatformCredentialKey, skillSummarySchema, toCredentialSetup, toSkillSummary, } from '../utils/agent-catalog.js';
+import { connectionModeRequirements, parseCredentialMeta, } from '../utils/agent-config.js';
+import { formatUsd, toStringArray } from '../utils/user-agent.js';
+import { nextActionSchema } from './schemas.js';
+const PRICING_NOTE = 'A custom build costs the sum of its skills\' monthly prices, including the skills they '
+    + 'depend on, and Starter has a minimum monthly price. Pro is a fixed multiple of Starter. deploy_agent '
+    + 'returns the exact quote before anything is charged.';
+const channelSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    credentialKey: z.string(),
+    requiredFields: z.array(z.string()),
+});
+async function readCredential(client, key, signal) {
+    const body = await client.post('/Credentials/Detail', { key }, signal);
+    return body?.result === true && isPlainObject(body.credential) ? body.credential : null;
+}
+function toChannels(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter(isPlainObject).map(channel => {
+        const id = asString(channel.id) ?? '';
+        return {
+            id,
+            title: asString(channel.title) ?? id,
+            credentialKey: asString(channel.credential_key) ?? id,
+            requiredFields: toStringArray(channel.required_fields),
+        };
+    });
+}
+function skillLine(skill) {
+    const price = skill.monthlyPriceUsd > 0 ? `${formatUsd(skill.monthlyPriceUsd)} per month` : 'free';
+    const credential = skill.requiresCredentials && skill.credentialKey ? `, needs \`${skill.credentialKey}\`` : '';
+    const deprecated = skill.deprecated ? `, deprecated${skill.replacement ? ` (use ${skill.replacement})` : ''}` : '';
+    return `- **${skill.title}** (\`${skill.name}\`): ${price}${credential}${deprecated}${skill.description ? `. ${skill.description}` : ''}`;
+}
+function toCredentialEntry(credential, role) {
+    return {
+        setup: toCredentialSetup(credential, role),
+        modes: connectionModeRequirements(parseCredentialMeta(credential), null).filter(mode => mode.available),
+    };
+}
+/** The keys of a list's entries, one line each, with a list inside an entry indented below it. */
+function entryLines(items, depth) {
+    return items.flatMap(item => {
+        const notes = [
+            item.required === undefined ? undefined : item.required ? 'required' : 'optional',
+            item.type,
+            item.options ? `one of: ${item.options.map(option => option.value || '(empty)').join(', ')}` : undefined,
+        ].filter(Boolean).join(', ');
+        const help = item.help ? `: ${item.help.replace(/\n/g, ' ')}` : '';
+        const indent = '  '.repeat(depth);
+        return [
+            `${indent}- **${item.label ?? item.key}** (\`${item.key}\`${notes ? `, ${notes}` : ''})${help}`,
+            ...(item.itemFields ? [`${indent}  Each entry:`, ...entryLines(item.itemFields, depth + 1)] : []),
+        ];
+    });
+}
+function setupLines({ setup: credential, modes }) {
+    const lines = [`### ${credential.title} (\`${credential.key}\`, ${credential.role})`, ''];
+    if (credential.oauth && modes.length > 0) {
+        lines.push('How it connects (connect_agent_oauth or set_agent_credentials):');
+        for (const mode of modes) {
+            lines.push(`- **${mode.mode}**: ${mode.note}${mode.fields.length > 0 ? ` Fields: ${mode.fields.map(field => field.field).join(', ')}.` : ''}`);
+        }
+        lines.push('');
+    }
+    if (credential.note)
+        lines.push(credential.note);
+    if (credential.channel) {
+        lines.push(`Chat channel \`${credential.channel.id}\`: it turns on once ${credential.channel.requiredFields.join(', ')} are filled.`);
+    }
+    for (const field of credential.fields.filter(item => item.writable)) {
+        const notes = [
+            field.required ? 'required' : 'optional',
+            field.type,
+            field.secret ? 'secret' : undefined,
+            field.onlyInModes ? `only for ${field.onlyInModes.join('/')} mode` : undefined,
+        ].filter(Boolean).join(', ');
+        lines.push(`- **${field.label}** (\`${field.key}\`, ${notes})`);
+        if (field.help)
+            lines.push(`  ${field.help.replace(/\n/g, ' ')}`);
+        if (field.itemFields)
+            lines.push('  Each entry:', ...entryLines(field.itemFields, 1));
+    }
+    return lines;
+}
+export function registerListAgentSkills(server, client) {
+    server.registerTool('list_agent_skills', {
+        title: 'List Wiro agent skills',
+        description: 'List the skills a Wiro agent can have, with their monthly price, the skills they depend '
+            + 'on and the credential each one needs. Use it to plan a custom build for deploy_agent or a skill '
+            + 'change for apply_agent_skills. Without `name` it lists every skill with its title and price: look '
+            + 'there for the service the user named (apply_agent_skills also answers an unknown name with close '
+            + 'matches). Pass `name` with a skill name (or a credential or channel key such '
+            + 'as "telegram") to get the exact fields the user must provide, with their labels, formats and setup '
+            + 'help, so you know what to ask for before calling set_agent_credentials or connect_agent_oauth.',
+        inputSchema: {
+            name: z.string().min(1).max(100).optional()
+                .describe('A skill name (for example "int-gmail-check") returns its price and the setup fields of every credential it needs. A credential or channel key (for example "telegram") returns that credential\'s setup and the ways it can connect.'),
+            category: z.enum(['int', 'util']).optional()
+                .describe('"int" for skills that connect to an outside service, "util" for helper skills.'),
+            capability: z.string().max(100).optional()
+                .describe('Only skills with this capability, for example "image_generation". include_capabilities lists the names.'),
+            include_capabilities: z.boolean().default(false)
+                .describe('Also return the list of capability names with descriptions.'),
+            include_deprecated: z.boolean().default(false)
+                .describe('Also return deprecated skills.'),
+        },
+        outputSchema: {
+            skills: z.array(skillSummarySchema),
+            channels: z.array(channelSchema),
+            total: z.number().int().nonnegative(),
+            capabilities: z.array(z.object({ name: z.string(), description: z.string().optional() })).optional(),
+            setup: z.object({ credentials: z.array(credentialSetupSchema) }).optional(),
+            pricingNote: z.string(),
+            nextAction: nextActionSchema.optional(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ name, category, capability, include_capabilities, include_deprecated }, extra) => {
+        try {
+            let capabilities;
+            if (include_capabilities) {
+                const body = requireApiSuccess(await client.post('/Skills/Capabilities', {}, extra.signal), 'The capability list could not be read.');
+                capabilities = (Array.isArray(body.capabilities) ? body.capabilities : [])
+                    .filter(isPlainObject)
+                    .flatMap(item => {
+                    const capabilityName = asString(item.name);
+                    const description = asString(item.description);
+                    return capabilityName ? [{ name: capabilityName, ...(description ? { description } : {}) }] : [];
+                });
+            }
+            if (name) {
+                const key = name.trim();
+                const detail = await client.post('/Skills/Detail', { name: key }, extra.signal);
+                let skills = [];
+                const credentials = [];
+                if (detail?.result === true && isPlainObject(detail.skill)) {
+                    const skill = toSkillSummary(detail.skill);
+                    skills = [skill];
+                    const keys = skill.requiresCredentials
+                        ? [
+                            ...(skill.credentialKey ? [{ key: skill.credentialKey, role: 'primary' }] : []),
+                            ...(skill.additionalCredentialKeys ?? []).map(extraKey => ({ key: extraKey, role: 'additional' })),
+                        ]
+                        : [];
+                    for (const entry of keys) {
+                        if (isPlatformCredentialKey(entry.key))
+                            continue;
+                        const credential = await readCredential(client, entry.key, extra.signal);
+                        if (credential)
+                            credentials.push(toCredentialEntry(credential, entry.role));
+                    }
+                }
+                else {
+                    const credential = await readCredential(client, key, extra.signal);
+                    if (!credential || isPlatformCredentialKey(key)) {
+                        throw new ApiResultError(`No skill or credential is named "${key}". Call list_agent_skills without name to see every skill.`, [404], {});
+                    }
+                    credentials.push(toCredentialEntry(credential, 'credential'));
+                }
+                const lines = [];
+                for (const skill of skills)
+                    lines.push(`## Skill`, '', skillLine(skill));
+                if (skills[0]?.dependsOn.length)
+                    lines.push('', `Also enables: ${skills[0].dependsOn.join(', ')}`);
+                if (skills[0] && !skills[0].requiresCredentials)
+                    lines.push('', 'This skill needs no credentials.');
+                for (const credential of credentials)
+                    lines.push('', ...setupLines(credential));
+                lines.push('', PRICING_NOTE);
+                return {
+                    content: [{ type: 'text', text: lines.join('\n') }],
+                    structuredContent: {
+                        skills,
+                        channels: [],
+                        total: skills.length,
+                        ...(capabilities ? { capabilities } : {}),
+                        setup: { credentials: credentials.map(entry => entry.setup) },
+                        pricingNote: PRICING_NOTE,
+                    },
+                };
+            }
+            const body = requireApiSuccess(await client.post('/Skills/List', {
+                ...(category ? { category } : {}),
+                ...(capability?.trim() ? { capability: capability.trim() } : {}),
+            }, extra.signal), 'The skill list could not be read.');
+            const skills = (Array.isArray(body.skills) ? body.skills : [])
+                .filter(isPlainObject)
+                .map(toSkillSummary)
+                .filter(skill => skill.name && (include_deprecated || !skill.deprecated));
+            const channels = toChannels(body.channels);
+            const lines = [`## Agent skills (${skills.length})`, ''];
+            if (skills.length === 0)
+                lines.push('No skills matched.');
+            for (const skill of skills)
+                lines.push(skillLine(skill));
+            if (channels.length > 0) {
+                lines.push('', '### Chat channels', '', 'Channels are not skills. Each one turns on once its required fields are set with set_agent_credentials.');
+                for (const channel of channels)
+                    lines.push(`- ${channel.title} (\`${channel.credentialKey}\`): ${channel.requiredFields.join(', ')}`);
+            }
+            if (capabilities?.length) {
+                lines.push('', '### Capabilities', '');
+                for (const item of capabilities)
+                    lines.push(`- \`${item.name}\`${item.description ? `: ${item.description}` : ''}`);
+            }
+            lines.push('', PRICING_NOTE);
+            const firstWithCredentials = skills.find(skill => skill.requiresCredentials);
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+                structuredContent: {
+                    skills,
+                    channels,
+                    total: skills.length,
+                    ...(capabilities ? { capabilities } : {}),
+                    pricingNote: PRICING_NOTE,
+                    ...(firstWithCredentials
+                        ? {
+                            nextAction: {
+                                tool: 'list_agent_skills',
+                                arguments: { name: firstWithCredentials.name },
+                                reason: 'See exactly which credential fields a skill needs before choosing it.',
+                            },
+                        }
+                        : {}),
+                },
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=list-agent-skills.js.map

package/dist/tools/list-agent-skills.js.map

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

package/dist/tools/list-agent-templates.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { WiroClient } from '../client.js';
+export declare function registerListAgentTemplates(server: McpServer, client: WiroClient): void;
+//# sourceMappingURL=list-agent-templates.d.ts.map

package/dist/tools/list-agent-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agent-templates.d.ts","sourceRoot":"","sources":["../../src/tools/list-agent-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB/C,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA+FtF"}

package/dist/tools/list-agent-templates.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { errorResult, isPlainObject, requireApiSuccess, toNumber } from '../utils/api.js';
+import { templateSummarySchema, toTemplateSummary } from '../utils/agent-catalog.js';
+import { formatCredits, formatUsd } from '../utils/user-agent.js';
+import { nextActionSchema } from './schemas.js';
+const SORTS = {
+    newest: { sort: 'id', order: 'DESC' },
+    popular: { sort: 'totalrun', order: 'DESC' },
+    title: { sort: 'title', order: 'ASC' },
+};
+function priceLine(template) {
+    if (!template.pricing)
+        return 'pricing unavailable';
+    const { starter, pro } = template.pricing;
+    return `Starter ${formatUsd(starter.priceUsd)} (${formatCredits(starter.monthlyCredits)} credits), `
+        + `Pro ${formatUsd(pro.priceUsd)} (${formatCredits(pro.monthlyCredits)} credits) per 30 days`;
+}
+export function registerListAgentTemplates(server, client) {
+    server.registerTool('list_agent_templates', {
+        title: 'List Wiro agent templates',
+        description: 'Browse the catalog of ready-made Wiro agents (templates) that deploy_agent can deploy. '
+            + 'Each template shows its Starter and Pro price in USD per 30 days and the monthly credit pool '
+            + 'that pays for the agent\'s chat and scheduled tasks (100 credits = 1 USD); model runs it starts, for '
+            + 'images, videos or voice calls, are billed to the wallet of the Wiro API key saved on the agent. '
+            + 'A template whose pricing is null '
+            + 'cannot be priced right now: do not quote or deploy it. Call get_agent_template next for the '
+            + 'skills, the credentials the user must provide and the exact prices. To build an agent from '
+            + 'individual skills instead, use list_agent_skills. get_playbook describes the whole flow from '
+            + 'choosing a template to a running agent.',
+        inputSchema: {
+            search: z.string().max(200).optional()
+                .describe('Words to look for in the title, description, slug and categories, for example "instagram". Results are sorted by relevance when set.'),
+            category: z.string().max(200).optional()
+                .describe('Category filter, for example "social-media". Separate several categories with commas.'),
+            sort: z.enum(['newest', 'popular', 'title']).default('newest')
+                .describe('Order when no search is given: newest first, most deployed first, or by title.'),
+            start: z.number().int().min(0).default(0)
+                .describe('Pagination offset (default 0).'),
+            limit: z.number().int().min(1).max(100).default(20)
+                .describe('Maximum templates to return (default 20, max 100).'),
+        },
+        outputSchema: {
+            templates: z.array(templateSummarySchema),
+            total: z.number().int().nonnegative(),
+            start: z.number().int().nonnegative(),
+            limit: z.number().int().positive(),
+            nextStart: z.number().int().nonnegative().nullable(),
+            nextAction: nextActionSchema.optional(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ search, category, sort, start, limit }, extra) => {
+        try {
+            const order = SORTS[sort];
+            const body = requireApiSuccess(await client.post('/Agent/List', {
+                ...(search?.trim() ? { search: search.trim() } : {}),
+                ...(category?.trim() ? { category: category.trim() } : {}),
+                sort: order.sort,
+                order: order.order,
+                start,
+                limit,
+            }, extra.signal), 'The agent catalog could not be read.');
+            const rows = Array.isArray(body.agents) ? body.agents.filter(isPlainObject) : [];
+            const templates = rows.map(toTemplateSummary).filter(template => template.guid && template.slug);
+            const total = Math.max(0, Math.trunc(toNumber(body.total) ?? templates.length));
+            const nextStart = start + rows.length < total ? start + rows.length : null;
+            const first = templates[0];
+            const range = rows.length > 0 ? `${start + 1}-${start + rows.length} of ${total}` : `none of ${total}`;
+            const lines = [`## Agent templates (${range})`, ''];
+            if (templates.length === 0)
+                lines.push('No templates matched.');
+            for (const template of templates) {
+                lines.push(`- **${template.title}** (\`${template.slug}\`): ${priceLine(template)}`);
+                if (template.summary)
+                    lines.push(`  ${template.summary}`);
+            }
+            if (nextStart !== null)
+                lines.push('', `More templates: call list_agent_templates with start ${nextStart}.`);
+            if (first)
+                lines.push('', `Next: get_agent_template with template "${first.slug}" shows its skills, required credentials and exact prices.`);
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+                structuredContent: {
+                    templates,
+                    total,
+                    start,
+                    limit,
+                    nextStart,
+                    ...(first
+                        ? {
+                            nextAction: {
+                                tool: 'get_agent_template',
+                                arguments: { template: first.slug },
+                                reason: 'Read the skills, required credentials and exact prices before deploying.',
+                            },
+                        }
+                        : {}),
+                },
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=list-agent-templates.js.map

package/dist/tools/list-agent-templates.js.map

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

package/dist/tools/list-my-agents.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { WiroClient } from '../client.js';
+export declare function registerListMyAgents(server: McpServer, client: WiroClient): void;
+//# sourceMappingURL=list-my-agents.d.ts.map

package/dist/tools/list-my-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-my-agents.d.ts","sourceRoot":"","sources":["../../src/tools/list-my-agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAoB/C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAwFhF"}

package/dist/tools/list-my-agents.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { errorResult, isPlainObject, requireApiSuccess } from '../utils/api.js';
+import { agentSummarySchema, describeAgentStatus, formatCredits, formatSubscriptionLine, toAgentSummary, } from '../utils/user-agent.js';
+import { isPlainTeamMember } from '../utils/workspace.js';
+import { nextActionSchema } from './schemas.js';
+const SORTS = {
+    newest: { sort: 'id', order: 'DESC' },
+    oldest: { sort: 'id', order: 'ASC' },
+    title: { sort: 'title', order: 'ASC' },
+    status: { sort: 'status', order: 'ASC' },
+    recently_updated: { sort: 'updatedat', order: 'DESC' },
+};
+export function registerListMyAgents(server, client) {
+    server.registerTool('list_my_agents', {
+        title: 'List my deployed Wiro agents',
+        description: 'List the agents deployed in the connected project\'s workspace (a team project '
+            + 'lists the team\'s agents, a personal project the personal ones). Each row shows the status, '
+            + 'whether setup is still required, the plan and the credit balance. Call get_my_agent with an '
+            + 'agent_guid for the full state, including which credentials are missing.',
+        inputSchema: {
+            sort: z.enum(['newest', 'oldest', 'title', 'status', 'recently_updated']).default('newest')
+                .describe('Order of the list (default newest first).'),
+            start: z.number().int().min(0).default(0)
+                .describe('Pagination offset (default 0).'),
+            limit: z.number().int().min(1).max(50).default(20)
+                .describe('Maximum agents to return (default 20, max 50).'),
+        },
+        outputSchema: {
+            agents: z.array(agentSummarySchema),
+            start: z.number().int().nonnegative(),
+            limit: z.number().int().positive(),
+            nextStart: z.number().int().nonnegative().nullable(),
+            nextAction: nextActionSchema.optional(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ sort, start, limit }, extra) => {
+        try {
+            const order = SORTS[sort];
+            const body = requireApiSuccess(await client.post('/UserAgent/MyAgents', {
+                sort: order.sort,
+                order: order.order,
+                start,
+                limit,
+            }, extra.signal), 'Your agents could not be listed.');
+            const rows = Array.isArray(body.useragents) ? body.useragents.filter(isPlainObject) : [];
+            const agents = rows.map(toAgentSummary).filter(agent => agent.guid);
+            // One page is read, so a full page means there may be more.
+            const nextStart = rows.length >= limit ? start + rows.length : null;
+            const first = agents[0];
+            // Every listed agent belongs to the connected project's workspace, so one lookup covers the page.
+            const plainMember = rows[0] ? await isPlainTeamMember(client, rows[0], extra.signal) : false;
+            const lines = [`## My agents (${agents.length})`, ''];
+            if (agents.length === 0) {
+                lines.push(start === 0
+                    ? 'No agents are deployed in this workspace. list_agent_templates shows what can be deployed.'
+                    : 'No more agents.');
+            }
+            for (const agent of agents) {
+                lines.push(`- **${agent.title}** (\`${agent.guid}\`): ${describeAgentStatus(agent.status)}${agent.setupRequired ? ', setup required' : ''}; `
+                    + `${agent.tier ?? 'no tier'}; ${formatCredits(agent.credits.remaining)} credits left; ${formatSubscriptionLine(agent.subscription, plainMember)}`);
+            }
+            if (nextStart !== null)
+                lines.push('', `More agents may exist: call list_my_agents with start ${nextStart}.`);
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+                structuredContent: {
+                    agents,
+                    start,
+                    limit,
+                    nextStart,
+                    ...(first
+                        ? {
+                            nextAction: {
+                                tool: 'get_my_agent',
+                                arguments: { agent_guid: first.guid },
+                                reason: 'Read the full state of an agent, including missing credentials.',
+                            },
+                        }
+                        : {}),
+                },
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=list-my-agents.js.map

package/dist/tools/list-my-agents.js.map

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

package/dist/tools/list-studio-results.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { WiroClient } from '../client.js';
+export declare function registerListStudioResults(server: McpServer, client: WiroClient): void;
+//# sourceMappingURL=list-studio-results.d.ts.map

package/dist/tools/list-studio-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-studio-results.d.ts","sourceRoot":"","sources":["../../src/tools/list-studio-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAiB/C,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA8ErF"}

package/dist/tools/list-studio-results.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+import { errorResult } from '../utils/api.js';
+import { formatStudioRun, readStudioRunPage, STUDIO_RUNS_MAX, studioRunSchema } from '../utils/studio-runs.js';
+import { nextActionSchema } from './schemas.js';
+function parseSince(value) {
+    if (value === undefined || value.trim() === '')
+        return undefined;
+    const text = value.trim();
+    let seconds = /^\d+(\.\d+)?$/.test(text) ? Number(text) : Date.parse(text) / 1000;
+    // A 13-digit number is a JavaScript timestamp in milliseconds.
+    if (seconds > 100_000_000_000)
+        seconds /= 1000;
+    if (!Number.isFinite(seconds)) {
+        throw new Error('since must be an ISO 8601 time such as 2026-01-31T09:00:00Z, or Unix seconds.');
+    }
+    return Math.floor(seconds);
+}
+export function registerListStudioResults(server, client) {
+    server.registerTool('list_studio_results', {
+        title: 'List Studio model runs',
+        description: 'List the model runs Studio started for this key\'s account (images, videos, audio, text), newest '
+            + 'first, with their status, output URLs, text answers and cost. It covers all of your Studio conversations in '
+            + 'this key\'s workspace; teammates\' runs are not included. Use it to collect outputs that finished after a turn '
+            + 'ended, or to check what is still running. Each run shows when it was created and, for a model that takes a '
+            + 'prompt, its prompt, so it can be matched to a request. These runs belong to Studio, so get_task, list_tasks, '
+            + 'cancel_task and kill_task cannot read or stop them; poll this tool instead. It reads at most Studio\'s 100 most '
+            + 'recent runs: to collect a period, pass since with limit 100, and the result says when older runs in that '
+            + 'period may be missing. Only successful runs are charged. Read-only.',
+        inputSchema: {
+            limit: z.number().int().min(1).max(100).default(20)
+                .describe('How many recent runs to read (1-100, default 20). Filters apply after reading, so fewer can come back.'),
+            state: z.enum(['all', 'running', 'completed', 'failed', 'cancelled']).default('all')
+                .describe('Only runs in this state (default all).'),
+            since: z.string().optional()
+                .describe('Only runs created at or after this time: ISO 8601 (2026-01-31T09:00:00Z) or Unix seconds.'),
+        },
+        outputSchema: {
+            runs: z.array(studioRunSchema),
+            count: z.number().int().nonnegative(),
+            running: z.number().int().nonnegative(),
+            mayMissOlder: z.boolean().optional(),
+            nextAction: nextActionSchema.optional(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ limit, state, since }, extra) => {
+        try {
+            const from = parseSince(since);
+            // Studio returns only its most recent runs, so a full page whose oldest
+            // run is newer than since can leave out older runs of that period.
+            const page = await readStudioRunPage(client, limit, from === undefined ? {} : { from }, extra.signal);
+            const runs = page.runs.filter(run => state === 'all' || run.state === state);
+            const running = runs.filter(run => run.state === 'running').length;
+            const lines = ['## Studio model runs', ''];
+            if (runs.length === 0)
+                lines.push('No runs matched.');
+            for (const run of runs)
+                lines.push(formatStudioRun(run));
+            if (running > 0)
+                lines.push('', `${running} run(s) still running. Check again in a little while.`);
+            if (page.mayMissOlder) {
+                lines.push('', limit < STUDIO_RUNS_MAX
+                    ? `Call again with limit ${STUDIO_RUNS_MAX} to see more of that period.`
+                    : `Studio returns its ${STUDIO_RUNS_MAX} most recent model runs, and the oldest of them is newer than since, `
+                        + 'so earlier runs from that period are not in this list.');
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+                structuredContent: {
+                    runs,
+                    count: runs.length,
+                    running,
+                    ...(page.mayMissOlder ? { mayMissOlder: true } : {}),
+                    ...(running > 0
+                        ? {
+                            nextAction: {
+                                tool: 'list_studio_results',
+                                arguments: { limit, ...(since ? { since } : {}) },
+                                reason: 'Some runs are still running; call again in a little while to see their outputs.',
+                            },
+                        }
+                        : {}),
+                },
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=list-studio-results.js.map

package/dist/tools/list-studio-results.js.map

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

package/dist/tools/list-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/list-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAgG7E"}
+{"version":3,"file":"list-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/list-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAkG7E"}