@trenchwork/erosolar 1.1.30 → 1.1.32

package/dist/config.js

@@ -0,0 +1,155 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { registerAgentProfile, hasAgentProfile, getAgentProfile, } from './core/agentProfiles.js';
+import { buildAgentRulebookPrompt, loadAgentRulebook } from './core/agentRulebook.js';
+import { getAgentProfileManifest } from './core/agentProfileManifest.js';
+import { inferProviderFromModelId } from './core/modelDiscovery.js';
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const PROFILE_MANIFEST = getAgentProfileManifest();
+const DEFAULT_PROFILES = PROFILE_MANIFEST.profiles.map((entry) => normalizeProfileFromManifest(entry, PROFILE_MANIFEST, PACKAGE_ROOT));
+for (const profile of DEFAULT_PROFILES) {
+    if (!hasAgentProfile(profile.name)) {
+        registerAgentProfile(profile);
+    }
+}
+export function resolveProfileConfig(profile, workspaceContext) {
+    const blueprint = getAgentProfile(profile);
+    const envPrefix = toEnvPrefix(blueprint.name);
+    const modelEnv = process.env[`${envPrefix}_MODEL`];
+    const modelLocked = typeof modelEnv === 'string' && modelEnv.trim().length > 0;
+    const model = modelLocked ? modelEnv.trim() : blueprint.defaultModel;
+    const inferredProvider = inferProviderFromModelId(model);
+    const systemPrompt = process.env[`${envPrefix}_SYSTEM_PROMPT`] ?? blueprint.defaultSystemPrompt;
+    const providerEnv = process.env[`${envPrefix}_PROVIDER`];
+    const providerCandidate = isProviderValue(providerEnv) ? providerEnv.trim() : null;
+    const providerLocked = Boolean(providerCandidate) && (!inferredProvider || providerCandidate === inferredProvider);
+    const provider = (() => {
+        if (providerCandidate && inferredProvider && providerCandidate !== inferredProvider) {
+            // Prefer the model-aligned provider over a mismatched env override
+            return inferredProvider;
+        }
+        if (providerCandidate) {
+            return providerCandidate;
+        }
+        if (inferredProvider) {
+            return inferredProvider;
+        }
+        return blueprint.defaultProvider;
+    })();
+    const rulebook = loadRulebookMetadata(blueprint);
+    const contextBlock = workspaceContext?.trim()
+        ? `\n\nWorkspace context (auto-detected):\n${workspaceContext.trim()}`
+        : '';
+    const resolved = {
+        profile,
+        label: blueprint.label,
+        provider,
+        model,
+        systemPrompt: `${systemPrompt.trim()}${contextBlock}`,
+        modelLocked,
+        providerLocked,
+        rulebook,
+    };
+    if (typeof blueprint.temperature === 'number') {
+        resolved.temperature = blueprint.temperature;
+    }
+    if (typeof blueprint.maxTokens === 'number') {
+        resolved.maxTokens = blueprint.maxTokens;
+    }
+    return resolved;
+}
+function toEnvPrefix(profile) {
+    return profile
+        .trim()
+        .toUpperCase()
+        .replace(/[^A-Z0-9]/g, '_');
+}
+function isProviderValue(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function loadRulebookMetadata(profile) {
+    try {
+        // Check if rulebook is inline
+        const rulebookRef = profile.rulebook; // eslint-disable-line @typescript-eslint/no-explicit-any
+        const manifest = rulebookRef.inline
+            ? loadAgentRulebook(profile.name, { inline: rulebookRef.inline })
+            : loadAgentRulebook(profile.name, {
+                root: PACKAGE_ROOT,
+                file: rulebookRef.file,
+            });
+        return {
+            profile: manifest.profile,
+            label: manifest.label ?? manifest.profile,
+            version: manifest.version,
+            contractVersion: manifest.contractVersion,
+            description: manifest.description ?? profile.rulebook.description,
+            file: rulebookRef.file ?? '[inline]',
+        };
+    }
+    catch {
+        if (!profile.rulebook) {
+            return null;
+        }
+        const rulebookRef = profile.rulebook; // eslint-disable-line @typescript-eslint/no-explicit-any
+        const fallback = {
+            profile: profile.name,
+            label: profile.label,
+            version: rulebookRef.version ?? 'unknown',
+            contractVersion: rulebookRef.contractVersion ?? 'unknown',
+            description: rulebookRef.description,
+            file: rulebookRef.file ?? '[inline]',
+        };
+        return fallback;
+    }
+}
+function normalizeProfileFromManifest(entry, manifest, root) {
+    const defaultSystemPrompt = buildDefaultSystemPrompt(entry, root);
+    return {
+        name: entry.name,
+        label: entry.label,
+        description: entry.description,
+        defaultProvider: entry.defaultProvider,
+        defaultModel: entry.defaultModel,
+        systemPromptConfig: entry.systemPrompt,
+        defaultSystemPrompt,
+        temperature: entry.temperature,
+        maxTokens: entry.maxTokens,
+        rulebook: entry.rulebook,
+        manifestVersion: manifest.version,
+        manifestContractVersion: manifest.contractVersion,
+    };
+}
+function buildDefaultSystemPrompt(entry, root) {
+    try {
+        const promptConfig = entry.systemPrompt;
+        if (promptConfig.type === 'literal') {
+            return promptConfig.content.trim();
+        }
+        const template = promptConfig.template?.trim() || '{{rulebook}}';
+        // Check if rulebook is inline
+        const rulebookRef = entry.rulebook; // eslint-disable-line @typescript-eslint/no-explicit-any
+        const rulebookPrompt = rulebookRef.inline
+            ? buildAgentRulebookPrompt(entry.name, { inline: rulebookRef.inline }).trim()
+            : buildAgentRulebookPrompt(entry.name, { root, file: rulebookRef.file }).trim();
+        const replacements = {
+            rulebook: rulebookPrompt,
+            profile: entry.label || entry.name,
+            profile_name: entry.name,
+        };
+        const rendered = template.replace(/\{\{\s*(rulebook|profile|profile_name)\s*\}\}/gi, (_match, token) => {
+            const key = token.toLowerCase();
+            return replacements[key] ?? '';
+        });
+        if (/\{\{\s*rulebook\s*\}\}/i.test(template)) {
+            return rendered.trim();
+        }
+        const merged = rendered.trim();
+        const suffix = merged ? `\n\n${rulebookPrompt}` : rulebookPrompt;
+        return `${merged}${suffix}`.trim();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to build system prompt for profile "${entry.name}": ${message}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/contracts/v1/agent.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Agent Contract v1.0
+ *
+ * Stable interface for agent interaction across all frontends.
+ * Breaking changes require a new version (v2/).
+ */
+export declare const AGENT_CONTRACT_VERSION = "1.0.0";
+/**
+ * Event types emitted during agent execution
+ */
+export type AgentEventType = 'message.start' | 'message.delta' | 'message.complete' | 'tool.start' | 'tool.complete' | 'tool.error' | 'edit.explanation' | 'reasoning' | 'error' | 'usage' | 'provider.fallback';
+/**
+ * Base event structure
+ */
+export interface AgentEvent {
+    type: AgentEventType;
+    timestamp: number;
+}
+/**
+ * Message events
+ */
+export interface MessageStartEvent extends AgentEvent {
+    type: 'message.start';
+}
+export interface MessageDeltaEvent extends AgentEvent {
+    type: 'message.delta';
+    content: string;
+    isFinal: boolean;
+}
+export interface MessageCompleteEvent extends AgentEvent {
+    type: 'message.complete';
+    content: string;
+    elapsedMs: number;
+}
+/**
+ * Tool execution events
+ */
+export interface ToolStartEvent extends AgentEvent {
+    type: 'tool.start';
+    toolName: string;
+    toolCallId: string;
+    parameters: Record<string, unknown>;
+}
+export interface ToolCompleteEvent extends AgentEvent {
+    type: 'tool.complete';
+    toolName: string;
+    toolCallId: string;
+    result: string;
+}
+export interface ToolErrorEvent extends AgentEvent {
+    type: 'tool.error';
+    toolName: string;
+    toolCallId: string;
+    error: string;
+}
+export interface EditExplanationEvent extends AgentEvent {
+    type: 'edit.explanation';
+    content: string;
+    files?: string[];
+    toolName?: string;
+    toolCallId?: string;
+}
+/**
+ * Reasoning/thought event - model's internal thinking process
+ */
+export interface ReasoningEvent extends AgentEvent {
+    type: 'reasoning';
+    content: string;
+}
+/**
+ * Error and usage events
+ */
+export interface ErrorEvent extends AgentEvent {
+    type: 'error';
+    error: string;
+    code?: string;
+}
+export interface UsageEvent extends AgentEvent {
+    type: 'usage';
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+/**
+ * Provider fallback event - emitted when switching to another provider due to error
+ */
+export interface ProviderFallbackEvent extends AgentEvent {
+    type: 'provider.fallback';
+    /** Provider that failed */
+    fromProvider: string;
+    /** Model that failed */
+    fromModel: string;
+    /** Provider being switched to */
+    toProvider: string;
+    /** Model being switched to */
+    toModel: string;
+    /** Reason for fallback */
+    reason: string;
+    /** Original error message */
+    error: string;
+}
+/**
+ * Union of all event types
+ */
+export type AgentEventUnion = MessageStartEvent | MessageDeltaEvent | MessageCompleteEvent | ToolStartEvent | ToolCompleteEvent | ToolErrorEvent | EditExplanationEvent | ReasoningEvent | ErrorEvent | UsageEvent | ProviderFallbackEvent;
+/**
+ * Model selection configuration
+ */
+export interface ModelConfig {
+    provider: string;
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+/**
+ * Capability manifest
+ */
+export interface CapabilityManifest {
+    contractVersion: string;
+    profile: string;
+    model: ModelConfig;
+    tools: ToolCapability[];
+    features: string[];
+}
+export interface ToolCapability {
+    name: string;
+    description: string;
+    category: string;
+}
+/**
+ * Core agent controller interface
+ *
+ * This is the stable contract that all frontends depend on.
+ */
+export interface IAgentController {
+    /**
+     * Send a message and receive streaming events
+     */
+    send(message: string): AsyncIterableIterator<AgentEventUnion>;
+    /**
+     * Switch the active model
+     */
+    switchModel(config: ModelConfig): Promise<void>;
+    /**
+     * Get current capabilities
+     */
+    getCapabilities(): CapabilityManifest;
+    /**
+     * Register a tool suite
+     */
+    registerToolSuite(suiteId: string, suite: unknown): void;
+    /**
+     * Unregister a tool suite
+     */
+    unregisterToolSuite(suiteId: string): void;
+    /**
+     * Get conversation history
+     */
+    getHistory(): ConversationMessage[];
+    /**
+     * Clear conversation history
+     */
+    clearHistory(): void;
+}
+/**
+ * Conversation message structure
+ */
+export interface ConversationMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    toolCallId?: string;
+    name?: string;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/contracts/v1/agent.d.ts.map

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

package/dist/contracts/v1/agent.js

@@ -0,0 +1,8 @@
+/**
+ * Agent Contract v1.0
+ *
+ * Stable interface for agent interaction across all frontends.
+ * Breaking changes require a new version (v2/).
+ */
+export const AGENT_CONTRACT_VERSION = '1.0.0';
+//# sourceMappingURL=agent.js.map

package/dist/contracts/v1/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/contracts/v1/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC"}

package/dist/contracts/v1/agentProfileManifest.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Agent Profile Manifest Contract v1.0
+ *
+ * Canonical description of agent profiles, their default model/provider
+ * configuration, and how system prompts are sourced. The manifest is meant
+ * to be JSON schema backed so other runtimes can load the same defaults.
+ */
+import type { ProviderId } from '../../core/types.js';
+export declare const AGENT_PROFILE_MANIFEST_VERSION = "1.0.0";
+export interface AgentProfileManifest {
+    contractVersion: string;
+    version: string;
+    label?: string;
+    description?: string;
+    profiles: AgentProfileEntry[];
+    metadata?: Record<string, unknown>;
+}
+export interface AgentProfileEntry {
+    name: string;
+    label: string;
+    description?: string;
+    defaultProvider: ProviderId;
+    defaultModel: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt: AgentPromptConfig;
+    rulebook: AgentRulebookReference;
+    metadata?: Record<string, unknown>;
+}
+export type AgentPromptConfig = RulebookPromptConfig | LiteralPromptConfig;
+export interface RulebookPromptConfig {
+    type: 'rulebook';
+    /**
+     * Optional template supporting {{rulebook}}, {{profile}}, and {{profile_name}}
+     * placeholders. Defaults to "{{rulebook}}" when omitted.
+     */
+    template?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface LiteralPromptConfig {
+    type: 'literal';
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export type AgentRulebookReference = AgentRulebookFileReference | AgentRulebookInlineReference;
+export interface AgentRulebookFileReference {
+    file: string;
+    version?: string;
+    contractVersion?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentRulebookInlineReference {
+    inline: import('../v1/agentRules.js').AgentRulesetManifest;
+    version?: string;
+    contractVersion?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=agentProfileManifest.d.ts.map

package/dist/contracts/v1/agentProfileManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentProfileManifest.d.ts","sourceRoot":"","sources":["../../../src/contracts/v1/agentProfileManifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,eAAO,MAAM,8BAA8B,UAAU,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,UAAU,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,iBAAiB,CAAC;IAChC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,sBAAsB,GAC9B,0BAA0B,GAC1B,4BAA4B,CAAC;AAEjC,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,OAAO,qBAAqB,EAAE,oBAAoB,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/contracts/v1/agentProfileManifest.js

@@ -0,0 +1,9 @@
+/**
+ * Agent Profile Manifest Contract v1.0
+ *
+ * Canonical description of agent profiles, their default model/provider
+ * configuration, and how system prompts are sourced. The manifest is meant
+ * to be JSON schema backed so other runtimes can load the same defaults.
+ */
+export const AGENT_PROFILE_MANIFEST_VERSION = '1.0.0';
+//# sourceMappingURL=agentProfileManifest.js.map

package/dist/contracts/v1/agentProfileManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentProfileManifest.js","sourceRoot":"","sources":["../../../src/contracts/v1/agentProfileManifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC"}

package/dist/contracts/v1/agentRules.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Agent Rules Contract v1.0
+ *
+ * Describes the structured rule set that governs how the agent moves through
+ * phases, steps, and sub-steps during a task. Each step enumerates explicit
+ * rules so downstream runtimes can render or validate the workflow without
+ * relying on bespoke prompt text.
+ */
+export declare const AGENT_RULES_CONTRACT_VERSION = "1.0.0";
+export type AgentRuleSeverity = 'critical' | 'required' | 'recommended';
+export interface AgentRuleReference {
+    label: string;
+    url?: string;
+    file?: string;
+    line?: number;
+}
+export interface AgentRuleDefinition {
+    id: string;
+    summary: string;
+    detail?: string;
+    severity: AgentRuleSeverity;
+    appliesDuring?: string[];
+    evidenceRequired?: string;
+    references?: AgentRuleReference[];
+    toolHints?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface AgentStepRule {
+    id: string;
+    title: string;
+    description?: string;
+    intent?: string;
+    entryCriteria?: string[];
+    exitCriteria?: string[];
+    allowedTools?: string[];
+    blockedTools?: string[];
+    notes?: string[];
+    rules: AgentRuleDefinition[];
+    subSteps?: AgentStepRule[];
+    metadata?: Record<string, unknown>;
+}
+export interface AgentRulePhase {
+    id: string;
+    label: string;
+    description?: string;
+    trigger?: string;
+    steps: AgentStepRule[];
+    metadata?: Record<string, unknown>;
+}
+export interface AgentRulesetManifest {
+    contractVersion: string;
+    profile: string;
+    version: string;
+    label?: string;
+    description?: string;
+    globalPrinciples?: AgentRuleDefinition[];
+    phases: AgentRulePhase[];
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=agentRules.d.ts.map

package/dist/contracts/v1/agentRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRules.d.ts","sourceRoot":"","sources":["../../../src/contracts/v1/agentRules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACzC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/contracts/v1/agentRules.js

@@ -0,0 +1,10 @@
+/**
+ * Agent Rules Contract v1.0
+ *
+ * Describes the structured rule set that governs how the agent moves through
+ * phases, steps, and sub-steps during a task. Each step enumerates explicit
+ * rules so downstream runtimes can render or validate the workflow without
+ * relying on bespoke prompt text.
+ */
+export const AGENT_RULES_CONTRACT_VERSION = '1.0.0';
+//# sourceMappingURL=agentRules.js.map

package/dist/contracts/v1/agentRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRules.js","sourceRoot":"","sources":["../../../src/contracts/v1/agentRules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC"}

package/dist/contracts/v1/provider.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Provider Contract v1.0
+ *
+ * Stable interface for LLM provider integration.
+ */
+export declare const PROVIDER_CONTRACT_VERSION = "1.0.0";
+/**
+ * Provider configuration
+ */
+export interface ProviderConfig {
+    provider: string;
+    model: string;
+    apiKey?: string;
+    baseURL?: string;
+    temperature?: number;
+    maxTokens?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Conversation message structure
+ */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface BaseMessage {
+    role: MessageRole;
+    content: string;
+}
+export interface SystemMessage extends BaseMessage {
+    role: 'system';
+}
+export interface UserMessage extends BaseMessage {
+    role: 'user';
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface AssistantMessage extends BaseMessage {
+    role: 'assistant';
+    toolCalls?: ToolCall[];
+}
+export interface ToolMessage extends BaseMessage {
+    role: 'tool';
+    name: string;
+    toolCallId: string;
+}
+export type Message = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
+/**
+ * Tool definition for providers
+ */
+export interface ProviderToolDefinition {
+    name: string;
+    description: string;
+    parameters?: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+}
+/**
+ * Provider response types
+ */
+export interface ProviderUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+export interface ProviderMessageResponse {
+    type: 'message';
+    content: string;
+    usage?: ProviderUsage | null;
+}
+export interface ProviderToolCallsResponse {
+    type: 'tool_calls';
+    toolCalls: ToolCall[];
+    content?: string;
+    usage?: ProviderUsage | null;
+}
+export type ProviderResponse = ProviderMessageResponse | ProviderToolCallsResponse;
+/**
+ * Streaming response
+ */
+export interface StreamChunk {
+    type: 'content' | 'reasoning' | 'tool_call' | 'usage' | 'done';
+    content?: string;
+    toolCall?: Partial<ToolCall>;
+    usage?: ProviderUsage;
+}
+/**
+ * Provider interface
+ */
+export interface ILLMProvider {
+    readonly id: string;
+    readonly model: string;
+    /**
+     * Generate a completion (non-streaming)
+     */
+    generate(messages: Message[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    /**
+     * Generate a streaming completion
+     */
+    generateStream?(messages: Message[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    /**
+     * Get provider capabilities
+     */
+    getCapabilities(): ProviderCapabilities;
+}
+/**
+ * Provider capabilities
+ */
+export interface ProviderCapabilities {
+    streaming: boolean;
+    toolCalling: boolean;
+    vision: boolean;
+    functionCalling: boolean;
+    maxTokens: number;
+    supportedModalities: ('text' | 'image' | 'audio')[];
+}
+/**
+ * Provider factory
+ */
+export type ProviderFactory = (config: ProviderConfig) => ILLMProvider;
+/**
+ * Provider registry interface
+ */
+export interface IProviderRegistry {
+    /**
+     * Register a provider factory
+     */
+    register(providerId: string, factory: ProviderFactory): void;
+    /**
+     * Unregister a provider
+     */
+    unregister(providerId: string): void;
+    /**
+     * Create a provider instance
+     */
+    create(config: ProviderConfig): ILLMProvider;
+    /**
+     * Check if provider is registered
+     */
+    has(providerId: string): boolean;
+    /**
+     * List all registered providers
+     */
+    list(): string[];
+}
+//# sourceMappingURL=provider.d.ts.map