@vibe-agent-toolkit/agent-schema 0.1.1 → 0.1.2-rc.3

package/dist/index.d.ts

@@ -3,10 +3,12 @@
  *
  * JSON Schema definitions and TypeScript types for VAT agent manifest format.
  */
-export declare const VERSION = "0.1.0";
+export { toJsonSchema, type JsonSchemaOptions } from './schema-utils.js';
+export * from './result-types.js';
+export * from './output-envelopes.js';
 export { AgentMetadataSchema, BuildMetadataSchema, type AgentMetadata, type BuildMetadata, } from './metadata.js';
 export { LLMConfigSchema, type LLMConfig, } from './llm.js';
-export { AgentInterfaceSchema, SchemaRefSchema, type AgentInterface, type SchemaRef, } from './interface.js';
+export { AgentInterfaceSchema, SchemaRefSchema, type Agent, type AgentInterface, type SchemaRef, } from './interface.js';
 export { ToolAlternativeSchema, ToolSchema, type Tool, type ToolAlternative, } from './tool.js';
 export { ResourceRegistrySchema, ResourceSchema, type Resource, type ResourceRegistry, } from './resource-registry.js';
 export { AgentManifestSchema, AgentSpecSchema, CompositionConfigSchema, CredentialsConfigSchema, MemoryConfigSchema, PromptConfigSchema, PromptsConfigSchema, RAGConfigSchema, TestConfigSchema, type AgentManifest, type AgentSpec, type CompositionConfig, type CredentialsConfig, type MemoryConfig, type PromptConfig, type PromptsConfig, type RAGConfig, type TestConfig, } from './agent-manifest.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,KAAK,IAAI,EACT,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,KAAK,IAAI,EACT,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -3,7 +3,11 @@
  *
  * JSON Schema definitions and TypeScript types for VAT agent manifest format.
  */
-export const VERSION = '0.1.0';
+// JSON Schema utilities
+export { toJsonSchema } from './schema-utils.js';
+// Result types
+export * from './result-types.js';
+export * from './output-envelopes.js';
 // Core schemas
 export { AgentMetadataSchema, BuildMetadataSchema, } from './metadata.js';
 export { LLMConfigSchema, } from './llm.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,eAAe,GAGhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,UAAU,GAGX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,cAAc,GAGf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GAUjB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AAEzE,eAAe;AACf,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAEtC,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,eAAe,GAIhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,UAAU,GAGX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,cAAc,GAGf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GAUjB,MAAM,qBAAqB,CAAC"}

package/dist/interface.d.ts

@@ -44,4 +44,37 @@ export declare const AgentInterfaceSchema: z.ZodObject<{
     } | undefined;
 }>;
 export type AgentInterface = z.infer<typeof AgentInterfaceSchema>;
+/**
+ * TypeScript interface for executable agents.
+ *
+ * Represents a VAT agent with a defined input/output contract and manifest.
+ * ALL agents must be async for consistency and future capabilities.
+ */
+export interface Agent<TInput = unknown, TOutput = unknown> {
+    /** Unique name for the agent */
+    name: string;
+    /** Metadata describing the agent's interface and capabilities */
+    manifest: AgentManifest;
+    /**
+     * Execute the agent with given input.
+     * ALL agents must return Promise for consistency and future-proofing.
+     */
+    execute(input: TInput, context?: unknown): Promise<TOutput>;
+}
+/**
+ * Agent manifest metadata.
+ * Describes what the agent does and how to interact with it.
+ */
+export interface AgentManifest {
+    /** Unique name for the agent */
+    name: string;
+    /** Semantic version (e.g., "1.0.0") */
+    version: string;
+    /** Human-readable description of what the agent does */
+    description: string;
+    /** Agent archetype (e.g., "pure-function-tool", "llm-analyzer", "conversational-assistant") */
+    archetype: string;
+    /** Additional metadata (model, temperature, capabilities, etc.) */
+    metadata?: Record<string, unknown>;
+}
 //# sourceMappingURL=interface.d.ts.map

package/dist/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;EAGiB,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQmB,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;EAGiB,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQmB,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,KAAK,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACxD,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,QAAQ,EAAE,aAAa,CAAC;IAExB;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IAEpB,+FAA+F;IAC/F,SAAS,EAAE,MAAM,CAAC;IAElB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/output-envelopes.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Output envelope types for different agent archetypes.
+ */
+import type { AgentResult, StatefulAgentResult } from './result-types.js';
+/**
+ * Output envelope for one-shot agents (pure functions, analyzers).
+ *
+ * Simpler envelope for synchronous, single-execution agents.
+ * Used by archetypes: Pure Function Tool, One-Shot LLM Analyzer
+ */
+export interface OneShotAgentOutput<TData, TError extends string = string> {
+    /** Machine-readable result for orchestration */
+    result: AgentResult<TData, TError>;
+    /** Optional metadata (tokens used, confidence score, timing, etc.) */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Output envelope for conversational agents.
+ *
+ * Combines human-facing conversational interface with
+ * machine-readable result for orchestration.
+ * Used by archetype: Conversational Assistant
+ */
+export interface ConversationalAgentOutput<TData, TError extends string = string, TSessionState = unknown> {
+    /** Human-readable response for display */
+    reply: string;
+    /** Updated session state for next turn */
+    sessionState: TSessionState;
+    /** Machine-readable result for orchestration */
+    result: StatefulAgentResult<TData, TError, {
+        /** Optional progress indicators for monitoring */
+        progress?: {
+            current: number;
+            total: number;
+            message?: string;
+        };
+    }>;
+}
+//# sourceMappingURL=output-envelopes.d.ts.map

package/dist/output-envelopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-envelopes.d.ts","sourceRoot":"","sources":["../src/output-envelopes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM;IACvE,gDAAgD;IAChD,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEnC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB,CAAC,KAAK,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,aAAa,GAAG,OAAO;IACvG,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,YAAY,EAAE,aAAa,CAAC;IAE5B,gDAAgD;IAChD,MAAM,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE;QACzC,kDAAkD;QAClD,QAAQ,CAAC,EAAE;YACT,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC,CAAC;CACJ"}

package/dist/output-envelopes.js

@@ -0,0 +1,5 @@
+/**
+ * Output envelope types for different agent archetypes.
+ */
+export {};
+//# sourceMappingURL=output-envelopes.js.map

package/dist/output-envelopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-envelopes.js","sourceRoot":"","sources":["../src/output-envelopes.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/result-types.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Core result types for VAT agents.
+ * Based on Railway-Oriented Programming pattern.
+ */
+/** Success status constant */
+export declare const RESULT_SUCCESS: "success";
+/** Error status constant */
+export declare const RESULT_ERROR: "error";
+/** In-progress status constant (for stateful agents) */
+export declare const RESULT_IN_PROGRESS: "in-progress";
+export type ResultStatus = typeof RESULT_SUCCESS | typeof RESULT_ERROR;
+export type StatefulResultStatus = typeof RESULT_IN_PROGRESS | typeof RESULT_SUCCESS | typeof RESULT_ERROR;
+/** LLM refused to generate output (content policy violation) */
+export declare const LLM_REFUSAL: "llm-refusal";
+/** LLM output didn't match expected format (parsing failed) */
+export declare const LLM_INVALID_OUTPUT: "llm-invalid-output";
+/** Request timed out */
+export declare const LLM_TIMEOUT: "llm-timeout";
+/** Hit rate limit */
+export declare const LLM_RATE_LIMIT: "llm-rate-limit";
+/** Exceeded token limit */
+export declare const LLM_TOKEN_LIMIT: "llm-token-limit";
+/** Service unavailable */
+export declare const LLM_UNAVAILABLE: "llm-unavailable";
+/**
+ * Standard LLM error types that all LLM-based agents can use.
+ *
+ * These represent expected LLM failure modes that should be handled
+ * gracefully by orchestrators (retry, fallback, etc.) rather than
+ * treated as system failures.
+ */
+export type LLMError = typeof LLM_REFUSAL | typeof LLM_INVALID_OUTPUT | typeof LLM_TIMEOUT | typeof LLM_RATE_LIMIT | typeof LLM_TOKEN_LIMIT | typeof LLM_UNAVAILABLE;
+/**
+ * LLM errors that are retryable (transient failures).
+ * Orchestrators should retry these with exponential backoff.
+ */
+export declare const RETRYABLE_LLM_ERRORS: Set<LLMError>;
+/**
+ * LLM errors that are NOT retryable (permanent failures).
+ * Orchestrators should not retry these.
+ */
+export declare const NON_RETRYABLE_LLM_ERRORS: Set<LLMError>;
+/** External event timed out */
+export declare const EVENT_TIMEOUT: "event-timeout";
+/** External system unavailable */
+export declare const EVENT_UNAVAILABLE: "event-unavailable";
+/** External system rejected request */
+export declare const EVENT_REJECTED: "event-rejected";
+/** External system returned invalid response */
+export declare const EVENT_INVALID_RESPONSE: "event-invalid-response";
+/**
+ * Standard external event error types for agents that integrate with
+ * external systems or humans.
+ *
+ * These represent expected integration failure modes that should be
+ * handled gracefully by orchestrators (retry, fallback, escalation)
+ * rather than treated as system failures.
+ */
+export type ExternalEventError = typeof EVENT_TIMEOUT | typeof EVENT_UNAVAILABLE | typeof EVENT_REJECTED | typeof EVENT_INVALID_RESPONSE;
+/**
+ * External event errors that are retryable (transient failures).
+ * Orchestrators should retry these with exponential backoff.
+ */
+export declare const RETRYABLE_EVENT_ERRORS: Set<ExternalEventError>;
+/**
+ * External event errors that are NOT retryable (permanent failures).
+ * Orchestrators should not retry these.
+ */
+export declare const NON_RETRYABLE_EVENT_ERRORS: Set<ExternalEventError>;
+/**
+ * Execution metadata for production observability.
+ *
+ * Optional fields that agents can populate for monitoring,
+ * cost tracking, and debugging.
+ *
+ * @property durationMs - Total execution duration in milliseconds
+ * @property tokensUsed - Total LLM tokens consumed
+ * @property cost - Estimated cost in USD
+ * @property model - Model identifier (e.g., 'gpt-4o-mini')
+ * @property provider - Provider identifier (e.g., 'openai', 'anthropic')
+ * @property retryCount - Number of times orchestrator retried (0 = no retries)
+ * @property timestamp - ISO 8601 timestamp of execution start
+ */
+export interface ExecutionMetadata {
+    /** Total execution duration in milliseconds */
+    durationMs?: number;
+    /** Total LLM tokens consumed */
+    tokensUsed?: number;
+    /** Estimated cost in USD */
+    cost?: number;
+    /** Model identifier (e.g., 'gpt-4o-mini') */
+    model?: string;
+    /** Provider identifier (e.g., 'openai', 'anthropic') */
+    provider?: string;
+    /**
+     * Number of times orchestrator retried agent execution.
+     * - 0 = no retries (succeeded on first attempt)
+     * - 1 = one retry (failed once, succeeded on second attempt)
+     * - N = N retries
+     *
+     * Set by orchestrator's retry wrapper, not by agent.
+     */
+    retryCount?: number;
+    /** ISO 8601 timestamp of execution start */
+    timestamp?: string;
+}
+/**
+ * Create a success result with optional observability fields.
+ *
+ * @example
+ * return createSuccess({ name: 'Fluffy', valid: true });
+ *
+ * @example
+ * return createSuccess(data, {
+ *   confidence: 0.95,
+ *   warnings: ['Unusual pattern detected'],
+ * });
+ */
+export declare function createSuccess<TData>(data: TData, options?: {
+    confidence?: number;
+    warnings?: string[];
+    execution?: ExecutionMetadata;
+}): AgentResult<TData, never>;
+/**
+ * Create an error result with optional observability fields.
+ *
+ * @example
+ * return createError('invalid-format');
+ *
+ * @example
+ * return createError(LLM_TIMEOUT, {
+ *   confidence: 0.9,
+ *   execution: { durationMs: 5000 },
+ * });
+ */
+export declare function createError<TError extends string>(error: TError, options?: {
+    confidence?: number;
+    execution?: ExecutionMetadata;
+}): AgentResult<never, TError>;
+/**
+ * Create an in-progress result for stateful agents with optional observability fields.
+ *
+ * @example
+ * return createInProgress({ step: 2, totalSteps: 5 });
+ *
+ * @example
+ * return createInProgress(undefined, {
+ *   confidence: 0.7,
+ *   warnings: ['Still gathering information'],
+ * });
+ */
+export declare function createInProgress<TMetadata>(metadata?: TMetadata, options?: {
+    confidence?: number;
+    warnings?: string[];
+    execution?: ExecutionMetadata;
+}): StatefulAgentResult<never, never, TMetadata>;
+/**
+ * Standard result envelope for agents.
+ *
+ * Provides type-safe success/error handling for orchestration.
+ * Based on functional programming Result<T, E> pattern (Rust, F#).
+ *
+ * @template TData - Success data type
+ * @template TError - Error type (use constants, not string literals)
+ */
+export type AgentResult<TData, TError extends string = string> = {
+    status: typeof RESULT_SUCCESS;
+    data: TData;
+    /** Confidence in result (0-1 scale) */
+    confidence?: number;
+    /** Non-fatal warnings */
+    warnings?: string[];
+    /** Execution metadata for observability */
+    execution?: ExecutionMetadata;
+} | {
+    status: typeof RESULT_ERROR;
+    error: TError;
+    /** Confidence in error classification (0-1 scale) */
+    confidence?: number;
+    /** Execution metadata for observability */
+    execution?: ExecutionMetadata;
+};
+/**
+ * Extended result for stateful/multi-turn agents.
+ *
+ * Adds 'in-progress' state for conversational, async, or long-running agents.
+ * Composes AgentResult (success/error) with an additional in-progress state.
+ *
+ * @template TData - Success data type
+ * @template TError - Error type (use constants, not string literals)
+ * @template TMetadata - Metadata type for in-progress state
+ */
+export type StatefulAgentResult<TData, TError extends string = string, TMetadata = unknown> = {
+    status: typeof RESULT_IN_PROGRESS;
+    metadata?: TMetadata;
+    /** Progress indicator (0-1 scale) */
+    confidence?: number;
+    /** Non-fatal warnings */
+    warnings?: string[];
+    /** Execution metadata for observability */
+    execution?: ExecutionMetadata;
+} | AgentResult<TData, TError>;
+//# sourceMappingURL=result-types.d.ts.map

package/dist/result-types.d.ts.map

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

package/dist/result-types.js

@@ -0,0 +1,153 @@
+/**
+ * Core result types for VAT agents.
+ * Based on Railway-Oriented Programming pattern.
+ */
+// ============================================================================
+// Status Constants
+// ============================================================================
+/** Success status constant */
+export const RESULT_SUCCESS = 'success';
+/** Error status constant */
+export const RESULT_ERROR = 'error';
+/** In-progress status constant (for stateful agents) */
+export const RESULT_IN_PROGRESS = 'in-progress';
+// ============================================================================
+// LLM Error Constants
+// ============================================================================
+/** LLM refused to generate output (content policy violation) */
+export const LLM_REFUSAL = 'llm-refusal';
+/** LLM output didn't match expected format (parsing failed) */
+export const LLM_INVALID_OUTPUT = 'llm-invalid-output';
+/** Request timed out */
+export const LLM_TIMEOUT = 'llm-timeout';
+/** Hit rate limit */
+export const LLM_RATE_LIMIT = 'llm-rate-limit';
+/** Exceeded token limit */
+export const LLM_TOKEN_LIMIT = 'llm-token-limit';
+/** Service unavailable */
+export const LLM_UNAVAILABLE = 'llm-unavailable';
+/**
+ * LLM errors that are retryable (transient failures).
+ * Orchestrators should retry these with exponential backoff.
+ */
+export const RETRYABLE_LLM_ERRORS = new Set([
+    LLM_TIMEOUT,
+    LLM_RATE_LIMIT,
+    LLM_UNAVAILABLE,
+]);
+/**
+ * LLM errors that are NOT retryable (permanent failures).
+ * Orchestrators should not retry these.
+ */
+export const NON_RETRYABLE_LLM_ERRORS = new Set([
+    LLM_REFUSAL,
+    LLM_INVALID_OUTPUT,
+    LLM_TOKEN_LIMIT,
+]);
+// ============================================================================
+// External Event Error Constants
+// ============================================================================
+/** External event timed out */
+export const EVENT_TIMEOUT = 'event-timeout';
+/** External system unavailable */
+export const EVENT_UNAVAILABLE = 'event-unavailable';
+/** External system rejected request */
+export const EVENT_REJECTED = 'event-rejected';
+/** External system returned invalid response */
+export const EVENT_INVALID_RESPONSE = 'event-invalid-response';
+/**
+ * External event errors that are retryable (transient failures).
+ * Orchestrators should retry these with exponential backoff.
+ */
+export const RETRYABLE_EVENT_ERRORS = new Set([
+    EVENT_TIMEOUT,
+    EVENT_UNAVAILABLE,
+]);
+/**
+ * External event errors that are NOT retryable (permanent failures).
+ * Orchestrators should not retry these.
+ */
+export const NON_RETRYABLE_EVENT_ERRORS = new Set([
+    EVENT_REJECTED,
+    EVENT_INVALID_RESPONSE,
+]);
+// ============================================================================
+// Result Constructors
+// ============================================================================
+/**
+ * Internal helper to build observability fields object.
+ * Reduces duplication across result constructors.
+ *
+ * @internal
+ */
+function buildObservabilityFields(options) {
+    const fields = {};
+    if (options?.confidence !== undefined) {
+        fields.confidence = options.confidence;
+    }
+    if (options?.warnings) {
+        fields.warnings = options.warnings;
+    }
+    if (options?.execution) {
+        fields.execution = options.execution;
+    }
+    return fields;
+}
+/**
+ * Create a success result with optional observability fields.
+ *
+ * @example
+ * return createSuccess({ name: 'Fluffy', valid: true });
+ *
+ * @example
+ * return createSuccess(data, {
+ *   confidence: 0.95,
+ *   warnings: ['Unusual pattern detected'],
+ * });
+ */
+export function createSuccess(data, options) {
+    return {
+        status: RESULT_SUCCESS,
+        data,
+        ...buildObservabilityFields(options),
+    };
+}
+/**
+ * Create an error result with optional observability fields.
+ *
+ * @example
+ * return createError('invalid-format');
+ *
+ * @example
+ * return createError(LLM_TIMEOUT, {
+ *   confidence: 0.9,
+ *   execution: { durationMs: 5000 },
+ * });
+ */
+export function createError(error, options) {
+    return {
+        status: RESULT_ERROR,
+        error,
+        ...buildObservabilityFields(options),
+    };
+}
+/**
+ * Create an in-progress result for stateful agents with optional observability fields.
+ *
+ * @example
+ * return createInProgress({ step: 2, totalSteps: 5 });
+ *
+ * @example
+ * return createInProgress(undefined, {
+ *   confidence: 0.7,
+ *   warnings: ['Still gathering information'],
+ * });
+ */
+export function createInProgress(metadata, options) {
+    return {
+        status: RESULT_IN_PROGRESS,
+        ...(metadata !== undefined && { metadata }),
+        ...buildObservabilityFields(options),
+    };
+}
+//# sourceMappingURL=result-types.js.map

package/dist/result-types.js.map

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

package/dist/schema-utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * JSON Schema utilities
+ *
+ * Provides convenience functions for converting Zod schemas to JSON Schema
+ * with vibe-agent-toolkit conventions and enhancements.
+ */
+import type { ZodSchema } from 'zod';
+import { type Options } from 'zod-to-json-schema';
+/**
+ * Options for JSON Schema generation
+ *
+ * Extends zod-to-json-schema options with toolkit-specific enhancements
+ */
+export interface JsonSchemaOptions extends Partial<Options> {
+    /**
+     * Include toolkit version metadata in the generated schema
+     * Adds x-vat-version field to the schema root
+     *
+     * @default false
+     */
+    includeToolkitMetadata?: boolean;
+    /**
+     * Override the JSON Schema draft version
+     *
+     * @default "https://json-schema.org/draft/2020-12/schema"
+     */
+    $schema?: string;
+}
+/**
+ * Convert Zod schema to JSON Schema with vibe-agent-toolkit conventions
+ *
+ * This function wraps zod-to-json-schema with sensible defaults and
+ * toolkit-specific enhancements:
+ *
+ * - Sets $schema to JSON Schema Draft 2020-12 by default
+ * - Uses inline refs (no $ref strategy) for simpler schemas
+ * - Optionally injects toolkit version metadata
+ * - Provides a stable interface for future enhancements
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ * import { toJsonSchema } from '@vibe-agent-toolkit/agent-schema';
+ *
+ * const MySchema = z.object({
+ *   name: z.string().describe('User name'),
+ *   age: z.number().min(0),
+ * });
+ *
+ * const jsonSchema = toJsonSchema(MySchema, {
+ *   name: 'my-schema',
+ *   includeToolkitMetadata: true,
+ * });
+ * ```
+ *
+ * @param schema - Zod schema to convert
+ * @param options - Conversion options
+ * @returns JSON Schema object
+ */
+export declare function toJsonSchema(schema: ZodSchema, options?: JsonSchemaOptions): object;
+//# sourceMappingURL=schema-utils.d.ts.map

package/dist/schema-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.d.ts","sourceRoot":"","sources":["../src/schema-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,OAAO,CAAC;IACzD;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAuBnF"}

package/dist/schema-utils.js

@@ -0,0 +1,55 @@
+/**
+ * JSON Schema utilities
+ *
+ * Provides convenience functions for converting Zod schemas to JSON Schema
+ * with vibe-agent-toolkit conventions and enhancements.
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Convert Zod schema to JSON Schema with vibe-agent-toolkit conventions
+ *
+ * This function wraps zod-to-json-schema with sensible defaults and
+ * toolkit-specific enhancements:
+ *
+ * - Sets $schema to JSON Schema Draft 2020-12 by default
+ * - Uses inline refs (no $ref strategy) for simpler schemas
+ * - Optionally injects toolkit version metadata
+ * - Provides a stable interface for future enhancements
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ * import { toJsonSchema } from '@vibe-agent-toolkit/agent-schema';
+ *
+ * const MySchema = z.object({
+ *   name: z.string().describe('User name'),
+ *   age: z.number().min(0),
+ * });
+ *
+ * const jsonSchema = toJsonSchema(MySchema, {
+ *   name: 'my-schema',
+ *   includeToolkitMetadata: true,
+ * });
+ * ```
+ *
+ * @param schema - Zod schema to convert
+ * @param options - Conversion options
+ * @returns JSON Schema object
+ */
+export function toJsonSchema(schema, options) {
+    const { includeToolkitMetadata = false, $schema: schemaVersion = 'https://json-schema.org/draft/2020-12/schema', ...zodOptions } = options ?? {};
+    // Convert with default strategy: inline refs for simplicity
+    const jsonSchema = zodToJsonSchema(schema, {
+        $refStrategy: 'none',
+        ...zodOptions,
+    });
+    // Override $schema to ensure our standard version
+    jsonSchema['$schema'] = schemaVersion;
+    // Optional: Add toolkit metadata
+    if (includeToolkitMetadata) {
+        // NOTE: Version hardcoded until it becomes meaningful for adopters
+        jsonSchema['x-vat-version'] = '0.1.1';
+    }
+    return jsonSchema;
+}
+//# sourceMappingURL=schema-utils.js.map

package/dist/schema-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.js","sourceRoot":"","sources":["../src/schema-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAgB,MAAM,oBAAoB,CAAC;AAwBnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,YAAY,CAAC,MAAiB,EAAE,OAA2B;IACzE,MAAM,EACJ,sBAAsB,GAAG,KAAK,EAC9B,OAAO,EAAE,aAAa,GAAG,8CAA8C,EACvE,GAAG,UAAU,EACd,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,4DAA4D;IAC5D,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE;QACzC,YAAY,EAAE,MAAM;QACpB,GAAG,UAAU;KACd,CAA4B,CAAC;IAE9B,kDAAkD;IAClD,UAAU,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC;IAEtC,iCAAiC;IACjC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,mEAAmE;QACnE,UAAU,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC;IACxC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/agent-schema",
-  "version": "0.1.1",
+  "version": "0.1.2-rc.3",
   "description": "JSON Schema definitions and TypeScript types for VAT agent manifest format",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
     "zod-to-json-schema": "^3.23.5"
   },
   "devDependencies": {
-    "@vibe-agent-toolkit/utils": "0.1.1",
+    "@vibe-agent-toolkit/utils": "0.1.2-rc.3",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4"