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

package/dist/conversational-assistant/breed-knowledge.js

@@ -0,0 +1,335 @@
+/**
+ * Cat breed knowledge database for the breed advisor agent.
+ * Contains comprehensive breed profiles with traits aligned to music preferences.
+ */
+// Constants for duplicated strings
+const ACTIVITY_COUCH_COMPANION = 'couch-companion';
+const ACTIVITY_PLAYFUL_MODERATE = 'playful-moderate';
+const ACTIVITY_ACTIVE_EXPLORER = 'active-explorer';
+const ACTIVITY_HIGH_ENERGY = 'high-energy-athlete';
+export const BREED_DATABASE = [
+    {
+        name: 'Persian',
+        traits: {
+            activityLevel: [ACTIVITY_COUCH_COMPANION],
+            groomingNeeds: 'daily',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['classical'],
+            temperament: 'Calm, gentle, and affectionate. Enjoys quiet environments and a predictable routine.',
+            size: 'medium',
+        },
+        description: 'Known for their luxurious long coat and sweet personality. Persians are the ultimate lap cats, preferring a serene environment with classical music. They require daily grooming but reward their owners with unwavering loyalty and gentle companionship.',
+    },
+    {
+        name: 'Ragdoll',
+        traits: {
+            activityLevel: [ACTIVITY_COUCH_COMPANION, ACTIVITY_PLAYFUL_MODERATE],
+            groomingNeeds: 'weekly',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['classical', 'pop'],
+            temperament: 'Docile, relaxed, and people-oriented. Known for going limp when picked up.',
+            size: 'large',
+        },
+        description: 'Famous for their tendency to go limp when held, Ragdolls are large, gentle cats with striking blue eyes. They enjoy both relaxing classical melodies and upbeat pop tunes. Perfect for families, they are patient with children and get along well with other pets.',
+    },
+    {
+        name: 'Siamese',
+        traits: {
+            activityLevel: [ACTIVITY_PLAYFUL_MODERATE, ACTIVITY_ACTIVE_EXPLORER],
+            groomingNeeds: 'minimal',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['jazz'],
+            temperament: 'Vocal, intelligent, and social. Forms strong bonds with owners.',
+            size: 'medium',
+        },
+        description: 'One of the most recognizable breeds with distinctive color points and blue eyes. Siamese cats are highly intelligent, vocal, and thrive on interaction. They resonate with jazz music, appreciating its complexity and improvisational nature. Very social and demand attention.',
+    },
+    {
+        name: 'Bengal',
+        traits: {
+            activityLevel: [ACTIVITY_ACTIVE_EXPLORER, ACTIVITY_HIGH_ENERGY],
+            groomingNeeds: 'minimal',
+            suitableForApartment: false,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['jazz', 'rock'],
+            temperament: 'Energetic, playful, and curious. Loves water and climbing.',
+            size: 'medium',
+        },
+        description: 'With their wild leopard-like appearance, Bengals are extremely active and athletic. They need plenty of space and stimulation. Their high energy matches well with jazz and rock music. Known for their love of water and climbing, they require interactive play and mental challenges.',
+    },
+    {
+        name: 'Maine Coon',
+        traits: {
+            activityLevel: [ACTIVITY_PLAYFUL_MODERATE, ACTIVITY_ACTIVE_EXPLORER],
+            groomingNeeds: 'weekly',
+            suitableForApartment: false,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['rock', 'country'],
+            temperament: 'Gentle giant, friendly, and adaptable. Often called "dogs of the cat world".',
+            size: 'large',
+        },
+        description: 'One of the largest domestic cat breeds, Maine Coons are known for their dog-like personalities. They are friendly, sociable, and great with families. Their rugged nature aligns with rock and country music. Despite their size, they are gentle and adapt well to various living situations.',
+    },
+    {
+        name: 'Abyssinian',
+        traits: {
+            activityLevel: [ACTIVITY_ACTIVE_EXPLORER, ACTIVITY_HIGH_ENERGY],
+            groomingNeeds: 'minimal',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['metal', 'rock'],
+            temperament: 'Extremely active, curious, and playful. Always on the move.',
+            size: 'medium',
+        },
+        description: 'Ancient breed with a wild appearance and boundless energy. Abyssinians are constantly in motion, exploring every corner of their environment. Their intense energy matches metal and rock music. They are intelligent, social, and require lots of interactive play and stimulation.',
+    },
+    {
+        name: 'Sphynx',
+        traits: {
+            activityLevel: [ACTIVITY_PLAYFUL_MODERATE, ACTIVITY_ACTIVE_EXPLORER],
+            groomingNeeds: 'weekly',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: true,
+            musicAlignment: ['electronic'],
+            temperament: 'Extroverted, energetic, and affectionate. Loves attention and warmth.',
+            size: 'medium',
+        },
+        description: 'Hairless and striking, Sphynx cats have a unique appearance that matches their quirky personalities. They are warm to the touch and love human contact. Their modern, unconventional nature aligns with electronic music. Hypoallergenic and perfect for those with cat allergies.',
+    },
+    {
+        name: 'Devon Rex',
+        traits: {
+            activityLevel: [ACTIVITY_PLAYFUL_MODERATE, ACTIVITY_ACTIVE_EXPLORER],
+            groomingNeeds: 'minimal',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['electronic', 'pop'],
+            temperament: 'Mischievous, playful, and people-oriented. Often called "monkeys in cat suits".',
+            size: 'small',
+        },
+        description: 'With their large ears, curly coat, and impish personality, Devon Rex cats are highly entertaining. They are acrobatic, playful, and love being the center of attention. Their quirky nature resonates with electronic and pop music. Very social and bond closely with their families.',
+    },
+    {
+        name: 'Russian Blue',
+        traits: {
+            activityLevel: [ACTIVITY_COUCH_COMPANION, ACTIVITY_PLAYFUL_MODERATE],
+            groomingNeeds: 'minimal',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: true,
+            musicAlignment: ['none', 'classical'],
+            temperament: 'Reserved, intelligent, and loyal. Can be shy with strangers.',
+            size: 'medium',
+        },
+        description: 'Known for their shimmering blue-gray coat and green eyes, Russian Blues are elegant and reserved. They prefer quiet environments and may not appreciate music at all, though they can tolerate classical. Hypoallergenic and perfect for those seeking a calm, loyal companion.',
+    },
+    {
+        name: 'Domestic Shorthair',
+        traits: {
+            activityLevel: [ACTIVITY_COUCH_COMPANION, ACTIVITY_PLAYFUL_MODERATE, ACTIVITY_ACTIVE_EXPLORER],
+            groomingNeeds: 'minimal',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['pop', 'country'],
+            temperament: 'Varied - each cat is unique. Generally adaptable and friendly.',
+            size: 'medium',
+        },
+        description: 'The most common cat in North America, Domestic Shorthairs are mixed breed cats with diverse personalities. They adapt well to various lifestyles and music preferences, though pop and country are common favorites. Each cat is unique, making them unpredictable but wonderful companions.',
+    },
+    {
+        name: 'American Shorthair',
+        traits: {
+            activityLevel: [ACTIVITY_PLAYFUL_MODERATE],
+            groomingNeeds: 'minimal',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['country', 'pop'],
+            temperament: 'Easygoing, affectionate, and adaptable. Great family cats.',
+            size: 'medium',
+        },
+        description: 'A true American breed, these cats are known for their robust health and easygoing nature. They are playful without being hyperactive and enjoy country and pop music. Excellent with children and other pets, they make ideal family companions.',
+    },
+    {
+        name: 'Scottish Fold',
+        traits: {
+            activityLevel: [ACTIVITY_COUCH_COMPANION, ACTIVITY_PLAYFUL_MODERATE],
+            groomingNeeds: 'weekly',
+            suitableForApartment: true,
+            goodWithKids: true,
+            goodWithPets: true,
+            hypoallergenic: false,
+            musicAlignment: ['classical', 'jazz'],
+            temperament: 'Sweet-tempered, calm, and adaptable. Enjoys human company.',
+            size: 'medium',
+        },
+        description: 'Recognized by their distinctive folded ears, Scottish Folds are gentle, sweet-natured cats. They enjoy both calm classical music and sophisticated jazz. They adapt well to different living situations and get along with everyone. Known for sitting in unusual positions.',
+    },
+];
+/**
+ * Score music preference alignment
+ */
+function scoreMusicPreference(profile, breed) {
+    if (profile.musicPreference && breed.traits.musicAlignment.includes(profile.musicPreference)) {
+        return {
+            score: 30,
+            reason: `music preference (${profile.musicPreference}) aligns perfectly`,
+        };
+    }
+    return { score: 0 };
+}
+/**
+ * Score activity level match
+ */
+function scoreActivityLevel(profile, breed) {
+    if (profile.activityLevel && breed.traits.activityLevel.includes(profile.activityLevel)) {
+        return {
+            score: 20,
+            reason: `activity level (${profile.activityLevel}) matches well`,
+        };
+    }
+    return { score: 0 };
+}
+/**
+ * Score living space compatibility
+ */
+function scoreLivingSpace(profile, breed) {
+    if (!profile.livingSpace) {
+        return { score: 0 };
+    }
+    if (profile.livingSpace === 'apartment' && breed.traits.suitableForApartment) {
+        return { score: 15, reason: 'suitable for apartment living' };
+    }
+    if (profile.livingSpace === 'apartment' && !breed.traits.suitableForApartment) {
+        return { score: -20, reason: 'not ideal for apartments (penalty)' };
+    }
+    // Any breed works for houses/farms
+    return { score: 10, reason: 'plenty of space available' };
+}
+/**
+ * Score grooming compatibility
+ */
+function scoreGrooming(profile, breed) {
+    if (!profile.groomingTolerance) {
+        return { score: 0 };
+    }
+    if (profile.groomingTolerance === breed.traits.groomingNeeds) {
+        return {
+            score: 15,
+            reason: `grooming needs (${breed.traits.groomingNeeds}) match tolerance`,
+        };
+    }
+    // Check if grooming tolerance is higher than needs (okay)
+    const toleranceLevels = { minimal: 0, weekly: 1, daily: 2 };
+    const needsLevels = { minimal: 0, weekly: 1, daily: 2 };
+    if (toleranceLevels[profile.groomingTolerance] >= needsLevels[breed.traits.groomingNeeds]) {
+        return { score: 8, reason: 'grooming needs are manageable' };
+    }
+    return { score: -10, reason: 'grooming needs exceed tolerance (penalty)' };
+}
+/**
+ * Score family composition compatibility
+ */
+function scoreFamilyComposition(profile, breed) {
+    if (!profile.familyComposition) {
+        return { score: 0 };
+    }
+    if (profile.familyComposition === 'young-kids' && breed.traits.goodWithKids) {
+        return { score: 10, reason: 'great with young children' };
+    }
+    if (profile.familyComposition === 'older-kids' && breed.traits.goodWithKids) {
+        return { score: 10, reason: 'good with older children' };
+    }
+    if (profile.familyComposition === 'multi-pet' && breed.traits.goodWithPets) {
+        return { score: 10, reason: 'gets along well with other pets' };
+    }
+    if (profile.familyComposition === 'single' || profile.familyComposition === 'couple') {
+        return { score: 5, reason: 'suitable for adult household' };
+    }
+    return { score: 0 };
+}
+/**
+ * Match breeds to a selection profile using scoring algorithm
+ *
+ * Scoring:
+ * - Music preference: 30 points (CRITICAL factor, 2x weight)
+ * - Activity level: 20 points
+ * - Living space: 15 points
+ * - Grooming tolerance: 15 points
+ * - Family composition: 10 points
+ * - Penalties: -10 to -20 per mismatch
+ *
+ * Hard filters:
+ * - allergies=true → only hypoallergenic
+ * - young-kids → only goodWithKids
+ */
+export function matchBreeds(profile) {
+    // Return empty if no factors to match
+    const factorCount = [
+        profile.musicPreference,
+        profile.activityLevel,
+        profile.livingSpace,
+        profile.groomingTolerance,
+        profile.familyComposition,
+        profile.allergies === undefined ? undefined : 'allergies',
+    ].filter(Boolean).length;
+    if (factorCount === 0) {
+        return [];
+    }
+    // Apply hard filters
+    let candidates = BREED_DATABASE;
+    if (profile.allergies === true) {
+        candidates = candidates.filter((breed) => breed.traits.hypoallergenic);
+    }
+    if (profile.familyComposition === 'young-kids') {
+        candidates = candidates.filter((breed) => breed.traits.goodWithKids);
+    }
+    // Score each candidate
+    const scored = candidates.map((breed) => {
+        const results = [
+            scoreMusicPreference(profile, breed),
+            scoreActivityLevel(profile, breed),
+            scoreLivingSpace(profile, breed),
+            scoreGrooming(profile, breed),
+            scoreFamilyComposition(profile, breed),
+        ];
+        const score = results.reduce((sum, result) => sum + result.score, 0);
+        const reasons = results.filter((result) => result.reason).map((result) => result.reason);
+        const reasoning = reasons.length > 0
+            ? reasons.join('; ')
+            : 'General compatibility based on temperament';
+        return {
+            breed: breed.name,
+            matchScore: Math.max(0, Math.min(100, score)), // Clamp to 0-100
+            reasoning,
+        };
+    });
+    // Sort by score descending and return top 3
+    return scored
+        .toSorted((a, b) => b.matchScore - a.matchScore)
+        .slice(0, 3);
+}
+//# sourceMappingURL=breed-knowledge.js.map

package/dist/conversational-assistant/breed-knowledge.js.map

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

package/dist/external-event-integrator/human-approval.d.ts

@@ -0,0 +1,207 @@
+import type { Agent, ExternalEventError, OneShotAgentOutput } from '@vibe-agent-toolkit/agent-schema';
+import { z } from 'zod';
+/**
+ * Input schema for approval requests
+ */
+export declare const ApprovalRequestInputSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    autoResponse: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"approve">, z.ZodLiteral<"reject">]>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    context?: Record<string, unknown> | undefined;
+    autoResponse?: "approve" | "reject" | undefined;
+    timeoutMs?: number | undefined;
+}, {
+    prompt: string;
+    context?: Record<string, unknown> | undefined;
+    autoResponse?: "approve" | "reject" | undefined;
+    timeoutMs?: number | undefined;
+}>;
+export type ApprovalRequestInput = z.infer<typeof ApprovalRequestInputSchema>;
+/**
+ * Output schema for approval results
+ */
+export declare const ApprovalResultSchema: z.ZodObject<{
+    approved: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+    timedOut: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    approved: boolean;
+    reason?: string | undefined;
+    timedOut?: boolean | undefined;
+}, {
+    approved: boolean;
+    reason?: string | undefined;
+    timedOut?: boolean | undefined;
+}>;
+export type ApprovalResult = z.infer<typeof ApprovalResultSchema>;
+/**
+ * Input schema for choice requests
+ */
+export declare const ChoiceRequestInputSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    options: z.ZodArray<z.ZodString, "many">;
+    autoResponse: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    options: string[];
+    prompt: string;
+    autoResponse?: string | undefined;
+    timeoutMs?: number | undefined;
+}, {
+    options: string[];
+    prompt: string;
+    autoResponse?: string | undefined;
+    timeoutMs?: number | undefined;
+}>;
+export type ChoiceRequestInput = z.infer<typeof ChoiceRequestInputSchema>;
+/**
+ * Output schema for choice results
+ */
+export declare const ChoiceResultSchema: z.ZodObject<{
+    approved: z.ZodBoolean;
+    choice: z.ZodOptional<z.ZodString>;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    approved: boolean;
+    choice?: string | undefined;
+}, {
+    reason: string;
+    approved: boolean;
+    choice?: string | undefined;
+}>;
+export type ChoiceResult = z.infer<typeof ChoiceResultSchema>;
+/**
+ * Input schema for custom approval requests
+ */
+export declare const CustomApprovalRequestInputSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    autoResponse: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    autoResponse?: string | undefined;
+    timeoutMs?: number | undefined;
+}, {
+    prompt: string;
+    autoResponse?: string | undefined;
+    timeoutMs?: number | undefined;
+}>;
+export type CustomApprovalRequestInput = z.infer<typeof CustomApprovalRequestInputSchema>;
+/**
+ * Output schema for custom approval results
+ */
+export declare const CustomApprovalResultSchema: z.ZodObject<{
+    approved: z.ZodBoolean;
+    value: z.ZodOptional<z.ZodUnknown>;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    approved: boolean;
+    value?: unknown;
+}, {
+    reason: string;
+    approved: boolean;
+    value?: unknown;
+}>;
+export type CustomApprovalResult = z.infer<typeof CustomApprovalResultSchema>;
+/**
+ * Configuration for human approval gate
+ */
+export interface HumanApprovalOptions {
+    /**
+     * Timeout in milliseconds (0 = no timeout)
+     * @default 0
+     */
+    timeoutMs?: number;
+    /**
+     * What to do if timeout occurs
+     * @default 'reject'
+     */
+    onTimeout?: 'approve' | 'reject';
+    /**
+     * For testing: auto-approve/reject without prompting
+     */
+    autoResponse?: 'approve' | 'reject';
+}
+/**
+ * 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 declare function requestApproval(prompt: string, context?: Record<string, unknown>, options?: HumanApprovalOptions): Promise<ApprovalResult>;
+/**
+ * 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 declare function requestCustomApproval<T>(prompt: string, validator: (response: string) => {
+    valid: boolean;
+    value?: T;
+    error?: string;
+}, options?: Omit<HumanApprovalOptions, 'autoResponse'> & {
+    autoResponse?: string;
+}): Promise<{
+    approved: boolean;
+    value?: T;
+    reason: string;
+}>;
+/**
+ * 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 declare function requestChoice<T extends string>(prompt: string, options: T[], config?: Omit<HumanApprovalOptions, 'autoResponse'> & {
+    autoResponse?: T;
+}): Promise<{
+    approved: boolean;
+    choice?: T;
+    reason: string;
+}>;
+/**
+ * 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 declare const requestApprovalAgent: Agent<ApprovalRequestInput, OneShotAgentOutput<ApprovalResult, ExternalEventError>>;
+/**
+ * Request choice agent
+ *
+ * Presents multiple options and asks human to choose one.
+ */
+export declare const requestChoiceAgent: Agent<ChoiceRequestInput, OneShotAgentOutput<ChoiceResult, ExternalEventError>>;
+/**
+ * Request custom approval agent
+ *
+ * Requests approval with custom validation logic.
+ * Note: This is a simplified version - full implementation would need validator function.
+ */
+export declare const requestCustomApprovalAgent: Agent<CustomApprovalRequestInput, OneShotAgentOutput<CustomApprovalResult, ExternalEventError>>;
+//# sourceMappingURL=human-approval.d.ts.map

package/dist/external-event-integrator/human-approval.d.ts.map

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