@framers/agentos 0.1.0

package/dist/core/structured/IStructuredOutputManager.d.ts.map

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

package/dist/core/structured/IStructuredOutputManager.js

@@ -0,0 +1,74 @@
+/**
+ * @file IStructuredOutputManager.ts
+ * @description Interface for the Structured Output Manager in AgentOS.
+ *
+ * The Structured Output Manager ensures LLM outputs conform to predefined
+ * schemas, enabling reliable parsing, validation, and type-safe consumption
+ * of agent responses. This is critical for:
+ *
+ * - **Tool Calls**: Ensuring function arguments match expected types
+ * - **Data Extraction**: Pulling structured data from unstructured text
+ * - **API Responses**: Generating responses that match API contracts
+ * - **Multi-step Workflows**: Reliable data flow between pipeline stages
+ *
+ * Supports multiple output strategies:
+ * - JSON Mode (OpenAI, Anthropic)
+ * - Function Calling / Tool Use
+ * - Grammar-constrained generation (local models)
+ * - Post-hoc parsing with retry
+ *
+ * @module AgentOS/Structured
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const manager = new StructuredOutputManager(llmProvider);
+ *
+ * // Define a schema for extraction
+ * const personSchema: JSONSchema = {
+ *   type: 'object',
+ *   properties: {
+ *     name: { type: 'string' },
+ *     age: { type: 'integer', minimum: 0 },
+ *     email: { type: 'string', format: 'email' },
+ *   },
+ *   required: ['name', 'email'],
+ * };
+ *
+ * // Extract structured data
+ * const result = await manager.generate({
+ *   prompt: 'Extract person info from: John Doe, 30 years old, john@example.com',
+ *   schema: personSchema,
+ *   schemaName: 'Person',
+ * });
+ *
+ * console.log(result.data); // { name: 'John Doe', age: 30, email: 'john@example.com' }
+ * ```
+ */
+/**
+ * Error thrown when structured output generation fails.
+ */
+export class StructuredOutputError extends Error {
+    constructor(message, validationErrors, rawOutput, retryCount, strategy) {
+        super(message);
+        this.name = 'StructuredOutputError';
+        this.validationErrors = validationErrors;
+        this.rawOutput = rawOutput;
+        this.retryCount = retryCount;
+        this.strategy = strategy;
+    }
+    /**
+     * Converts error to a plain object for serialization.
+     */
+    toPlainObject() {
+        return {
+            name: this.name,
+            message: this.message,
+            validationErrors: this.validationErrors,
+            rawOutput: this.rawOutput.substring(0, 500), // Truncate for safety
+            retryCount: this.retryCount,
+            strategy: this.strategy,
+        };
+    }
+}
+//# sourceMappingURL=IStructuredOutputManager.js.map

package/dist/core/structured/IStructuredOutputManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStructuredOutputManager.js","sourceRoot":"","sources":["../../../src/core/structured/IStructuredOutputManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAuwBH;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAa9C,YACE,OAAe,EACf,gBAAmC,EACnC,SAAiB,EACjB,UAAkB,EAClB,QAAkC;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,sBAAsB;YACnE,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/core/structured/StructuredOutputManager.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @file StructuredOutputManager.ts
+ * @description Implementation of the Structured Output Manager for AgentOS.
+ *
+ * Provides robust JSON Schema validation, structured generation strategies,
+ * and parallel function calling capabilities. Handles the complexity of
+ * different LLM provider APIs and output formats.
+ *
+ * @module AgentOS/Structured
+ * @version 1.0.0
+ */
+import type { ILogger } from '../../logging/ILogger';
+import type { AIModelProviderManager } from '../llm/providers/AIModelProviderManager';
+import { IStructuredOutputManager, JSONSchema, StructuredGenerationOptions, StructuredGenerationResult, ParallelFunctionCallOptions, ParallelFunctionCallResult, EntityExtractionOptions, EntityExtractionResult, ValidationIssue, StructuredOutputStats, StructuredOutputStrategy } from './IStructuredOutputManager';
+/**
+ * Configuration options for the Structured Output Manager.
+ */
+export interface StructuredOutputManagerConfig {
+    /** LLM provider manager for making requests */
+    llmProviderManager: AIModelProviderManager;
+    /** Default provider ID */
+    defaultProviderId?: string;
+    /** Default model ID */
+    defaultModelId?: string;
+    /** Default max retries */
+    defaultMaxRetries?: number;
+    /** Default timeout in milliseconds */
+    defaultTimeoutMs?: number;
+    /** Logger instance */
+    logger?: ILogger;
+}
+/**
+ * Structured Output Manager implementation.
+ *
+ * Provides comprehensive structured output capabilities including:
+ * - JSON Schema validation with detailed error reporting
+ * - Multiple generation strategies (JSON mode, function calling, prompt engineering)
+ * - Automatic retry with feedback on validation failures
+ * - Parallel function calling with argument validation
+ * - Entity extraction from unstructured text
+ * - Robust JSON parsing with error recovery
+ *
+ * @implements {IStructuredOutputManager}
+ */
+export declare class StructuredOutputManager implements IStructuredOutputManager {
+    private readonly llmProviderManager;
+    private readonly defaultProviderId;
+    private readonly defaultModelId;
+    private readonly defaultMaxRetries;
+    private readonly defaultTimeoutMs;
+    private logger?;
+    /** Registered schemas for reuse */
+    private readonly schemas;
+    /** Statistics tracking */
+    private stats;
+    private totalRetries;
+    private totalLatencyMs;
+    private validationErrorCounts;
+    /**
+     * Creates a new StructuredOutputManager instance.
+     *
+     * @param config - Configuration options
+     */
+    constructor(config: StructuredOutputManagerConfig);
+    /**
+     * Initializes the manager.
+     */
+    initialize(logger?: ILogger): Promise<void>;
+    /**
+     * Generates structured output conforming to the given schema.
+     */
+    generate<T = unknown>(options: StructuredGenerationOptions): Promise<StructuredGenerationResult<T>>;
+    /**
+     * Executes a single generation attempt.
+     */
+    private executeGeneration;
+    /**
+     * Builds messages for the LLM request.
+     */
+    private buildMessages;
+    /**
+     * Generates parallel function/tool calls.
+     */
+    generateFunctionCalls(options: ParallelFunctionCallOptions): Promise<ParallelFunctionCallResult>;
+    /**
+     * Extracts structured entities from unstructured text.
+     */
+    extractEntities<T = unknown>(options: EntityExtractionOptions): Promise<EntityExtractionResult<T>>;
+    /**
+     * Validates data against a JSON Schema.
+     */
+    validate(data: unknown, schema: JSONSchema, strict?: boolean): ValidationIssue[];
+    /**
+     * Recursively validates a value against a schema.
+     */
+    private validateValue;
+    /**
+     * Gets the JSON type of a value.
+     * Note: In JSON Schema, 'integer' is a subset of 'number', so integers
+     * should match both 'integer' and 'number' types.
+     */
+    private getJSONType;
+    /**
+     * Checks if a value matches the expected type(s).
+     */
+    private matchesType;
+    /**
+     * Validates a string format.
+     */
+    private validateFormat;
+    /**
+     * Parses JSON string with error recovery.
+     */
+    parseJSON(jsonString: string): unknown | null;
+    /**
+     * Recommends a strategy for the given provider/model.
+     */
+    recommendStrategy(providerId: string, modelId: string, schema: JSONSchema): StructuredOutputStrategy;
+    /**
+     * Registers a schema for reuse.
+     */
+    registerSchema(name: string, schema: JSONSchema): void;
+    /**
+     * Gets a registered schema.
+     */
+    getSchema(name: string): JSONSchema | undefined;
+    /**
+     * Gets statistics about structured output operations.
+     */
+    getStatistics(): StructuredOutputStats;
+    /**
+     * Resets statistics.
+     */
+    resetStatistics(): void;
+    /**
+     * Updates derived statistics.
+     */
+    private updateStats;
+}
+//# sourceMappingURL=StructuredOutputManager.d.ts.map

package/dist/core/structured/StructuredOutputManager.d.ts.map

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