@primo-ai/sdk 0.1.0

package/README.md

@@ -0,0 +1,93 @@
+# @primo-ai/sdk
+
+Pure type definitions for the AgentForge framework. Zero dependencies.
+
+## Overview
+
+This package contains all shared types used across the AgentForge monorepo. It has no runtime code and zero dependencies -- it exists solely to provide TypeScript interfaces and type aliases.
+
+## Key Types
+
+### Pipeline
+
+| Type | Description |
+|------|-------------|
+| `PipelineStage` | Union of all 13 stage names |
+| `StageName` | `PipelineStage` plus arbitrary plugin-defined strings |
+| `Processor` | `{ stage, execute(context) => Promise<ProcessorResult> }` |
+| `ProcessorResult` | `PipelineContext \| AbortSignal \| SuspensionSignal` |
+| `PipelineContext` | Container with `request`, `agent`, `iteration`, `session` regions |
+| `LoopDirective` | `{ action: 'continue' \| 'stop' \| 'retry' }` |
+
+### Context Regions
+
+| Type | Description |
+|------|-------------|
+| `RequestRegion` | Immutable input: `input`, `sessionId` |
+| `AgentRegion` | Config: `config`, `systemPrompt`, `toolDeclarations`, `promptFragments` |
+| `IterationRegion` | Per-step: `step`, `response`, `loopDirective`, `pendingToolCalls` |
+| `SessionRegion` | Cross-iteration: `messageHistory`, `totalTokenUsage`, `custom` |
+
+### Tools
+
+| Type | Description |
+|------|-------------|
+| `Tool<TInput, TOutput>` | Tool definition with `name`, `description`, `inputSchema`, `execute()` |
+| `ToolCall` | LLM-requested tool invocation: `id`, `name`, `args` |
+| `ToolResult` | Tool execution result: `toolCallId`, `name`, `output` |
+
+### Observability
+
+| Type | Description |
+|------|-------------|
+| `Span` | Observability span with `startChild()`, `setAttribute()`, `end()` |
+| `Tracer` | Span factory: `startSpan(name)` |
+| `Metrics` | Counter/gauge/histogram interface |
+| `TokenUsage` | `{ input: number; output: number }` |
+
+### Plugin System
+
+| Type | Description |
+|------|-------------|
+| `HarnessAPI` | Plugin harness: register processors, tools, hooks, resources |
+| `PluginRegistration` | Plugin return type: processors, tools, commands |
+| `Hook<TInput, TOutput>` | Before/after hook with point, handler, priority |
+| `HookPoint` | `agent.start`, `llm.before`, `tool.after`, etc. |
+| `ResourceDeclaration` | Lifecycle resource: `start()`, `stop()` |
+
+### Configuration
+
+| Type | Description |
+|------|-------------|
+| `AgentConfig` | Agent configuration: `model`, `systemPrompt`, `tools`, `maxIterations` |
+| `Dynamic<T>` | `T \| ((ctx) => T)` -- static or per-request resolved value |
+| `HarnessConfig` | Top-level config: agents, plugins, session, model profiles |
+| `ModelProfile` | Per-model behavior customization |
+| `ModelGateway` | Pluggable model resolver interface |
+| `GatewayConfig` | Serializable gateway configuration |
+
+### Session
+
+| Type | Description |
+|------|-------------|
+| `SessionRecord` | Session metadata: `sessionId`, `status`, `tokenUsage` |
+| `SessionEvent` | Sequential event: `seq`, `type`, `payload` |
+| `SessionStorage` | Storage interface: `append()`, `read()`, `list()` |
+| `SessionManager` | High-level session management: `start()`, `suspend()`, `resume()` |
+
+### A2A Protocol
+
+| Type | Description |
+|------|-------------|
+| `A2ATask` | Task with `id`, `contextId`, `status`, `history`, `artifacts` |
+| `A2AMessage` | Message with `role`, `parts` (text/data/file) |
+| `A2AAgentCard` | Agent metadata: `name`, `skills`, `capabilities` |
+| `JsonRpcRequest` | JSON-RPC 2.0 request |
+| `JsonRpcResponse` | JSON-RPC 2.0 response |
+
+### Client SDK
+
+| Export | Description |
+|--------|-------------|
+| `AgentForgeClient` | HTTP client for connecting to AgentForge servers |
+| `parseSSE` | Parse server-sent events |

package/dist/client.d.ts

@@ -0,0 +1,44 @@
+import type { StreamEvent } from './index.js';
+export declare class AgentForgeClientError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+export declare function isRetryableError(status: number): boolean;
+export interface ClientOptions {
+    url: string;
+    apiKey?: string;
+    retries?: number;
+    retryDelay?: number;
+}
+export interface AgentRunResult {
+    response: string;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    sessionId: string;
+}
+export interface SSEMessage {
+    type: string;
+    [key: string]: unknown;
+}
+export declare function parseSSE(raw: string): Generator<SSEMessage>;
+export declare class AgentForgeClient {
+    private baseUrl;
+    private headers;
+    private retries;
+    private retryDelay;
+    constructor(options: ClientOptions);
+    private request;
+    run(agentId: string, input: string): Promise<AgentRunResult>;
+    stream(agentId: string, input: string, opts?: {
+        mode?: 'text' | 'events';
+    }): AsyncGenerator<string | StreamEvent>;
+    resume(agentId: string, sessionId: string): Promise<AgentRunResult>;
+    getSession(sessionId: string): Promise<{
+        sessionId: string;
+        status: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAM5D;AAQD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAUD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAiB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAQ5D;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,aAAa;YAUpB,OAAO;IA2Cf,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAO3D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,GAAG,cAAc,CAAC,MAAM,GAAG,WAAW,CAAC;IAuBlH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOnE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAMpF"}

package/dist/client.js

@@ -0,0 +1,120 @@
+// ---------------------------------------------------------------------------
+// Error types
+// ---------------------------------------------------------------------------
+export class AgentForgeClientError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = 'AgentForgeClientError';
+        this.status = status;
+        this.body = body;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const RETRYABLE_STATUS_CODES = new Set([429, 502, 503, 504]);
+export function isRetryableError(status) {
+    return RETRYABLE_STATUS_CODES.has(status);
+}
+function delay(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
+export function* parseSSE(raw) {
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith('data: '))
+            continue;
+        try {
+            yield JSON.parse(trimmed.slice(6));
+        }
+        catch { /* skip malformed lines */ }
+    }
+}
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+export class AgentForgeClient {
+    baseUrl;
+    headers;
+    retries;
+    retryDelay;
+    constructor(options) {
+        this.baseUrl = options.url.replace(/\/$/, '');
+        this.headers = { 'Content-Type': 'application/json' };
+        this.retries = options.retries ?? 0;
+        this.retryDelay = options.retryDelay ?? 100;
+        if (options.apiKey) {
+            this.headers['Authorization'] = `Bearer ${options.apiKey}`;
+        }
+    }
+    async request(url, init) {
+        let lastError;
+        const maxAttempts = 1 + this.retries;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            if (attempt > 0) {
+                await delay(this.retryDelay * attempt); // linear backoff
+            }
+            let res;
+            try {
+                res = await fetch(url, { ...init, headers: { ...this.headers, ...init.headers } });
+            }
+            catch (err) {
+                throw new AgentForgeClientError(err instanceof Error ? err.message : 'Network request failed', 0);
+            }
+            if (!res.ok) {
+                let body;
+                try {
+                    body = await res.json();
+                }
+                catch {
+                    body = undefined;
+                }
+                const message = body?.error ?? res.statusText;
+                lastError = new AgentForgeClientError(message, res.status, body);
+                if (isRetryableError(res.status) && attempt < this.retries) {
+                    continue; // retry
+                }
+                throw lastError;
+            }
+            return res.json();
+        }
+        throw lastError;
+    }
+    async run(agentId, input) {
+        return this.request(`${this.baseUrl}/agents/${agentId}/run`, { method: 'POST', body: JSON.stringify({ input }) });
+    }
+    async *stream(agentId, input, opts) {
+        const mode = opts?.mode ?? 'text';
+        const res = await fetch(`${this.baseUrl}/agents/${agentId}/stream?mode=${mode}`, {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify({ input }),
+        });
+        const reader = res.body?.getReader();
+        if (!reader)
+            return;
+        const decoder = new TextDecoder();
+        let buffer = '';
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            for (const msg of parseSSE(buffer)) {
+                yield msg;
+            }
+            const lastNewline = buffer.lastIndexOf('\n\n');
+            if (lastNewline >= 0)
+                buffer = buffer.slice(lastNewline + 2);
+        }
+    }
+    async resume(agentId, sessionId) {
+        return this.request(`${this.baseUrl}/agents/${agentId}/resume`, { method: 'POST', body: JSON.stringify({ sessionId }) });
+    }
+    async getSession(sessionId) {
+        return this.request(`${this.baseUrl}/sessions/${sessionId}`, { method: 'GET' });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,624 @@
+/** The agent lifecycle stages + gate stages + tool sub-pipeline stages. */
+export type PipelineStage = 'processInput' | 'buildContext' | 'prepareStep' | 'gateLLM' | 'invokeLLM' | 'processStepOutput' | 'gateTool' | 'executeTools' | 'evaluateIteration' | 'processOutput' | 'beforeTool' | 'execute' | 'afterTool';
+/** Stage name that accepts built-in stages AND arbitrary plugin-defined strings. */
+export type StageName = PipelineStage | (string & {});
+/** A mutation operation applied to a pipeline phase's stage list. */
+export type StageMutation = {
+    type: 'insert';
+    phase: 'preLoop' | 'loop' | 'postLoop';
+    after: StageName;
+    stage: StageName;
+} | {
+    type: 'remove';
+    phase: 'preLoop' | 'loop' | 'postLoop';
+    stage: StageName;
+} | {
+    type: 'replace';
+    phase: 'preLoop' | 'loop' | 'postLoop';
+    stages: StageName[];
+};
+/** Configurable pipeline stage sequence. Overrides default stage order when provided. */
+export interface PipelineStageConfig {
+    preLoop?: StageName[];
+    loop?: StageName[];
+    postLoop?: StageName[];
+}
+/** A tool call requested by the LLM. */
+export interface ToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+/** The result of executing a tool call. */
+export interface ToolResult {
+    toolCallId: string;
+    name: string;
+    output: unknown;
+    error?: string;
+    mutated?: boolean;
+    truncated?: boolean;
+    validationError?: string;
+}
+/** Structured conversation message supporting tool-call round-trips. */
+export type Message = {
+    role: 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCall[];
+    reasoningContent?: string;
+} | {
+    role: 'tool';
+    content: string;
+    toolCallId: string;
+    toolName: string;
+    result?: unknown;
+    error?: string;
+    mutated?: boolean;
+    truncated?: boolean;
+    validationError?: string;
+};
+/** Abstract token counter — implementations choose encoding strategy. */
+export interface TokenCounter {
+    count(text: string, model?: string): number;
+    countMessages(messages: Message[], model?: string): number;
+}
+export interface ContextBudget {
+    maxTokens: number;
+    reservedForSystem?: number;
+    reservedForTools?: number;
+}
+/** Function that compresses/trim message history before sending to LLM. */
+export type CompressionStrategy = (messages: Message[], tokenCounter: TokenCounter, budget: number) => Message[] | Promise<Message[]>;
+/** Options for the built-in sliding-window strategy. */
+export interface SlidingWindowOptions {
+    /** Maximum number of most-recent messages to keep. Default: 50. */
+    keepRecent?: number;
+}
+export type LoopDirective = {
+    action: 'continue';
+} | {
+    action: 'stop';
+} | {
+    action: 'retry';
+    retryFrom: StageName;
+};
+export interface RequestRegion {
+    input: string;
+    sessionId: string;
+}
+export interface AgentRegion {
+    config: AgentConfig;
+    systemPrompt?: string;
+    toolDeclarations: Array<{
+        name: string;
+        description: string;
+    }>;
+    /** Append-only. Always spread existing: `[...ctx.agent.promptFragments, newFragment]` */
+    promptFragments: string[];
+    /** Per-provider options passed through to streamText(). Keyed by provider name. */
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+export interface IterationRegion {
+    step: number;
+    /** undefined defaults to 'continue'. Default evaluateIteration sets 'stop'. */
+    loopDirective?: LoopDirective;
+    /** AI SDK fullStream yielding text-delta, tool-call, finish-step, error events. */
+    fullStream?: AsyncIterable<unknown>;
+    usagePromise?: Promise<TokenUsage>;
+    /** Promise resolving to reasoning text from the model (e.g. DeepSeek reasoning_content). */
+    reasoningPromise?: Promise<string | undefined>;
+    response?: string;
+    tokenUsage?: TokenUsage;
+    /** Tool calls extracted from the LLM response by PipelineRunner stream consumption. */
+    pendingToolCalls?: ToolCall[];
+    /** Reasoning content from thinking-mode models (e.g. DeepSeek). Must be passed back on subsequent turns. */
+    reasoningContent?: string;
+    /** Results from executing pending tool calls (set by executeTools processor). */
+    toolResults?: ToolResult[];
+    /** Per-stage observability span. Created by PipelineRunner.executeStage(),
+     *  lives for one stage invocation (not one full iteration). */
+    span?: Span;
+}
+export interface SessionRegion {
+    messageHistory?: Message[];
+    totalTokenUsage?: TokenUsage;
+    /** Plugin extension point. Namespaced by plugin ID. */
+    custom: Record<string, unknown>;
+}
+export interface PipelineContext {
+    request: RequestRegion;
+    agent: AgentRegion;
+    iteration: IterationRegion;
+    session: SessionRegion;
+}
+export interface PromptFragment {
+    role: 'system' | 'context' | 'instruction';
+    content: string;
+    priority: number;
+    source: string;
+}
+export interface AbortSignal {
+    type: 'abort';
+    reason: string;
+    retryFrom?: StageName;
+}
+export interface PipelineCheckpoint {
+    context: PipelineContext;
+    nextStages: StageName[];
+    iteration: number;
+}
+export interface SuspensionSignal {
+    type: 'suspend';
+    suspensionId: string;
+    reason: string;
+    checkpoint: PipelineCheckpoint;
+    expiresAt?: string;
+}
+export type ProcessorResult = PipelineContext | AbortSignal | SuspensionSignal;
+export interface Processor {
+    stage: StageName;
+    execute(context: PipelineContext): Promise<ProcessorResult>;
+    /** When true, this processor is an extension point placeholder that just returns ctx unchanged.
+     *  PipelineRunner skips hooks for stages where all processors are no-ops. */
+    isNoOp?: boolean;
+}
+export interface ToolExecutionContext {
+    harness?: unknown;
+    span?: unknown;
+    sessionId?: string;
+}
+export interface Tool<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description: string;
+    inputSchema: unknown;
+    outputSchema?: unknown;
+    execute(input: TInput, context: ToolExecutionContext): Promise<TOutput>;
+    requireApproval?: boolean;
+    allowOutputMutation?: boolean;
+    renderCall?(input: TInput): string;
+    renderResult?(output: TOutput): string;
+}
+export type ToolDefinition = Tool;
+export interface SpanContext {
+    spanId: string;
+    traceId: string;
+}
+export interface Span {
+    readonly name: string;
+    startChild(name: string): Span;
+    end(): void;
+    setAttribute(key: string, value: unknown): Span;
+    addEvent(name: string, attributes?: Record<string, unknown>): Span;
+    spanContext(): SpanContext;
+}
+export interface Tracer {
+    startSpan(name: string): Span;
+    getCurrentSpan(): Span | undefined;
+}
+export interface Metrics {
+    increment(name: string, delta?: number, labels?: Record<string, string>): void;
+    gauge(name: string, value: number, labels?: Record<string, string>): void;
+    histogram(name: string, value: number, labels?: Record<string, string>): void;
+}
+export interface TokenUsage {
+    input: number;
+    output: number;
+}
+export declare const SpanType: {
+    readonly AGENT_RUN: "agent_run";
+    readonly MODEL_STEP: "model_step";
+    readonly TOOL_CALL: "tool_call";
+    readonly PROCESSOR_RUN: "processor_run";
+    readonly LLM_STREAM: "llm.stream";
+    readonly TOOL_EXECUTE: "tool.execute";
+    readonly GATE_DECISION: "harness.gate";
+    readonly COST_CAP_CHECK: "harness.cost-cap";
+    readonly TOKEN_BUDGET_CHECK: "harness.token-budget";
+    readonly GOAL_ECHO: "harness.goal-echo";
+    readonly FACT_INJECTION: "harness.fact-injection";
+    readonly COMPRESSION: "harness.compression";
+    readonly SESSION_LIFECYCLE: "session.lifecycle";
+    readonly TOOL_REGISTER: "tool.register";
+    readonly TOOL_LOOKUP: "tool.lookup";
+    readonly EVENT_DISPATCH: "event.dispatch";
+    readonly GATEWAY_RESOLVE: "gateway.resolve";
+    readonly CONTEXT_BUILD: "context.build";
+    readonly LOOP_ITERATION: "loop.iteration";
+    readonly SUB_AGENT_RUN: "subagent.run";
+    readonly CHECKPOINT: "checkpoint";
+    readonly MCP_CONNECT: "mcp.connect";
+    readonly MCP_TOOL_CALL: "mcp.tool_call";
+};
+/** Standard span attribute keys for consistent observability across the framework. */
+export declare const SpanAttributeKeys: {
+    readonly TOKENS_INPUT: "tokens.input";
+    readonly TOKENS_OUTPUT: "tokens.output";
+    readonly TOKENS_TOTAL: "tokens.total";
+    readonly COST_ESTIMATED: "cost.estimated";
+    readonly COST_CUMULATIVE: "cost.cumulative";
+    readonly COST_BUDGET: "cost.budget";
+    readonly MODEL_NAME: "model.name";
+    readonly TOOL_NAME: "tool.name";
+    readonly TOOL_RESULT_SIZE: "tool.result_size";
+    readonly HARNESS_DECISION: "harness.decision";
+    readonly HARNESS_REASON: "harness.reason";
+    readonly BUDGET_CONTEXT_MAX: "budget.context_max";
+    readonly BUDGET_CONTEXT_USED: "budget.context_used";
+    readonly BUDGET_RESERVED_OUTPUT: "budget.reserved_output";
+    readonly GOAL_TEXT: "goal.text";
+    readonly GOAL_PROGRESS: "goal.progress";
+    readonly GOAL_ITERATION: "goal.iteration";
+    readonly FACT_COUNT: "fact.count";
+};
+export type SpanType = (typeof SpanType)[keyof typeof SpanType];
+export type StreamEvent = {
+    type: 'text_delta';
+    text: string;
+} | {
+    type: 'stage_start';
+    stage: StageName;
+} | {
+    type: 'stage_complete';
+    stage: StageName;
+} | {
+    type: 'tool_call';
+    name: string;
+    args: unknown;
+} | {
+    type: 'tool_result';
+    name: string;
+    result: unknown;
+} | {
+    type: 'complete';
+    context: PipelineContext;
+} | {
+    type: 'abort';
+    reason: string;
+    retryFrom?: StageName;
+} | {
+    type: 'suspended';
+    suspensionId: string;
+    reason: string;
+    checkpoint: PipelineCheckpoint;
+};
+export type EventType = 'agent:start' | 'agent:end' | 'tool:before' | 'tool:after' | string;
+export type HookPoint = 'agent.start' | 'agent.end' | 'stage.before' | 'stage.after' | 'llm.before' | 'llm.after' | 'tool.before' | 'tool.after' | 'iteration.end' | 'error';
+export type HookProfile = 'minimal' | 'standard' | 'strict';
+export interface Hook<TInput = unknown, TOutput = unknown> {
+    point: HookPoint;
+    name?: string;
+    handler: (input: TInput, output: TOutput) => void | Promise<void>;
+    priority?: number;
+}
+export interface AgentHookInput {
+    sessionId: string;
+    request: RequestRegion;
+    agentConfig: AgentConfig;
+}
+export interface StageHookInput {
+    stage: StageName;
+    context: PipelineContext;
+}
+export interface LLMHookInput {
+    model: string;
+    messages: Message[];
+    tools?: unknown[];
+    options?: Record<string, unknown>;
+}
+export interface ToolHookInput {
+    toolName: string;
+    args: unknown;
+    sessionId: string;
+}
+export interface ErrorHookInput {
+    error: unknown;
+    stage: StageName;
+    sessionId: string;
+}
+export interface ResourceDeclaration {
+    id: string;
+    type: string;
+    config: Record<string, unknown>;
+    start: () => Promise<unknown>;
+    stop: (instance: unknown) => Promise<void>;
+}
+export interface HarnessAPI {
+    registerProcessor(stage: StageName, processor: Processor): void;
+    registerTool(tool: ToolDefinition): void;
+    unregisterTool(name: string): boolean;
+    registerCommand(name: string, handler: (args: string) => Promise<void>): void;
+    registerHook(hook: Hook): void;
+    subscribe(eventType: string, handler: (data?: unknown) => void): () => void;
+    registerResource(declaration: ResourceDeclaration): void;
+    registerProvider(name: string, factory: unknown): void;
+    registerCompressionStrategy(strategy: CompressionStrategy): void;
+    emit(eventType: string, data?: unknown): void;
+    insertStage(phase: 'preLoop' | 'loop' | 'postLoop', after: StageName, newStage: StageName): void;
+    removeStage(phase: 'preLoop' | 'loop' | 'postLoop', stage: StageName): void;
+    replaceStages(phase: 'preLoop' | 'loop' | 'postLoop', stages: StageName[]): void;
+}
+export interface PluginRegistration {
+    processors?: Processor[];
+    tools?: ToolDefinition[];
+    commands?: Record<string, (args: string) => Promise<void>>;
+    compressionStrategy?: CompressionStrategy;
+}
+/** Transport protocol for MCP server connections. */
+export type McpTransport = 'stdio' | 'sse' | 'http';
+/**
+ * Configuration for an MCP (Model Context Protocol) server connection.
+ * For stdio transport, provide `command`. For sse/http transport, provide `url`.
+ */
+export interface McpServerConfig {
+    name: string;
+    transport?: McpTransport;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+}
+export interface AgentConfig {
+    model: string;
+    systemPrompt?: Dynamic<string>;
+    maxIterations?: Dynamic<number>;
+    tools?: Tool[];
+    providerOptions?: Record<string, Record<string, unknown>>;
+    /** Tool names that must be called at least once before the loop can stop. */
+    requiredTools?: string[];
+    /** Policy for handling required tools that the LLM fails to call after retries.
+     *  - 'advise' (default): adds prompt fragments asking the LLM to call them; stops loop when exhausted.
+     *  - 'enforce': when exhausted, injects synthetic tool calls and continues the loop.
+     */
+    requiredToolPolicy?: 'advise' | 'enforce';
+}
+/** Context passed to Dynamic<T> resolver functions at processInput stage. */
+export interface ResolveContext {
+    input: string;
+    sessionId: string;
+    metadata: Record<string, unknown>;
+}
+/** A value that is either static T or resolved per-request via a function. */
+export type Dynamic<T> = T | ((ctx: ResolveContext) => T | Promise<T>);
+/** Declares what a specific provider supports in message format. */
+export interface ProviderCapabilities {
+    supportsReasoning: boolean;
+    supportsToolCalling: boolean;
+    supportsParallelToolCalls: boolean;
+    requiresAlternatingRoles: boolean;
+    rejectsEmptyAssistantContent: boolean;
+    toolCallIdPattern?: RegExp;
+}
+/** A compatibility rule that normalizes messages for a specific provider. */
+export interface CompatRule {
+    name: string;
+    providers: string[] | '*';
+    /** Preemptive: rewrite AI SDK messages before sending. Does NOT mutate persisted history. */
+    applyToPrompt?(messages: unknown[], capabilities: ProviderCapabilities): unknown[];
+    /** Reactive: fix persisted history after an API error. Return null if unfixable. */
+    fixHistory?(history: Message[], error: unknown): Message[] | null;
+    /** Patterns matched against API error messages for reactive rules. */
+    errorPatterns?: RegExp[];
+}
+/** Describes a single modification made by a compat rule. */
+export interface CompatDiffEntry {
+    index: number;
+    ruleName: string;
+    description: string;
+}
+/** Result of applying reactive compat rules: fixed history + diff describing changes. */
+export interface CompatResult {
+    history: Message[];
+    diff: CompatDiffEntry[];
+}
+/** Per-model behavior customization, applied at buildContext stage. */
+export interface ModelProfile {
+    modelPattern: string | RegExp;
+    systemPromptSuffix?: string;
+    toolOverrides?: {
+        [toolName: string]: {
+            description?: string;
+            exclude?: boolean;
+        };
+    };
+    extraPromptFragments?: PromptFragment[];
+}
+/** Pluggable model resolver. Tried in registration order; first match wins. */
+export interface ModelGateway {
+    name: string;
+    canResolve(modelString: string): boolean;
+    resolve(modelString: string): Promise<unknown>;
+}
+/** Serializable config for an OpenAI-compatible custom gateway. */
+export interface GatewayConfig {
+    name: string;
+    url: string;
+    apiKey?: string;
+}
+/**
+ * Top-level framework configuration.
+ * Merged from multiple layers (highest priority first):
+ *   1. Session-level — runtime parameters passed to agent.run()
+ *   2. Project-level — .agentforge/config.jsonc in project root
+ *   3. Global-level  — ~/.agentforge/config.jsonc in user home
+ *   4. Environment   — AGENTFORGE_CONFIG env var (inline JSON)
+ */
+export interface HarnessConfig {
+    agents?: Record<string, Partial<AgentConfig>>;
+    tools?: {
+        enabled?: string[];
+        disabled?: string[];
+    };
+    plugins?: string[];
+    session?: {
+        storage?: 'file' | 'memory';
+        path?: string;
+    };
+    modelProfiles?: ModelProfile[];
+    modelGateways?: GatewayConfig[];
+    hooks?: {
+        profile?: HookProfile;
+        disabledHooks?: string[];
+    };
+    costCap?: {
+        maxCost: number;
+        strategy: 'block' | 'warn';
+        modelPricing?: Record<string, {
+            input: number;
+            output: number;
+        }>;
+    };
+    tokenBudget?: {
+        maxContextTokens: number;
+        reservedOutputTokens: number;
+        strategy: 'compress' | 'truncate' | 'block';
+    };
+    goalEcho?: {
+        enabled: boolean;
+        echoFrequency: number;
+        progressTracking: boolean;
+    };
+    factInjection?: {
+        facts: string[] | ((ctx: PipelineContext) => string[] | Promise<string[]>);
+    };
+}
+export type SessionStatus = 'active' | 'completed' | 'suspended' | 'error';
+export interface SessionRecord {
+    sessionId: string;
+    parentSessionId?: string;
+    createdAt: string;
+    updatedAt: string;
+    status: SessionStatus;
+    model?: string;
+    tokenUsage?: TokenUsage;
+}
+export interface SessionEvent {
+    seq: number;
+    timestamp: string;
+    type: string;
+    payload: unknown;
+}
+export interface SessionStorage {
+    append(sessionId: string, event: SessionEvent): Promise<void>;
+    read(sessionId: string): AsyncIterable<SessionEvent>;
+    list(filter?: {
+        parentSessionId?: string;
+        status?: SessionStatus;
+    }): Promise<SessionRecord[]>;
+    updateMeta(sessionId: string, meta: Partial<SessionRecord>): Promise<void>;
+}
+export interface CheckpointStore<T = unknown> {
+    save(sessionId: string, data: T): Promise<void>;
+    load(sessionId: string): Promise<T | undefined>;
+    delete(sessionId: string): Promise<void>;
+    list(): Promise<string[]>;
+}
+/** Backend capable of querying persisted events for replay. */
+export interface ReplayBackend {
+    /** Return all stored events for a session, ordered by sequence number. */
+    query(sessionId: string): Promise<SessionEvent[]>;
+}
+/** Options controlling which events are replayed and how. */
+export interface ReplayOptions {
+    /** Only replay events whose type is in this list. Undefined = all types. */
+    eventTypes?: string[];
+    /** Start replaying from this sequence number (inclusive). Default: 1. */
+    fromSeq?: number;
+    /** Stop replaying at this sequence number (inclusive). Undefined = no upper bound. */
+    toSeq?: number;
+}
+export interface SessionManager {
+    start(input: string, options?: {
+        parentSessionId?: string;
+    }): Promise<SessionRecord>;
+    restore(sessionId: string): Promise<PipelineContext>;
+    suspend(sessionId: string, reason: string): Promise<void>;
+    resume(sessionId: string, input?: string): Promise<string>;
+    list(filter?: {
+        parentSessionId?: string;
+    }): Promise<SessionRecord[]>;
+}
+export interface SubAgentConfig {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+    model?: string;
+    systemPrompt?: string;
+    tools?: ToolDefinition[];
+    maxIterations?: number;
+    contextPolicy: 'isolated' | 'inherit' | 'summary-only';
+}
+export interface SubAgentResult {
+    response: string;
+    tokenUsage: TokenUsage;
+    sessionId: string;
+}
+/** Named concurrency slot with a maximum parallelism limit. */
+export interface ConcurrencySlot {
+    key: string;
+    maxConcurrent: number;
+}
+/** An entry in an ordered model fallback chain. 0 = highest priority. */
+export interface FallbackEntry {
+    model: string;
+    priority: number;
+}
+/** Status of an async task through its lifecycle. */
+export type AsyncTaskStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+/** Configuration for an async (background) sub-agent. */
+export interface AsyncTaskConfig extends SubAgentConfig {
+    concurrencySlot?: ConcurrencySlot;
+    fallbackModels?: FallbackEntry[];
+}
+/** Handle to a running or completed async sub-agent task. */
+export interface AsyncTaskHandle {
+    taskId: string;
+    status: AsyncTaskStatus;
+    result?: SubAgentResult;
+    error?: Error;
+    cancel(): void;
+    on_complete(handler: (result: SubAgentResult) => void): void;
+}
+/** Manager for async sub-agent tasks. */
+export interface TaskManager {
+    launch(config: AsyncTaskConfig, prompt: string): Promise<AsyncTaskHandle>;
+    get(taskId: string): AsyncTaskHandle | undefined;
+    cancel(taskId: string): void;
+    list(filter?: {
+        parentSessionId?: string;
+    }): AsyncTaskHandle[];
+}
+export interface EvictionStorage {
+    store(sessionId: string, key: string, content: unknown): Promise<string>;
+    retrieve(sessionId: string, reference: string): Promise<unknown>;
+}
+export interface EvictedResult {
+    preview: string;
+    reference: string;
+    evicted: true;
+}
+export interface AuthResult {
+    authenticated: boolean;
+    error?: string;
+}
+export interface AuthAdapter {
+    authenticate(request: {
+        header(name: string): string | undefined;
+    }): Promise<AuthResult>;
+}
+export { AgentForgeClient } from './client.js';
+export type { ClientOptions, AgentRunResult, SSEMessage } from './client.js';
+export { parseSSE } from './client.js';
+export interface AgentProfile {
+    name: string;
+    description?: string;
+    extends?: string;
+    plugins?: Array<(api: HarnessAPI) => PluginRegistration>;
+    tools?: Tool[];
+    config?: Partial<HarnessConfig>;
+    systemPrompt?: string;
+    model?: string;
+    maxIterations?: number;
+}
+//# 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":"AAMA,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,cAAc,GACd,aAAa,GACb,SAAS,GACT,WAAW,GACX,mBAAmB,GACnB,UAAU,GACV,cAAc,GACd,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,SAAS,GACT,WAAW,CAAC;AAEhB,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEtD,qEAAqE;AACrE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAErF,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB;AAMD,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wEAAwE;AACxE,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACzF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAMhL,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5D;AAMD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,KACX,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAEpC,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAAC;AAM9C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,yFAAyF;IACzF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mFAAmF;IACnF,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC9B,4GAA4G;IAC5G,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B;mEAC+D;IAC/D,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;CACxB;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D;iFAC6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,YAAY,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC;AAMlC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,IAAI,IAAI,CAAC;IACZ,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnE,WAAW,IAAI,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,MAAM;IACrB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,IAAI,IAAI,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC/E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1E,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC/E;AAMD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;CA0BX,CAAC;AAEX,sFAAsF;AACtF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;CA0BpB,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAMhE,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAMhG,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;AAE5F,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,WAAW,GACX,cAAc,GACd,aAAa,GACb,YAAY,GACZ,WAAW,GACX,aAAa,GACb,YAAY,GACZ,eAAe,GACf,OAAO,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACvD,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAChE,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9E,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5E,gBAAgB,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACvD,2BAA2B,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IACjG,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5E,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAMD,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC3C;AAMD,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,8EAA8E;AAC9E,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,cAAc,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAMvE,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,yBAAyB,EAAE,OAAO,CAAC;IACnC,wBAAwB,EAAE,OAAO,CAAC;IAClC,4BAA4B,EAAE,OAAO,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC1B,6FAA6F;IAC7F,aAAa,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,oBAAoB,GAAG,OAAO,EAAE,CAAC;IACnF,oFAAoF;IACpF,UAAU,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;IAClE,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,IAAI,EAAE,eAAe,EAAE,CAAC;CACzB;AAMD,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;IACpF,oBAAoB,CAAC,EAAE,cAAc,EAAE,CAAC;CACzC;AAMD,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,WAAW,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAE5D,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClE,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;KAC7C,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;KAC5E,CAAC;CACH;AAMD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9F,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAMD,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAChD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3B;AAMD,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACnD;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACrD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CACvE;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;CACxD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,qDAAqD;AACrD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE3F,yDAAyD;AACzD,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,WAAW,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,CAAC;CAC9D;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1E,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,EAAE,CAAC;CAChE;AAMD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC;CACf;AAMD,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1F;AAMD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMvC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,UAAU,KAAK,kBAAkB,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/index.js

@@ -0,0 +1,65 @@
+// @primo-ai/sdk — public type definitions
+// ---------------------------------------------------------------------------
+// Span Types
+// ---------------------------------------------------------------------------
+export const SpanType = {
+    AGENT_RUN: 'agent_run',
+    MODEL_STEP: 'model_step',
+    TOOL_CALL: 'tool_call',
+    PROCESSOR_RUN: 'processor_run',
+    // Phase 2 — harness & detailed observability
+    LLM_STREAM: 'llm.stream',
+    TOOL_EXECUTE: 'tool.execute',
+    GATE_DECISION: 'harness.gate',
+    COST_CAP_CHECK: 'harness.cost-cap',
+    TOKEN_BUDGET_CHECK: 'harness.token-budget',
+    GOAL_ECHO: 'harness.goal-echo',
+    FACT_INJECTION: 'harness.fact-injection',
+    COMPRESSION: 'harness.compression',
+    // Phase 2 — subsystem coverage
+    SESSION_LIFECYCLE: 'session.lifecycle',
+    TOOL_REGISTER: 'tool.register',
+    TOOL_LOOKUP: 'tool.lookup',
+    EVENT_DISPATCH: 'event.dispatch',
+    GATEWAY_RESOLVE: 'gateway.resolve',
+    CONTEXT_BUILD: 'context.build',
+    LOOP_ITERATION: 'loop.iteration',
+    SUB_AGENT_RUN: 'subagent.run',
+    CHECKPOINT: 'checkpoint',
+    MCP_CONNECT: 'mcp.connect',
+    MCP_TOOL_CALL: 'mcp.tool_call',
+};
+/** Standard span attribute keys for consistent observability across the framework. */
+export const SpanAttributeKeys = {
+    // Token / Cost
+    TOKENS_INPUT: 'tokens.input',
+    TOKENS_OUTPUT: 'tokens.output',
+    TOKENS_TOTAL: 'tokens.total',
+    COST_ESTIMATED: 'cost.estimated',
+    COST_CUMULATIVE: 'cost.cumulative',
+    COST_BUDGET: 'cost.budget',
+    // Model
+    MODEL_NAME: 'model.name',
+    // Tool
+    TOOL_NAME: 'tool.name',
+    TOOL_RESULT_SIZE: 'tool.result_size',
+    // Harness gates
+    HARNESS_DECISION: 'harness.decision',
+    HARNESS_REASON: 'harness.reason',
+    // Budget
+    BUDGET_CONTEXT_MAX: 'budget.context_max',
+    BUDGET_CONTEXT_USED: 'budget.context_used',
+    BUDGET_RESERVED_OUTPUT: 'budget.reserved_output',
+    // Goal echo
+    GOAL_TEXT: 'goal.text',
+    GOAL_PROGRESS: 'goal.progress',
+    GOAL_ITERATION: 'goal.iteration',
+    // Fact injection
+    FACT_COUNT: 'fact.count',
+};
+// ---------------------------------------------------------------------------
+// Client SDK
+// ---------------------------------------------------------------------------
+export { AgentForgeClient } from './client.js';
+export { parseSSE } from './client.js';
+//# 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,0CAA0C;AAkR1C,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,eAAe;IAC9B,6CAA6C;IAC7C,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,kBAAkB;IAClC,kBAAkB,EAAE,sBAAsB;IAC1C,SAAS,EAAE,mBAAmB;IAC9B,cAAc,EAAE,wBAAwB;IACxC,WAAW,EAAE,qBAAqB;IAClC,+BAA+B;IAC/B,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,cAAc;IAC7B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;CACtB,CAAC;AAEX,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,eAAe;IACf,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,QAAQ;IACR,UAAU,EAAE,YAAY;IACxB,OAAO;IACP,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB;IAChB,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,SAAS;IACT,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,sBAAsB,EAAE,wBAAwB;IAChD,YAAY;IACZ,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,iBAAiB;IACjB,UAAU,EAAE,YAAY;CAChB,CAAC;AAsbX,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@primo-ai/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "tsc --noEmit && vitest run",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint src __tests__"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}