@vibe-agent-toolkit/vat-example-cat-agents 0.1.2-rc.4

package/dist/external-event-integrator/human-approval.js

@@ -0,0 +1,387 @@
+import * as readline from 'node:readline';
+import { executeExternalEvent, validateAgentInput } from '@vibe-agent-toolkit/agent-runtime';
+import { z } from 'zod';
+/**
+ * Constants for duplicated strings
+ * @internal
+ */
+const EVENT_INVALID_RESPONSE = 'event-invalid-response';
+const AUTO_APPROVED_MESSAGE = 'Auto-approved (test mode)';
+const AUTO_REJECTED_MESSAGE = 'Auto-rejected (test mode)';
+const AUTO_SELECTED_MESSAGE = 'Auto-selected (test mode)';
+const APPROVAL_REQUEST_CONTEXT = 'Approval request';
+const CHOICE_REQUEST_CONTEXT = 'Choice request';
+const CUSTOM_APPROVAL_REQUEST_CONTEXT = 'Custom approval request';
+const EXTERNAL_EVENT_INTEGRATOR_ARCHETYPE = 'external-event-integrator';
+const TIMEOUT_MS_DESCRIPTION = 'Timeout in milliseconds';
+/**
+ * Input schema for approval requests
+ */
+export const ApprovalRequestInputSchema = z.object({
+    prompt: z.string().describe('The question to ask the human'),
+    context: z.record(z.unknown()).optional().describe('Additional context to display'),
+    autoResponse: z.union([z.literal('approve'), z.literal('reject')]).optional().describe('Auto-response for testing'),
+    timeoutMs: z.number().optional().describe(TIMEOUT_MS_DESCRIPTION),
+});
+/**
+ * Output schema for approval results
+ */
+export const ApprovalResultSchema = z.object({
+    approved: z.boolean().describe('Whether the request was approved'),
+    reason: z.string().optional().describe('Reason for the decision'),
+    timedOut: z.boolean().optional().describe('Whether the request timed out'),
+});
+/**
+ * Input schema for choice requests
+ */
+export const ChoiceRequestInputSchema = z.object({
+    prompt: z.string().describe('The question to ask'),
+    options: z.array(z.string()).describe('Array of options to choose from'),
+    autoResponse: z.string().optional().describe('Auto-response for testing (option value)'),
+    timeoutMs: z.number().optional().describe(TIMEOUT_MS_DESCRIPTION),
+});
+/**
+ * Output schema for choice results
+ */
+export const ChoiceResultSchema = z.object({
+    approved: z.boolean().describe('Whether a choice was made'),
+    choice: z.string().optional().describe('The selected option'),
+    reason: z.string().describe('Reason for result'),
+});
+/**
+ * Input schema for custom approval requests
+ */
+export const CustomApprovalRequestInputSchema = z.object({
+    prompt: z.string().describe('The question to ask'),
+    autoResponse: z.string().optional().describe('Auto-response for testing'),
+    timeoutMs: z.number().optional().describe(TIMEOUT_MS_DESCRIPTION),
+});
+/**
+ * Output schema for custom approval results
+ */
+export const CustomApprovalResultSchema = z.object({
+    approved: z.boolean().describe('Whether the input was valid'),
+    value: z.unknown().optional().describe('The validated value'),
+    reason: z.string().describe('Reason for result'),
+});
+/**
+ * Requests human approval for a decision.
+ *
+ * Archetype: External Event Integrator
+ *
+ * This agent integrates with an external system (human input via CLI).
+ * In production, this could be:
+ * - A web UI approval workflow
+ * - A Slack approval bot
+ * - An email-based approval system
+ * - A ticketing system integration
+ *
+ * For now, it prompts via CLI.
+ *
+ * @param prompt - The question to ask the human
+ * @param context - Additional context to display (optional)
+ * @param options - Configuration options
+ * @returns Approval result
+ */
+export async function requestApproval(prompt, context, options = {}) {
+    const { timeoutMs = 0, onTimeout = 'reject', autoResponse } = options;
+    // Auto-response for testing
+    if (autoResponse) {
+        return {
+            approved: autoResponse === 'approve',
+            reason: autoResponse === 'approve' ? AUTO_APPROVED_MESSAGE : AUTO_REJECTED_MESSAGE,
+        };
+    }
+    // Display context if provided
+    if (context) {
+        console.log('\n=== Approval Request Context ===');
+        for (const [key, value] of Object.entries(context)) {
+            console.log(`${key}: ${JSON.stringify(value, null, 2)}`);
+        }
+        console.log('================================\n');
+    }
+    // Create readline interface
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    // Wrap in promise with optional timeout
+    const result = await new Promise((resolve) => {
+        let timeoutHandle;
+        // Set up timeout if specified
+        if (timeoutMs > 0) {
+            timeoutHandle = setTimeout(() => {
+                rl.close();
+                resolve({
+                    approved: onTimeout === 'approve',
+                    reason: `Timed out after ${timeoutMs}ms`,
+                    timedOut: true,
+                });
+            }, timeoutMs);
+        }
+        // Ask the question
+        rl.question(`${prompt} (yes/no): `, (answer) => {
+            if (timeoutHandle) {
+                clearTimeout(timeoutHandle);
+            }
+            rl.close();
+            const normalized = answer.trim().toLowerCase();
+            const approved = normalized === 'yes' || normalized === 'y';
+            resolve({
+                approved,
+                reason: approved ? 'Approved by user' : 'Rejected by user',
+            });
+        });
+    });
+    return result;
+}
+/**
+ * Requests approval with custom validation logic.
+ *
+ * This variant allows for more complex approval flows where the human
+ * can provide additional input beyond just yes/no.
+ *
+ * @param prompt - The question to ask
+ * @param validator - Function to validate the response
+ * @param options - Configuration options
+ * @returns Validation result
+ */
+export async function requestCustomApproval(prompt, validator, options = {}) {
+    const { timeoutMs = 0, autoResponse } = options;
+    // Auto-response for testing
+    if (autoResponse) {
+        const validation = validator(autoResponse);
+        return {
+            approved: validation.valid,
+            ...(validation.value !== undefined && { value: validation.value }),
+            reason: validation.valid ? AUTO_APPROVED_MESSAGE : validation.error ?? AUTO_REJECTED_MESSAGE,
+        };
+    }
+    // Create readline interface
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const result = await new Promise((resolve) => {
+        let timeoutHandle;
+        if (timeoutMs > 0) {
+            timeoutHandle = setTimeout(() => {
+                rl.close();
+                resolve({
+                    approved: false,
+                    reason: `Timed out after ${timeoutMs}ms`,
+                });
+            }, timeoutMs);
+        }
+        rl.question(`${prompt}: `, (answer) => {
+            if (timeoutHandle) {
+                clearTimeout(timeoutHandle);
+            }
+            rl.close();
+            const validation = validator(answer.trim());
+            resolve({
+                approved: validation.valid,
+                ...(validation.value !== undefined && { value: validation.value }),
+                reason: validation.valid
+                    ? 'Approved by user'
+                    : validation.error ?? 'Invalid response',
+            });
+        });
+    });
+    return result;
+}
+/**
+ * Presents multiple options and asks human to choose one.
+ *
+ * @param prompt - The question to ask
+ * @param options - Array of options to choose from
+ * @param config - Configuration options
+ * @returns Selected option (or undefined if rejected/timed out)
+ */
+export async function requestChoice(prompt, options, config = {}) {
+    const { timeoutMs = 0, autoResponse } = config;
+    // Auto-response for testing
+    if (autoResponse) {
+        // Check for exact match first (case-sensitive)
+        if (options.includes(autoResponse)) {
+            return {
+                approved: true,
+                choice: autoResponse,
+                reason: AUTO_SELECTED_MESSAGE,
+            };
+        }
+        // Try case-insensitive match
+        const match = options.find((opt) => opt.toLowerCase() === autoResponse.toLowerCase());
+        if (match) {
+            return {
+                approved: true,
+                choice: match,
+                reason: AUTO_SELECTED_MESSAGE,
+            };
+        }
+        // No match found
+        return {
+            approved: false,
+            reason: `Invalid auto-response: ${autoResponse}`,
+        };
+    }
+    // Display options
+    console.log(`\n${prompt}`);
+    for (const [index, option] of options.entries()) {
+        console.log(`  ${index + 1}. ${option}`);
+    }
+    return requestCustomApproval('Enter your choice (number or text)', (response) => {
+        // Try to parse as number
+        const num = Number.parseInt(response, 10);
+        if (!Number.isNaN(num) && num >= 1 && num <= options.length) {
+            const option = options[num - 1];
+            if (option !== undefined) {
+                return { valid: true, value: option };
+            }
+        }
+        // Try to match text
+        const match = options.find((opt) => opt.toLowerCase() === response.toLowerCase());
+        if (match !== undefined) {
+            return { valid: true, value: match };
+        }
+        return {
+            valid: false,
+            error: 'Invalid choice. Please enter a number or option text.',
+        };
+    }, { timeoutMs });
+}
+/**
+ * Request approval agent
+ *
+ * Integrates with external human approval system (CLI in this implementation).
+ * In production, this could integrate with Slack, email, web UI, or ticketing systems.
+ */
+export const requestApprovalAgent = {
+    name: 'request-approval',
+    manifest: {
+        name: 'request-approval',
+        version: '1.0.0',
+        description: 'Requests human approval for a yes/no decision',
+        archetype: EXTERNAL_EVENT_INTEGRATOR_ARCHETYPE,
+        metadata: {
+            integrationTypes: ['CLI', 'Slack', 'Email', 'Web UI'],
+            blocking: true,
+            timeoutMs: 60000,
+        },
+    },
+    execute: async (input) => {
+        const validatedOrError = validateAgentInput(input, ApprovalRequestInputSchema, EVENT_INVALID_RESPONSE);
+        if ('result' in validatedOrError) {
+            return validatedOrError;
+        }
+        const { prompt, context, autoResponse, timeoutMs = 60000 } = validatedOrError;
+        // Convert autoResponse to ApprovalResult for executeExternalEvent
+        const autoResponseData = autoResponse
+            ? {
+                approved: autoResponse === 'approve',
+                reason: autoResponse === 'approve' ? AUTO_APPROVED_MESSAGE : AUTO_REJECTED_MESSAGE,
+            }
+            : {}; // Placeholder, will be handled by executeExternalEvent
+        return executeExternalEvent({
+            ...(autoResponse && { autoResponse: autoResponseData }),
+            handler: async () => requestApproval(prompt, context, autoResponse ? { autoResponse } : { timeoutMs }),
+            timeoutMs,
+            errorContext: APPROVAL_REQUEST_CONTEXT,
+        });
+    },
+};
+/**
+ * Request choice agent
+ *
+ * Presents multiple options and asks human to choose one.
+ */
+export const requestChoiceAgent = {
+    name: 'request-choice',
+    manifest: {
+        name: 'request-choice',
+        version: '1.0.0',
+        description: 'Presents multiple options and asks human to choose one',
+        archetype: EXTERNAL_EVENT_INTEGRATOR_ARCHETYPE,
+        metadata: {
+            integrationTypes: ['CLI', 'Slack', 'Email', 'Web UI'],
+            blocking: true,
+            timeoutMs: 60000,
+        },
+    },
+    execute: async (input) => {
+        const validatedOrError = validateAgentInput(input, ChoiceRequestInputSchema, EVENT_INVALID_RESPONSE);
+        if ('result' in validatedOrError) {
+            return validatedOrError;
+        }
+        const { prompt, options, autoResponse, timeoutMs = 60000 } = validatedOrError;
+        // Convert autoResponse to ChoiceResult for executeExternalEvent
+        const autoResponseData = autoResponse
+            ? {
+                approved: options.includes(autoResponse),
+                choice: autoResponse,
+                reason: options.includes(autoResponse)
+                    ? AUTO_SELECTED_MESSAGE
+                    : `Invalid auto-response: ${autoResponse}`,
+            }
+            : {}; // Placeholder, will be handled by executeExternalEvent
+        return executeExternalEvent({
+            ...(autoResponse && { autoResponse: autoResponseData }),
+            handler: async () => requestChoice(prompt, options, autoResponse ? { autoResponse } : { timeoutMs }),
+            timeoutMs,
+            errorContext: CHOICE_REQUEST_CONTEXT,
+        });
+    },
+};
+/**
+ * Request custom approval agent
+ *
+ * Requests approval with custom validation logic.
+ * Note: This is a simplified version - full implementation would need validator function.
+ */
+export const requestCustomApprovalAgent = {
+    name: 'request-custom-approval',
+    manifest: {
+        name: 'request-custom-approval',
+        version: '1.0.0',
+        description: 'Requests approval with custom validation logic',
+        archetype: EXTERNAL_EVENT_INTEGRATOR_ARCHETYPE,
+        metadata: {
+            integrationTypes: ['CLI', 'Slack', 'Email', 'Web UI'],
+            blocking: true,
+            requiresValidator: true,
+            timeoutMs: 60000,
+        },
+    },
+    execute: async (input) => {
+        const validatedOrError = validateAgentInput(input, CustomApprovalRequestInputSchema, EVENT_INVALID_RESPONSE);
+        if ('result' in validatedOrError) {
+            return validatedOrError;
+        }
+        const { prompt, autoResponse, timeoutMs = 60000 } = validatedOrError;
+        // Simplified implementation - just do yes/no approval
+        // Full implementation would need validator function passed through context
+        const autoResponseData = autoResponse
+            ? {
+                approved: autoResponse.toLowerCase() === 'yes' || autoResponse.toLowerCase() === 'y',
+                value: autoResponse,
+                reason: autoResponse.toLowerCase() === 'yes' || autoResponse.toLowerCase() === 'y'
+                    ? AUTO_APPROVED_MESSAGE
+                    : AUTO_REJECTED_MESSAGE,
+            }
+            : {}; // Placeholder
+        return executeExternalEvent({
+            ...(autoResponse && { autoResponse: autoResponseData }),
+            handler: async () => {
+                const result = await requestApproval(prompt, undefined, autoResponse ? { autoResponse: autoResponse } : { timeoutMs });
+                return {
+                    approved: result.approved,
+                    reason: result.reason ?? 'No reason provided',
+                    value: result.approved ? 'approved' : undefined,
+                };
+            },
+            timeoutMs,
+            errorContext: CUSTOM_APPROVAL_REQUEST_CONTEXT,
+        });
+    },
+};
+//# sourceMappingURL=human-approval.js.map

package/dist/external-event-integrator/human-approval.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types/schemas.js';
+export * from './pure-function-tool/haiku-validator.js';
+export * from './pure-function-tool/name-validator.js';
+export * from './one-shot-llm-analyzer/photo-analyzer.js';
+export * from './one-shot-llm-analyzer/description-parser.js';
+export * from './one-shot-llm-analyzer/name-generator.js';
+export * from './one-shot-llm-analyzer/haiku-generator.js';
+export * from './conversational-assistant/breed-advisor.js';
+export * from './conversational-assistant/breed-knowledge.js';
+export * from './external-event-integrator/human-approval.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AAGnC,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AAGvD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAG3D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC;AAG9D,cAAc,+CAA+C,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+// Schemas and types
+export * from './types/schemas.js';
+// Pure Function Tools (Archetype 1)
+export * from './pure-function-tool/haiku-validator.js';
+export * from './pure-function-tool/name-validator.js';
+// One-Shot LLM Analyzers (Archetype 2)
+export * from './one-shot-llm-analyzer/photo-analyzer.js';
+export * from './one-shot-llm-analyzer/description-parser.js';
+export * from './one-shot-llm-analyzer/name-generator.js';
+export * from './one-shot-llm-analyzer/haiku-generator.js';
+// Conversational Assistants (Archetype 3)
+export * from './conversational-assistant/breed-advisor.js';
+export * from './conversational-assistant/breed-knowledge.js';
+// External Event Integrators (Archetype 9)
+export * from './external-event-integrator/human-approval.js';
+// Function Workflow Orchestrators (Archetype 5)
+// NOTE: Orchestrator examples were removed during AI SDK v6 migration due to mock code cleanup.
+// Future: Add orchestrator example that works with real LLM agents.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,oCAAoC;AACpC,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AAEvD,uCAAuC;AACvC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAE3D,0CAA0C;AAC1C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC;AAE9D,2CAA2C;AAC3C,cAAc,+CAA+C,CAAC;AAE9D,gDAAgD;AAChD,gGAAgG;AAChG,oEAAoE"}

package/dist/mcp-collections.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MCP Collections for vat-example-cat-agents
+ *
+ * Exports agent collections that can be exposed via MCP Gateway.
+ * Discoverable by: vat mcp serve @vibe-agent-toolkit/vat-example-cat-agents
+ */
+import type { Agent, OneShotAgentOutput } from '@vibe-agent-toolkit/agent-schema';
+export interface MCPAgentRegistration {
+    name: string;
+    agent: Agent<unknown, OneShotAgentOutput<unknown, string>>;
+    description: string;
+}
+export interface MCPCollection {
+    name: string;
+    description: string;
+    agents: MCPAgentRegistration[];
+}
+/**
+ * Cat agents collection
+ */
+export declare const catAgents: MCPCollection;
+/**
+ * All MCP collections exported by this package
+ */
+export declare const collections: Record<string, MCPCollection>;
+/**
+ * Default collection (when package is used without :collection suffix)
+ */
+export declare const defaultCollection: MCPCollection;
+//# sourceMappingURL=mcp-collections.d.ts.map

package/dist/mcp-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-collections.d.ts","sourceRoot":"","sources":["../src/mcp-collections.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAMlF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAwBD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,aAevB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAErD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAAY,CAAC"}

package/dist/mcp-collections.js

@@ -0,0 +1,58 @@
+/**
+ * MCP Collections for vat-example-cat-agents
+ *
+ * Exports agent collections that can be exposed via MCP Gateway.
+ * Discoverable by: vat mcp serve @vibe-agent-toolkit/vat-example-cat-agents
+ */
+import { createSuccess } from '@vibe-agent-toolkit/agent-schema';
+import { photoAnalyzerAgent } from './one-shot-llm-analyzer/photo-analyzer.js';
+import { haikuValidatorAgent } from './pure-function-tool/haiku-validator.js';
+/**
+ * Wraps stateless agents to return OneShotAgentOutput envelope
+ *
+ * Gateway expects: { result: AgentResult<TData, TError>, metadata?: ... }
+ * Stateless agents return: TData directly
+ */
+function wrapStatelessAgent(agent) {
+    return {
+        name: agent.name,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Accept any manifest structure from different agent types
+        manifest: agent.manifest,
+        execute: async (input) => {
+            const data = await Promise.resolve(agent.execute(input));
+            return {
+                result: createSuccess(data),
+            };
+        },
+    };
+}
+/**
+ * Cat agents collection
+ */
+export const catAgents = {
+    name: 'cat-agents',
+    description: 'Example cat breeding agents (haiku validator, photo analyzer)',
+    agents: [
+        {
+            name: 'haiku-validator',
+            agent: wrapStatelessAgent(haikuValidatorAgent),
+            description: 'Validates 5-7-5 haiku syllable structure',
+        },
+        {
+            name: 'photo-analyzer',
+            agent: wrapStatelessAgent(photoAnalyzerAgent),
+            description: 'Analyzes cat photos (mock mode)',
+        },
+    ],
+};
+/**
+ * All MCP collections exported by this package
+ */
+export const collections = {
+    'cat-agents': catAgents,
+};
+/**
+ * Default collection (when package is used without :collection suffix)
+ */
+export const defaultCollection = catAgents;
+//# sourceMappingURL=mcp-collections.js.map

package/dist/mcp-collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-collections.js","sourceRoot":"","sources":["../src/mcp-collections.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAc9E;;;;;GAKG;AACH,SAAS,kBAAkB,CACzB,KAAkG;IAElG,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,0HAA0H;QAC1H,QAAQ,EAAE,KAAK,CAAC,QAAe;QAC/B,OAAO,EAAE,KAAK,EAAE,KAAa,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACzD,OAAO;gBACL,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC;aAC5B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,+DAA+D;IAC5E,MAAM,EAAE;QACN;YACE,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC;YAC9C,WAAW,EAAE,0CAA0C;SACxD;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,kBAAkB,CAAC,kBAAkB,CAAC;YAC7C,WAAW,EAAE,iCAAiC;SAC/C;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkC;IACxD,YAAY,EAAE,SAAS;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC"}

package/dist/one-shot-llm-analyzer/description-parser.d.ts

@@ -0,0 +1,55 @@
+import type { Agent, LLMError, OneShotAgentOutput } from '@vibe-agent-toolkit/agent-schema';
+import { z } from 'zod';
+import { type CatCharacteristics } from '../types/schemas.js';
+/**
+ * Input schema for description parsing
+ */
+export declare const DescriptionParserInputSchema: z.ZodObject<{
+    description: z.ZodString;
+    mockable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    mockable?: boolean | undefined;
+}, {
+    description: string;
+    mockable?: boolean | undefined;
+}>;
+export type DescriptionParserInput = z.infer<typeof DescriptionParserInputSchema>;
+/**
+ * Configuration for description parser behavior
+ */
+export interface DescriptionParserOptions {
+    /**
+     * Whether to use real LLM or mock data
+     * @default true (mock mode for now)
+     */
+    mockable?: boolean;
+}
+/**
+ * Parses a text description of a cat and extracts characteristics.
+ *
+ * Archetype: One-Shot LLM Analyzer
+ *
+ * This would typically call an LLM to parse unstructured text.
+ * For now, it generates mock data based on keyword extraction.
+ *
+ * Handles both structured descriptions and "word vomit":
+ * - "Orange tabby, playful, loves boxes"
+ * - "So there's this cat right and he's like super orange and has stripes and he knocks stuff off tables"
+ *
+ * @param description - Text description of the cat (structured or unstructured)
+ * @param options - Configuration options
+ * @returns Cat characteristics extracted from the description
+ */
+export declare function parseDescription(description: string, options?: DescriptionParserOptions): Promise<CatCharacteristics>;
+/**
+ * Description parser agent
+ *
+ * Captain Obvious is a cat who states the obvious and extracts characteristics literally.
+ * He has an uncanny ability to parse both structured descriptions and complete "word vomit",
+ * extracting every detail with earnest precision.
+ *
+ * In mock mode, uses keyword extraction. In real mode, uses LLM to parse natural language.
+ */
+export declare const descriptionParserAgent: Agent<DescriptionParserInput, OneShotAgentOutput<CatCharacteristics, LLMError>>;
+//# sourceMappingURL=description-parser.d.ts.map

package/dist/one-shot-llm-analyzer/description-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-parser.d.ts","sourceRoot":"","sources":["../../src/one-shot-llm-analyzer/description-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE5F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIxF;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;EAGvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,kBAAkB,CAAC,CAQ7B;AA6SD;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CACxC,sBAAsB,EACtB,kBAAkB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAuCjD,CAAC"}