@contractspec/lib.ai-agent 1.56.1 → 1.58.0

package/dist/interop/types.d.ts

@@ -1,262 +1,263 @@
-import { AgentSpec, AgentToolConfig } from "../spec/spec.js";
-import { ToolHandler } from "../types.js";
-
-//#region src/interop/types.d.ts
-
+/**
+ * Types for the interop layer.
+ *
+ * The interop layer enables bidirectional integration between
+ * ContractSpec and external agent SDKs.
+ */
+import type { AgentSpec, AgentToolConfig } from '../spec/spec';
+import type { ToolHandler } from '../types';
 /**
  * Configuration for a spec consumer.
  */
-interface SpecConsumerConfig {
-  /** Specs to consume */
-  specs: AgentSpec[];
-  /** Whether to include metadata in outputs */
-  includeMetadata?: boolean;
-  /** Base URL for linking */
-  baseUrl?: string;
+export interface SpecConsumerConfig {
+    /** Specs to consume */
+    specs: AgentSpec[];
+    /** Whether to include metadata in outputs */
+    includeMetadata?: boolean;
+    /** Base URL for linking */
+    baseUrl?: string;
 }
 /**
  * Options for markdown generation.
  */
-interface SpecMarkdownOptions {
-  /** Include table of contents */
-  includeToc?: boolean;
-  /** Include examples */
-  includeExamples?: boolean;
-  /** Include tools section */
-  includeTools?: boolean;
-  /** Include constraints section */
-  includeConstraints?: boolean;
-  /** Custom header */
-  customHeader?: string;
+export interface SpecMarkdownOptions {
+    /** Include table of contents */
+    includeToc?: boolean;
+    /** Include examples */
+    includeExamples?: boolean;
+    /** Include tools section */
+    includeTools?: boolean;
+    /** Include constraints section */
+    includeConstraints?: boolean;
+    /** Custom header */
+    customHeader?: string;
 }
 /**
  * Options for prompt generation.
  */
-interface SpecPromptOptions {
-  /** Include tools in prompt */
-  includeTools?: boolean;
-  /** Include examples in prompt */
-  includeExamples?: boolean;
-  /** Include constraints in prompt */
-  includeConstraints?: boolean;
-  /** Output format */
-  format?: 'structured' | 'natural';
-  /** Custom context to append */
-  customContext?: string;
+export interface SpecPromptOptions {
+    /** Include tools in prompt */
+    includeTools?: boolean;
+    /** Include examples in prompt */
+    includeExamples?: boolean;
+    /** Include constraints in prompt */
+    includeConstraints?: boolean;
+    /** Output format */
+    format?: 'structured' | 'natural';
+    /** Custom context to append */
+    customContext?: string;
 }
 /**
  * Result from querying a spec.
  */
-interface SpecQueryResult {
-  /** Spec key */
-  key: string;
-  /** The spec itself */
-  spec: AgentSpec;
-  /** Markdown representation */
-  markdown: string;
-  /** Prompt representation */
-  prompt: string;
+export interface SpecQueryResult {
+    /** Spec key */
+    key: string;
+    /** The spec itself */
+    spec: AgentSpec;
+    /** Markdown representation */
+    markdown: string;
+    /** Prompt representation */
+    prompt: string;
 }
 /**
  * Options for listing specs.
  */
-interface SpecListOptions {
-  /** Filter by stability */
-  stability?: string;
-  /** Filter by tags */
-  tags?: string[];
+export interface SpecListOptions {
+    /** Filter by stability */
+    stability?: string;
+    /** Filter by tags */
+    tags?: string[];
 }
 /**
  * Result from listing specs.
  */
-interface SpecListResult {
-  /** Spec key */
-  key: string;
-  /** Spec name (from meta.name or meta.key) */
-  name: string;
-  /** Spec version */
-  version: string;
-  /** Description */
-  description?: string;
-  /** Stability */
-  stability?: string;
-  /** Tags */
-  tags?: string[];
-  /** Number of tools */
-  toolCount: number;
+export interface SpecListResult {
+    /** Spec key */
+    key: string;
+    /** Spec name (from meta.name or meta.key) */
+    name: string;
+    /** Spec version */
+    version: string;
+    /** Description */
+    description?: string;
+    /** Stability */
+    stability?: string;
+    /** Tags */
+    tags?: string[];
+    /** Number of tools */
+    toolCount: number;
 }
 /**
  * Interface for spec consumers.
  */
-interface SpecConsumer {
-  getSpecMarkdown(specKey: string, options?: SpecMarkdownOptions): string;
-  getSpecPrompt(specKey: string, options?: SpecPromptOptions): string;
-  listSpecs(options?: SpecListOptions): SpecListResult[];
-  querySpec(specKey: string): SpecQueryResult | undefined;
-  hasSpec(specKey: string): boolean;
-  getSpec(specKey: string): AgentSpec | undefined;
-  getAllSpecs(): AgentSpec[];
-  getSpecCount(): number;
-  addSpec(spec: AgentSpec): void;
-  removeSpec(specKey: string): boolean;
+export interface SpecConsumer {
+    getSpecMarkdown(specKey: string, options?: SpecMarkdownOptions): string;
+    getSpecPrompt(specKey: string, options?: SpecPromptOptions): string;
+    listSpecs(options?: SpecListOptions): SpecListResult[];
+    querySpec(specKey: string): SpecQueryResult | undefined;
+    hasSpec(specKey: string): boolean;
+    getSpec(specKey: string): AgentSpec | undefined;
+    getAllSpecs(): AgentSpec[];
+    getSpecCount(): number;
+    addSpec(spec: AgentSpec): void;
+    removeSpec(specKey: string): boolean;
 }
 /**
  * Configuration for a tool consumer.
  */
-interface ToolConsumerConfig {
-  /** Tools with optional handlers */
-  tools: {
-    config: AgentToolConfig;
-    handler?: ToolHandler;
-  }[];
+export interface ToolConsumerConfig {
+    /** Tools with optional handlers */
+    tools: {
+        config: AgentToolConfig;
+        handler?: ToolHandler;
+    }[];
 }
 /**
  * Configuration for a tool server.
  */
-interface ToolServerConfig {
-  /** Tools with optional handlers */
-  tools: {
-    config: AgentToolConfig;
-    handler?: ToolHandler;
-  }[];
-  /** Server name */
-  name?: string;
-  /** Server version */
-  version?: string;
-  /** Port to run on */
-  port?: number;
+export interface ToolServerConfig {
+    /** Tools with optional handlers */
+    tools: {
+        config: AgentToolConfig;
+        handler?: ToolHandler;
+    }[];
+    /** Server name */
+    name?: string;
+    /** Server version */
+    version?: string;
+    /** Port to run on */
+    port?: number;
 }
 /**
  * Interface for tool servers.
  */
-interface ToolServer {
-  start(): Promise<void>;
-  stop(): Promise<void>;
-  isRunning(): boolean;
-  getTools(): AgentToolConfig[];
+export interface ToolServer {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getTools(): AgentToolConfig[];
 }
 /**
  * Format for tool export.
  */
-type ToolExportFormat = 'claude-agent' | 'opencode' | 'mcp' | 'openai';
+export type ToolExportFormat = 'claude-agent' | 'opencode' | 'mcp' | 'openai';
 /**
  * Interface for tool consumers.
  */
-interface ToolConsumer {
-  createToolServer(config?: Partial<ToolServerConfig>): ToolServer;
-  exportToolsForSDK(format: ToolExportFormat): unknown[];
-  getTools(): AgentToolConfig[];
-  getTool(name: string): AgentToolConfig | undefined;
-  hasTool(name: string): boolean;
-  addTool(config: AgentToolConfig, handler?: ToolHandler): void;
-  removeTool(name: string): boolean;
-  getToolCount(): number;
+export interface ToolConsumer {
+    createToolServer(config?: Partial<ToolServerConfig>): ToolServer;
+    exportToolsForSDK(format: ToolExportFormat): unknown[];
+    getTools(): AgentToolConfig[];
+    getTool(name: string): AgentToolConfig | undefined;
+    hasTool(name: string): boolean;
+    addTool(config: AgentToolConfig, handler?: ToolHandler): void;
+    removeTool(name: string): boolean;
+    getToolCount(): number;
 }
 /**
  * Spec list entry for discovery.
  */
-interface SpecListEntry {
-  /** Spec key */
-  key: string;
-  /** Spec version */
-  version: string;
-  /** Spec type */
-  type: 'agent' | 'operation' | 'event' | 'presentation';
-  /** Brief description */
-  description?: string;
-  /** Tags for categorization */
-  tags?: string[];
+export interface SpecListEntry {
+    /** Spec key */
+    key: string;
+    /** Spec version */
+    version: string;
+    /** Spec type */
+    type: 'agent' | 'operation' | 'event' | 'presentation';
+    /** Brief description */
+    description?: string;
+    /** Tags for categorization */
+    tags?: string[];
 }
 /**
  * Task type for implementation prompts.
  */
-type ImplementationTaskType = 'implement' | 'test' | 'review' | 'refactor' | 'document';
+export type ImplementationTaskType = 'implement' | 'test' | 'review' | 'refactor' | 'document';
 /**
  * Options for generating implementation prompts.
  */
-interface ImplementationPromptOptions {
-  /** Task type */
-  taskType?: ImplementationTaskType;
-  /** Target language/framework */
-  targetLanguage?: string;
-  /** Include examples in prompt */
-  includeExamples?: boolean;
-  /** Include test scenarios */
-  includeTestScenarios?: boolean;
-  /** Custom context to append */
-  customContext?: string;
+export interface ImplementationPromptOptions {
+    /** Task type */
+    taskType?: ImplementationTaskType;
+    /** Target language/framework */
+    targetLanguage?: string;
+    /** Include examples in prompt */
+    includeExamples?: boolean;
+    /** Include test scenarios */
+    includeTestScenarios?: boolean;
+    /** Custom context to append */
+    customContext?: string;
 }
 /**
  * Format options for spec export.
  */
-type SpecExportFormat = 'markdown' | 'json' | 'prompt' | 'context';
+export type SpecExportFormat = 'markdown' | 'json' | 'prompt' | 'context';
 /**
  * Tool configuration for external consumption.
  */
-interface ExternalToolConfig {
-  /** Tool name */
-  name: string;
-  /** Tool description */
-  description: string;
-  /** Input schema */
-  inputSchema: Record<string, unknown>;
-  /** Whether approval is required */
-  requiresApproval: boolean;
-  /** Tool category */
-  category?: string;
+export interface ExternalToolConfig {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Input schema */
+    inputSchema: Record<string, unknown>;
+    /** Whether approval is required */
+    requiresApproval: boolean;
+    /** Tool category */
+    category?: string;
 }
 /**
  * Tool handler with metadata.
  */
-interface ToolWithHandler {
-  /** Tool configuration */
-  config: AgentToolConfig;
-  /** Tool handler function */
-  handler: ToolHandler;
+export interface ToolWithHandler {
+    /** Tool configuration */
+    config: AgentToolConfig;
+    /** Tool handler function */
+    handler: ToolHandler;
 }
 /**
  * Target SDK for tool export.
  */
-type ToolExportTarget = 'claude-agent' | 'opencode' | 'mcp';
+export type ToolExportTarget = 'claude-agent' | 'opencode' | 'mcp';
 /**
  * MCP server configuration.
  */
-interface McpServerConfig {
-  /** Server name */
-  name: string;
-  /** Server description */
-  description?: string;
-  /** Server version */
-  version?: string;
-  /** Tools to expose */
-  tools: AgentToolConfig[];
-  /** Tool handlers */
-  handlers: Map<string, ToolHandler>;
+export interface McpServerConfig {
+    /** Server name */
+    name: string;
+    /** Server description */
+    description?: string;
+    /** Server version */
+    version?: string;
+    /** Tools to expose */
+    tools: AgentToolConfig[];
+    /** Tool handlers */
+    handlers: Map<string, ToolHandler>;
 }
 /**
  * MCP tool definition for server.
  */
-interface McpToolDefinition {
-  name: string;
-  description: string;
-  inputSchema: {
-    type: 'object';
-    properties?: Record<string, unknown>;
-    required?: string[];
-  };
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
 }
 /**
  * Provider type for UnifiedAgent.
  */
-type UnifiedAgentProvider = 'ai-sdk' | 'claude-agent-sdk' | 'opencode-sdk';
+export type UnifiedAgentProvider = 'ai-sdk' | 'claude-agent-sdk' | 'opencode-sdk';
 /**
  * Unified agent status.
  */
-type UnifiedAgentStatus = 'idle' | 'initializing' | 'ready' | 'running' | 'completed' | 'failed';
+export type UnifiedAgentStatus = 'idle' | 'initializing' | 'ready' | 'running' | 'completed' | 'failed';
 /**
  * Unified agent execution mode.
  */
-type ExecutionMode = 'generate' | 'stream';
-//#endregion
-export { ExecutionMode, ExternalToolConfig, ImplementationPromptOptions, ImplementationTaskType, McpServerConfig, McpToolDefinition, SpecConsumer, SpecConsumerConfig, SpecExportFormat, SpecListEntry, SpecListOptions, SpecListResult, SpecMarkdownOptions, SpecPromptOptions, SpecQueryResult, ToolConsumer, ToolConsumerConfig, ToolExportFormat, ToolExportTarget, ToolServer, ToolServerConfig, ToolWithHandler, UnifiedAgentProvider, UnifiedAgentStatus };
+export type ExecutionMode = 'generate' | 'stream';
 //# sourceMappingURL=types.d.ts.map

package/dist/interop/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/interop/types.ts"],"sourcesContent":[],"mappings":";;;;;AA2EA;AAUA;AAoBA;AAC6C,UAzF5B,kBAAA,CAyF4B;EACF;EACrB,KAAA,EAzFb,SAyFa,EAAA;EAAkB;EACV,eAAA,CAAA,EAAA,OAAA;EAEF;EACX,OAAA,CAAA,EAAA,MAAA;;;AAajB;AAWA;AAiBiB,UA5HA,mBAAA,CA4HU;EAChB;EACD,UAAA,CAAA,EAAA,OAAA;EAEI;EAAe,eAAA,CAAA,EAAA,OAAA;EAMjB;EAKK,YAAA,CAAA,EAAY,OAAA;EACO;EAAR,kBAAA,CAAA,EAAA,OAAA;EAA4B;EAC5B,YAAA,CAAA,EAAA,MAAA;;;;;AAI4B,UAjIvC,iBAAA,CAiIuC;EAYvC;EAgBL,YAAA,CAAA,EAAA,OAAA;EAUK;EAgBL,eAAA,CAAA,EAAA,OAAgB;EAKX;EAgBA,kBAAe,CAAA,EAAA,OAAA;EAUpB;EAKK,MAAA,CAAA,EAAA,YAAe,GAAA,SAAA;EAQvB;EAEe,aAAA,CAAA,EAAA,MAAA;;;AAMxB;AAaA;AAQY,UAhPK,eAAA,CAgPa;EAWlB;;;QAvPJ;;;;;;;;;UAUS,eAAA;;;;;;;;;UAUA,cAAA;;;;;;;;;;;;;;;;;;;UAoBA,YAAA;6CAC4B;2CACF;sBACrB,kBAAkB;8BACV;;4BAEF;iBACX;;gBAED;;;;;;UAWC,kBAAA;;;YAGL;cACE;;;;;;UAOG,gBAAA;;;YAGL;cACE;;;;;;;;;;;;UAaG,UAAA;WACN;UACD;;cAEI;;;;;KAMF,gBAAA;;;;UAKK,YAAA;4BACW,QAAQ,oBAAoB;4BAC5B;cACd;yBACW;;kBAEP,2BAA2B;;;;;;;UAY5B,aAAA;;;;;;;;;;;;;;;KAgBL,sBAAA;;;;UAUK,2BAAA;;aAEJ;;;;;;;;;;;;;KAcD,gBAAA;;;;UAKK,kBAAA;;;;;;eAMF;;;;;;;;;UAUE,eAAA;;UAEP;;WAEC;;;;;KAMC,gBAAA;;;;UAKK,eAAA;;;;;;;;SAQR;;YAEG,YAAY;;;;;UAMP,iBAAA;;;;;iBAKA;;;;;;;KAQL,oBAAA;;;;KAQA,kBAAA;;;;KAWA,aAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/interop/types.ts"],"names":[],"mappings":"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"}

package/dist/interop/types.js

@@ -0,0 +1 @@
+// @bun

package/dist/knowledge/index.d.ts

@@ -1,2 +1,2 @@
-import { createKnowledgeInjector, injectStaticKnowledge } from "./injector.js";
-export { createKnowledgeInjector, injectStaticKnowledge };
+export * from './injector';
+//# sourceMappingURL=index.d.ts.map

package/dist/knowledge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/knowledge/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/knowledge/index.js

@@ -1,3 +1,67 @@
-import { createKnowledgeInjector, injectStaticKnowledge } from "./injector.js";
+// @bun
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
 
-export { createKnowledgeInjector, injectStaticKnowledge };
+// src/knowledge/injector.ts
+async function injectStaticKnowledge(instructions, knowledgeRefs, retriever) {
+  if (!retriever)
+    return instructions;
+  const requiredRefs = knowledgeRefs.filter((ref) => ref.required);
+  if (requiredRefs.length === 0)
+    return instructions;
+  const blocks = [];
+  for (const ref of requiredRefs) {
+    if (!retriever.supportsSpace(ref.key)) {
+      console.warn(`Required knowledge space "${ref.key}" is not available`);
+      continue;
+    }
+    try {
+      const content = await retriever.getStatic(ref.key);
+      if (content) {
+        const header = ref.instructions ? `## ${ref.key}
+${ref.instructions}` : `## ${ref.key}`;
+        blocks.push(`${header}
+
+${content}`);
+      }
+    } catch (error) {
+      console.warn(`Failed to load required knowledge "${ref.key}":`, error);
+    }
+  }
+  if (blocks.length === 0)
+    return instructions;
+  return `${instructions}
+
+---
+
+# Reference Knowledge
+
+The following information is provided for your reference. Use it to inform your responses.
+
+${blocks.join(`
+
+---
+
+`)}`;
+}
+function createKnowledgeInjector(retriever) {
+  return {
+    inject: (instructions, knowledgeRefs) => injectStaticKnowledge(instructions, knowledgeRefs, retriever),
+    hasSpace: (spaceKey) => retriever?.supportsSpace(spaceKey) ?? false,
+    listSpaces: () => retriever?.listSpaces() ?? []
+  };
+}
+export {
+  injectStaticKnowledge,
+  createKnowledgeInjector
+};

package/dist/knowledge/injector.d.ts

@@ -1,8 +1,5 @@
-import { AgentKnowledgeRef } from "../spec/spec.js";
-import { KnowledgeRetriever } from "@contractspec/lib.knowledge/retriever";
-
-//#region src/knowledge/injector.d.ts
-
+import type { KnowledgeRetriever } from '@contractspec/lib.knowledge/retriever';
+import type { AgentKnowledgeRef } from '../spec/spec';
 /**
  * Inject static knowledge into agent instructions.
  *
@@ -15,24 +12,22 @@ import { KnowledgeRetriever } from "@contractspec/lib.knowledge/retriever";
  * @param retriever - Optional knowledge retriever
  * @returns Instructions with injected knowledge
  */
-declare function injectStaticKnowledge(instructions: string, knowledgeRefs: AgentKnowledgeRef[], retriever?: KnowledgeRetriever): Promise<string>;
+export declare function injectStaticKnowledge(instructions: string, knowledgeRefs: AgentKnowledgeRef[], retriever?: KnowledgeRetriever): Promise<string>;
 /**
  * Create a knowledge injector instance for reuse.
  */
-declare function createKnowledgeInjector(retriever?: KnowledgeRetriever): {
-  /**
-   * Inject static knowledge into instructions.
-   */
-  inject: (instructions: string, knowledgeRefs: AgentKnowledgeRef[]) => Promise<string>;
-  /**
-   * Check if a knowledge space is available.
-   */
-  hasSpace: (spaceKey: string) => boolean;
-  /**
-   * List available knowledge spaces.
-   */
-  listSpaces: () => string[];
+export declare function createKnowledgeInjector(retriever?: KnowledgeRetriever): {
+    /**
+     * Inject static knowledge into instructions.
+     */
+    inject: (instructions: string, knowledgeRefs: AgentKnowledgeRef[]) => Promise<string>;
+    /**
+     * Check if a knowledge space is available.
+     */
+    hasSpace: (spaceKey: string) => boolean;
+    /**
+     * List available knowledge spaces.
+     */
+    listSpaces: () => string[];
 };
-//#endregion
-export { createKnowledgeInjector, injectStaticKnowledge };
 //# sourceMappingURL=injector.d.ts.map

package/dist/knowledge/injector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injector.d.ts","names":[],"sources":["../../src/knowledge/injector.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;;;;;AA+CA;;;;;iBA/CsB,qBAAA,sCAEL,iCACH,qBACX;;;;iBA2Ca,uBAAA,aAAoC;;;;gDAKF,wBAAmB"}
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../../src/knowledge/injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,iBAAiB,EAAE,EAClC,SAAS,CAAC,EAAE,kBAAkB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,kBAAkB;IAElE;;OAEG;2BACoB,MAAM,iBAAiB,iBAAiB,EAAE;IAGjE;;OAEG;yBACkB,MAAM;IAE3B;;OAEG;;EAGN"}