@trenchwork/coder 1.3.0

package/dist/contracts/schemas/tool-selection.schema.json

@@ -0,0 +1,174 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Tool Selection Contract v1.0",
+  "description": "Schema describing toggleable tool suites and presets exposed to an agent runtime.",
+  "type": "object",
+  "required": ["contractVersion", "profile", "version", "options"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "description": "Version of the tool selection contract implemented by the payload."
+    },
+    "profile": {
+      "type": "string",
+      "description": "Agent profile identifier that the tool selection applies to."
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic or date-based version for the manifest."
+    },
+    "label": {
+      "type": "string",
+      "description": "Optional human readable label for the manifest."
+    },
+    "description": {
+      "type": "string",
+      "description": "Optional longer description."
+    },
+    "options": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/definitions/ToolOption"
+      },
+      "description": "Toggleable tool suites."
+    },
+    "presets": {
+      "type": "array",
+      "description": "Optional named sets of enabled/disabled tools.",
+      "items": {
+        "$ref": "#/definitions/ToolPreset"
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Implementation specific metadata."
+    }
+  },
+  "definitions": {
+    "ToolOption": {
+      "type": "object",
+      "required": ["id", "label", "description", "defaultEnabled", "pluginIds"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier for the tool option."
+        },
+        "label": {
+          "type": "string",
+          "description": "Human readable name."
+        },
+        "description": {
+          "type": "string",
+          "description": "Operator facing description."
+        },
+        "category": {
+          "type": "string",
+          "description": "Optional grouping/category label."
+        },
+        "defaultEnabled": {
+          "type": "boolean",
+          "description": "Whether the tool is enabled by default."
+        },
+        "pluginIds": {
+          "type": "array",
+          "minItems": 1,
+          "description": "IDs of the tool plugins activated by this option.",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "requiresSecret": {
+          "type": "string",
+          "description": "Identifier of a secret that must be configured before the tool can load."
+        },
+        "scopes": {
+          "type": "array",
+          "description": "Capabilities unlocked when this option is enabled.",
+          "items": {
+            "type": "string",
+            "enum": [
+              "filesystem:read",
+              "filesystem:write",
+              "process:exec",
+              "network:web",
+              "network:api",
+              "analysis:code",
+              "analysis:quality",
+              "analysis:dependency",
+              "analysis:testing",
+              "analysis:security",
+              "planning:refactor",
+              "external:web-search"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Implementation specific metadata."
+        }
+      }
+    },
+    "ToolPreset": {
+      "type": "object",
+      "required": ["id", "label"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier for the preset."
+        },
+        "label": {
+          "type": "string",
+          "description": "Human readable name for the preset."
+        },
+        "description": {
+          "type": "string",
+          "description": "Longer description or guidance."
+        },
+        "enabled": {
+          "type": "array",
+          "description": "Tool option IDs forced on by the preset.",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "disabled": {
+          "type": "array",
+          "description": "Tool option IDs forced off by the preset.",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "locked": {
+          "type": "array",
+          "description": "Tool option IDs that cannot be toggled while the preset is active.",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "appliesTo": {
+          "type": "array",
+          "description": "Frontends where this preset should be available.",
+          "items": {
+            "type": "string",
+            "enum": ["cli", "browser", "http", "worker", "service"]
+          },
+          "uniqueItems": true
+        },
+        "notes": {
+          "type": "string",
+          "description": "Optional operator note rendered with the preset."
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Implementation specific metadata."
+        }
+      }
+    }
+  }
+}

package/dist/contracts/tools.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "./schemas/tool-selection.schema.json",
+  "contractVersion": "1.0.0",
+  "profile": "agi-cli",
+  "version": "2024.12.04",
+  "label": "AGI CLI unified tool manifest",
+  "description": "Core toolset with filesystem, editing, search, and execution.",
+  "options": [
+    {
+      "id": "core-tools",
+      "label": "Core Tools",
+      "description": "Filesystem, editing, unified search, and execution.",
+      "defaultEnabled": true,
+      "category": "core",
+    "pluginIds": [
+      "tool.filesystem.local",
+      "tool.edit",
+      "tool.search.local",
+      "tool.bash.local",
+      "tool.enhanced-git",
+      "tool.orchestration.unified",
+      "tool.bidirectional-audit"
+    ],
+      "metadata": {
+        "locked": true
+      }
+    },
+    {
+      "id": "dependency-management-tools",
+      "label": "Dependency Management Tools",
+      "description": "Automatic dependency recovery, npm install on failure, and continuous operation capabilities.",
+      "defaultEnabled": true,
+      "category": "operations",
+      "pluginIds": [
+        "tool.dependency-management"
+      ],
+      "metadata": {
+        "locked": true
+      }
+    }
+  ]
+}

package/dist/contracts/unified-schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "./schemas/unified-schema.schema.json",
+  "contractVersion": "2.0.0",
+  "version": "2024-11-25",
+  "label": "Trenchwork CLI Unified Schema",
+  "description": "Comprehensive schema for AI tasks, providers, and tools - single source of truth",
+
+  "providers": [
+    {
+      "id": "deepseek",
+      "label": "DeepSeek",
+      "description": "DeepSeek reasoning and coding models on max thought",
+      "baseUrl": "https://api.deepseek.com",
+      "envVars": {
+        "apiKey": "DEEPSEEK_API_KEY"
+      },
+      "capabilities": ["chat", "reasoning", "tools", "streaming"],
+      "openaiCompatible": true,
+      "models": ["deepseek-v4-pro", "deepseek-chat"],
+      "defaultModel": "deepseek-v4-pro",
+      "status": "production"
+    }
+  ],
+
+  "defaults": {
+    "provider": "deepseek",
+    "model": "deepseek-v4-pro",
+    "temperature": 0.0,
+    "maxTokens": 32768,
+    "taskType": "coding"
+  },
+
+  "metadata": {
+    "schemaVersion": "2.0.0",
+    "lastUpdated": "2024-11-25",
+    "author": "Bo Shang",
+    "framework": "trenchwork-cli",
+    "description": "Unified schema for DeepSeek-powered AI tasks"
+  }
+}

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

@@ -0,0 +1,225 @@
+/**
+ * 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' | 'context.compacted' | 'subagent.start' | 'subagent.complete' | 'adversarial.findings';
+/**
+ * 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;
+    parameters?: Record<string, unknown>;
+}
+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;
+}
+/**
+ * Emitted when the context manager auto-compacts the conversation to stay
+ * within the model's window — surfaced to the user as a dim transcript note.
+ */
+export interface ContextCompactedEvent extends AgentEvent {
+    type: 'context.compacted';
+    /** messages removed / summarized */
+    removed: number;
+    /** approximate tokens freed (estimate before − after) */
+    freedTokens: number;
+    /** true if LLM summarization was used; false for a simple prune */
+    summarized: boolean;
+    /** resulting context-usage percentage after compaction */
+    percentage: number;
+}
+/**
+ * Emitted when a parallel sub-agent (Task) spawns / finishes — surfaced live
+ * like Claude Code's Task tool so the parallel fan-out is visible.
+ */
+export interface SubAgentStartEvent extends AgentEvent {
+    type: 'subagent.start';
+    id: string;
+    /** short label for the sub-task */
+    description: string;
+}
+export interface SubAgentCompleteEvent extends AgentEvent {
+    type: 'subagent.complete';
+    id: string;
+    description: string;
+    success: boolean;
+    elapsedMs: number;
+}
+/**
+ * Emitted when the always-on adversarial reviewer refutes a finished draft —
+ * the shell turns this into a bounded auto-correction (re-run the agent to fix
+ * the findings) rather than just appending an advisory caveat.
+ */
+export interface AdversarialFindingsEvent extends AgentEvent {
+    type: 'adversarial.findings';
+    findings: string;
+}
+/**
+ * Union of all event types
+ */
+export type AgentEventUnion = MessageStartEvent | MessageDeltaEvent | MessageCompleteEvent | ToolStartEvent | ToolCompleteEvent | ToolErrorEvent | EditExplanationEvent | ReasoningEvent | ErrorEvent | UsageEvent | ProviderFallbackEvent | ContextCompactedEvent | SubAgentStartEvent | SubAgentCompleteEvent | AdversarialFindingsEvent;
+/**
+ * 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;
+    /**
+     * Restore a prior conversation into context (session resume)
+     */
+    loadHistory(history: ConversationMessage[]): 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":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,kBAAkB,GAClB,WAAW,GACX,OAAO,GACP,OAAO,GACP,mBAAmB,GACnB,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IAGf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,UAAU;IAC1D,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,iBAAiB,GACjB,oBAAoB,GACpB,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,oBAAoB,GACpB,cAAc,GACd,UAAU,GACV,UAAU,GACV,qBAAqB,GACrB,qBAAqB,GACrB,kBAAkB,GAClB,qBAAqB,GACrB,wBAAwB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAE9D;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,eAAe,IAAI,kBAAkB,CAAC;IAEtC;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,UAAU,IAAI,mBAAmB,EAAE,CAAC;IAEpC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

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"}