@lssm/lib.ai-agent 1.41.0 → 1.42.1

package/dist/session/store.js

@@ -1 +1,79 @@
-var e=class{sessions=new Map;async get(e){return this.sessions.get(e)??null}async create(e){let t=new Date,n={...e,createdAt:t,updatedAt:t};return this.sessions.set(e.sessionId,n),n}async appendStep(e,t){let n=this.sessions.get(e);n&&(n.steps.push(t),n.updatedAt=new Date)}async appendMessage(e,t){let n=this.sessions.get(e);n&&(n.messages.push(t),n.updatedAt=new Date)}async update(e,t){let n=this.sessions.get(e);n&&Object.assign(n,t,{updatedAt:new Date})}async delete(e){return this.sessions.delete(e)}async listByAgent(e,t=100){let n=[];for(let r of this.sessions.values())if(r.agentId===e&&(n.push(r),n.length>=t))break;return n.sort((e,t)=>t.updatedAt.getTime()-e.updatedAt.getTime())}async listByTenant(e,t=100){let n=[];for(let r of this.sessions.values())if(r.tenantId===e&&(n.push(r),n.length>=t))break;return n.sort((e,t)=>t.updatedAt.getTime()-e.updatedAt.getTime())}clear(){this.sessions.clear()}};function t(){return new e}function n(){return`sess_${Date.now()}_${Math.random().toString(36).slice(2,11)}`}export{e as InMemorySessionStore,t as createInMemorySessionStore,n as generateSessionId};
+//#region src/session/store.ts
+/**
+* In-memory session store for development and testing.
+*/
+var InMemorySessionStore = class {
+	sessions = /* @__PURE__ */ new Map();
+	async get(sessionId) {
+		return this.sessions.get(sessionId) ?? null;
+	}
+	async create(session) {
+		const now = /* @__PURE__ */ new Date();
+		const fullSession = {
+			...session,
+			createdAt: now,
+			updatedAt: now
+		};
+		this.sessions.set(session.sessionId, fullSession);
+		return fullSession;
+	}
+	async appendStep(sessionId, step) {
+		const session = this.sessions.get(sessionId);
+		if (session) {
+			session.steps.push(step);
+			session.updatedAt = /* @__PURE__ */ new Date();
+		}
+	}
+	async appendMessage(sessionId, message) {
+		const session = this.sessions.get(sessionId);
+		if (session) {
+			session.messages.push(message);
+			session.updatedAt = /* @__PURE__ */ new Date();
+		}
+	}
+	async update(sessionId, updates) {
+		const session = this.sessions.get(sessionId);
+		if (session) Object.assign(session, updates, { updatedAt: /* @__PURE__ */ new Date() });
+	}
+	async delete(sessionId) {
+		return this.sessions.delete(sessionId);
+	}
+	async listByAgent(agentId, limit = 100) {
+		const results = [];
+		for (const session of this.sessions.values()) if (session.agentId === agentId) {
+			results.push(session);
+			if (results.length >= limit) break;
+		}
+		return results.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+	}
+	async listByTenant(tenantId, limit = 100) {
+		const results = [];
+		for (const session of this.sessions.values()) if (session.tenantId === tenantId) {
+			results.push(session);
+			if (results.length >= limit) break;
+		}
+		return results.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+	}
+	/**
+	* Clear all sessions (for testing).
+	*/
+	clear() {
+		this.sessions.clear();
+	}
+};
+/**
+* Create an in-memory session store.
+*/
+function createInMemorySessionStore() {
+	return new InMemorySessionStore();
+}
+/**
+* Generate a unique session ID.
+*/
+function generateSessionId() {
+	return `sess_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+
+//#endregion
+export { InMemorySessionStore, createInMemorySessionStore, generateSessionId };
+//# sourceMappingURL=store.js.map

package/dist/session/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","names":["fullSession: AgentSessionState","results: AgentSessionState[]"],"sources":["../../src/session/store.ts"],"sourcesContent":["import type { ModelMessage, StepResult, ToolSet } from 'ai';\nimport type { AgentSessionState } from '../types';\n\n/**\n * Interface for persisting agent session state.\n *\n * Implementations can use in-memory storage, databases,\n * or external services like Redis.\n */\nexport interface AgentSessionStore {\n  /**\n   * Get a session by ID.\n   */\n  get(sessionId: string): Promise<AgentSessionState | null>;\n\n  /**\n   * Create a new session.\n   */\n  create(\n    session: Omit<AgentSessionState, 'createdAt' | 'updatedAt'>\n  ): Promise<AgentSessionState>;\n\n  /**\n   * Append a step to a session.\n   */\n  appendStep(sessionId: string, step: StepResult<ToolSet>): Promise<void>;\n\n  /**\n   * Append a message to a session.\n   */\n  appendMessage(sessionId: string, message: ModelMessage): Promise<void>;\n\n  /**\n   * Update session properties.\n   */\n  update(\n    sessionId: string,\n    updates: Partial<Pick<AgentSessionState, 'status' | 'metadata'>>\n  ): Promise<void>;\n\n  /**\n   * Delete a session.\n   */\n  delete(sessionId: string): Promise<boolean>;\n\n  /**\n   * List sessions by agent ID.\n   */\n  listByAgent(agentId: string, limit?: number): Promise<AgentSessionState[]>;\n\n  /**\n   * List sessions by tenant ID.\n   */\n  listByTenant(tenantId: string, limit?: number): Promise<AgentSessionState[]>;\n}\n\n/**\n * In-memory session store for development and testing.\n */\nexport class InMemorySessionStore implements AgentSessionStore {\n  private readonly sessions = new Map<string, AgentSessionState>();\n\n  async get(sessionId: string): Promise<AgentSessionState | null> {\n    return this.sessions.get(sessionId) ?? null;\n  }\n\n  async create(\n    session: Omit<AgentSessionState, 'createdAt' | 'updatedAt'>\n  ): Promise<AgentSessionState> {\n    const now = new Date();\n    const fullSession: AgentSessionState = {\n      ...session,\n      createdAt: now,\n      updatedAt: now,\n    };\n    this.sessions.set(session.sessionId, fullSession);\n    return fullSession;\n  }\n\n  async appendStep(\n    sessionId: string,\n    step: StepResult<ToolSet>\n  ): Promise<void> {\n    const session = this.sessions.get(sessionId);\n    if (session) {\n      session.steps.push(step);\n      session.updatedAt = new Date();\n    }\n  }\n\n  async appendMessage(sessionId: string, message: ModelMessage): Promise<void> {\n    const session = this.sessions.get(sessionId);\n    if (session) {\n      session.messages.push(message);\n      session.updatedAt = new Date();\n    }\n  }\n\n  async update(\n    sessionId: string,\n    updates: Partial<Pick<AgentSessionState, 'status' | 'metadata'>>\n  ): Promise<void> {\n    const session = this.sessions.get(sessionId);\n    if (session) {\n      Object.assign(session, updates, { updatedAt: new Date() });\n    }\n  }\n\n  async delete(sessionId: string): Promise<boolean> {\n    return this.sessions.delete(sessionId);\n  }\n\n  async listByAgent(\n    agentId: string,\n    limit = 100\n  ): Promise<AgentSessionState[]> {\n    const results: AgentSessionState[] = [];\n    for (const session of this.sessions.values()) {\n      if (session.agentId === agentId) {\n        results.push(session);\n        if (results.length >= limit) break;\n      }\n    }\n    return results.sort(\n      (a, b) => b.updatedAt.getTime() - a.updatedAt.getTime()\n    );\n  }\n\n  async listByTenant(\n    tenantId: string,\n    limit = 100\n  ): Promise<AgentSessionState[]> {\n    const results: AgentSessionState[] = [];\n    for (const session of this.sessions.values()) {\n      if (session.tenantId === tenantId) {\n        results.push(session);\n        if (results.length >= limit) break;\n      }\n    }\n    return results.sort(\n      (a, b) => b.updatedAt.getTime() - a.updatedAt.getTime()\n    );\n  }\n\n  /**\n   * Clear all sessions (for testing).\n   */\n  clear(): void {\n    this.sessions.clear();\n  }\n}\n\n/**\n * Create an in-memory session store.\n */\nexport function createInMemorySessionStore(): AgentSessionStore {\n  return new InMemorySessionStore();\n}\n\n/**\n * Generate a unique session ID.\n */\nexport function generateSessionId(): string {\n  return `sess_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;\n}\n"],"mappings":";;;;AA2DA,IAAa,uBAAb,MAA+D;CAC7D,AAAiB,2BAAW,IAAI,KAAgC;CAEhE,MAAM,IAAI,WAAsD;AAC9D,SAAO,KAAK,SAAS,IAAI,UAAU,IAAI;;CAGzC,MAAM,OACJ,SAC4B;EAC5B,MAAM,sBAAM,IAAI,MAAM;EACtB,MAAMA,cAAiC;GACrC,GAAG;GACH,WAAW;GACX,WAAW;GACZ;AACD,OAAK,SAAS,IAAI,QAAQ,WAAW,YAAY;AACjD,SAAO;;CAGT,MAAM,WACJ,WACA,MACe;EACf,MAAM,UAAU,KAAK,SAAS,IAAI,UAAU;AAC5C,MAAI,SAAS;AACX,WAAQ,MAAM,KAAK,KAAK;AACxB,WAAQ,4BAAY,IAAI,MAAM;;;CAIlC,MAAM,cAAc,WAAmB,SAAsC;EAC3E,MAAM,UAAU,KAAK,SAAS,IAAI,UAAU;AAC5C,MAAI,SAAS;AACX,WAAQ,SAAS,KAAK,QAAQ;AAC9B,WAAQ,4BAAY,IAAI,MAAM;;;CAIlC,MAAM,OACJ,WACA,SACe;EACf,MAAM,UAAU,KAAK,SAAS,IAAI,UAAU;AAC5C,MAAI,QACF,QAAO,OAAO,SAAS,SAAS,EAAE,2BAAW,IAAI,MAAM,EAAE,CAAC;;CAI9D,MAAM,OAAO,WAAqC;AAChD,SAAO,KAAK,SAAS,OAAO,UAAU;;CAGxC,MAAM,YACJ,SACA,QAAQ,KACsB;EAC9B,MAAMC,UAA+B,EAAE;AACvC,OAAK,MAAM,WAAW,KAAK,SAAS,QAAQ,CAC1C,KAAI,QAAQ,YAAY,SAAS;AAC/B,WAAQ,KAAK,QAAQ;AACrB,OAAI,QAAQ,UAAU,MAAO;;AAGjC,SAAO,QAAQ,MACZ,GAAG,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,UAAU,SAAS,CACxD;;CAGH,MAAM,aACJ,UACA,QAAQ,KACsB;EAC9B,MAAMA,UAA+B,EAAE;AACvC,OAAK,MAAM,WAAW,KAAK,SAAS,QAAQ,CAC1C,KAAI,QAAQ,aAAa,UAAU;AACjC,WAAQ,KAAK,QAAQ;AACrB,OAAI,QAAQ,UAAU,MAAO;;AAGjC,SAAO,QAAQ,MACZ,GAAG,MAAM,EAAE,UAAU,SAAS,GAAG,EAAE,UAAU,SAAS,CACxD;;;;;CAMH,QAAc;AACZ,OAAK,SAAS,OAAO;;;;;;AAOzB,SAAgB,6BAAgD;AAC9D,QAAO,IAAI,sBAAsB;;;;;AAMnC,SAAgB,oBAA4B;AAC1C,QAAO,QAAQ,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG"}

package/dist/spec/index.d.ts

@@ -0,0 +1,3 @@
+import { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig, agentKey, defineAgent } from "./spec.js";
+import { AgentRegistry, createAgentRegistry } from "./registry.js";
+export { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentRegistry, AgentSpec, AgentToolConfig, agentKey, createAgentRegistry, defineAgent };

package/dist/spec/index.js

@@ -1 +1,4 @@
-import{agentKey as e,defineAgent as t}from"./spec.js";import{AgentRegistry as n,createAgentRegistry as r}from"./registry.js";export{n as AgentRegistry,e as agentKey,r as createAgentRegistry,t as defineAgent};
+import { agentKey, defineAgent } from "./spec.js";
+import { AgentRegistry, createAgentRegistry } from "./registry.js";
+
+export { AgentRegistry, agentKey, createAgentRegistry, defineAgent };

package/dist/spec/registry.d.ts

@@ -0,0 +1,78 @@
+import { AgentSpec } from "./spec.js";
+
+//#region src/spec/registry.d.ts
+
+/**
+ * Registry for managing agent specifications.
+ *
+ * Provides registration, lookup, and version management for agent specs.
+ */
+declare class AgentRegistry {
+  private readonly specs;
+  /**
+   * Register an agent specification.
+   *
+   * @param spec - The agent specification to register
+   * @returns This registry for chaining
+   * @throws Error if the spec is already registered
+   */
+  register(spec: AgentSpec): this;
+  /**
+   * Unregister an agent specification.
+   *
+   * @param name - Agent name
+   * @param version - Agent version
+   * @returns True if the spec was removed
+   */
+  unregister(name: string, version: number): boolean;
+  /**
+   * List all registered agent specifications.
+   */
+  list(): AgentSpec[];
+  /**
+   * List all unique agent names (without versions).
+   */
+  listNames(): string[];
+  /**
+   * Get an agent specification by name and optional version.
+   *
+   * @param name - Agent name
+   * @param version - Optional version. If omitted, returns the latest version.
+   * @returns The agent spec or undefined if not found
+   */
+  get(name: string, version?: number): AgentSpec | undefined;
+  /**
+   * Get an agent specification or throw if not found.
+   *
+   * @param name - Agent name
+   * @param version - Optional version
+   * @returns The agent spec
+   * @throws Error if the spec is not found
+   */
+  require(name: string, version?: number): AgentSpec;
+  /**
+   * Check if an agent is registered.
+   *
+   * @param name - Agent name
+   * @param version - Optional version
+   */
+  has(name: string, version?: number): boolean;
+  /**
+   * Get all versions of an agent.
+   *
+   * @param name - Agent name
+   * @returns Array of specs sorted by version (ascending)
+   */
+  getVersions(name: string): AgentSpec[];
+  /**
+   * Clear all registered specs.
+   */
+  clear(): void;
+}
+/**
+ * Create a new agent registry.
+ */
+declare function createAgentRegistry(): AgentRegistry;
+//#endregion
+export { AgentRegistry, createAgentRegistry };
+//# sourceMappingURL=registry.d.ts.map

package/dist/spec/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../src/spec/registry.ts"],"sourcesContent":[],"mappings":";;;;;;AAQA;;;AAuDuC,cAvD1B,aAAA,CAuD0B;EA0BI,iBAAA,KAAA;EA0Bd;;AAqB7B;;;;;iBAtHiB;;;;;;;;;;;;UAuBP;;;;;;;;;;;;uCAsB6B;;;;;;;;;2CA0BI;;;;;;;;;;;;;;6BA0Bd;;;;;;;;;iBAqBb,mBAAA,CAAA,GAAuB"}

package/dist/spec/registry.js

@@ -1 +1,117 @@
-import{agentKey as e}from"./spec.js";var t=class{specs=new Map;register(t){let n=e(t.meta);if(this.specs.has(n))throw Error(`Duplicate agent spec registered for ${n}`);return this.specs.set(n,t),this}unregister(e,t){return this.specs.delete(`${e}.v${t}`)}list(){return[...this.specs.values()]}listNames(){let e=new Set;for(let t of this.specs.values())e.add(t.meta.name);return[...e]}get(e,t){if(t!=null)return this.specs.get(`${e}.v${t}`);let n,r=-1/0;for(let t of this.specs.values())t.meta.name===e&&t.meta.version>r&&(n=t,r=t.meta.version);return n}require(e,t){let n=this.get(e,t);if(!n)throw Error(`Agent spec not found for ${e}${t==null?``:`.v${t}`}`);return n}has(e,t){return this.get(e,t)!==void 0}getVersions(e){let t=[];for(let n of this.specs.values())n.meta.name===e&&t.push(n);return t.sort((e,t)=>e.meta.version-t.meta.version)}clear(){this.specs.clear()}};function n(){return new t}export{t as AgentRegistry,n as createAgentRegistry};
+import { agentKey } from "./spec.js";
+
+//#region src/spec/registry.ts
+/**
+* Registry for managing agent specifications.
+*
+* Provides registration, lookup, and version management for agent specs.
+*/
+var AgentRegistry = class {
+	specs = /* @__PURE__ */ new Map();
+	/**
+	* Register an agent specification.
+	*
+	* @param spec - The agent specification to register
+	* @returns This registry for chaining
+	* @throws Error if the spec is already registered
+	*/
+	register(spec) {
+		const key = agentKey(spec.meta);
+		if (this.specs.has(key)) throw new Error(`Duplicate agent spec registered for ${key}`);
+		this.specs.set(key, spec);
+		return this;
+	}
+	/**
+	* Unregister an agent specification.
+	*
+	* @param name - Agent name
+	* @param version - Agent version
+	* @returns True if the spec was removed
+	*/
+	unregister(name, version) {
+		return this.specs.delete(`${name}.v${version}`);
+	}
+	/**
+	* List all registered agent specifications.
+	*/
+	list() {
+		return [...this.specs.values()];
+	}
+	/**
+	* List all unique agent names (without versions).
+	*/
+	listNames() {
+		const names = /* @__PURE__ */ new Set();
+		for (const spec of this.specs.values()) names.add(spec.meta.key);
+		return [...names];
+	}
+	/**
+	* Get an agent specification by name and optional version.
+	*
+	* @param name - Agent name
+	* @param version - Optional version. If omitted, returns the latest version.
+	* @returns The agent spec or undefined if not found
+	*/
+	get(name, version) {
+		if (version != null) return this.specs.get(`${name}.v${version}`);
+		let latest;
+		let maxVersion = -Infinity;
+		for (const spec of this.specs.values()) {
+			if (spec.meta.key !== name) continue;
+			if (spec.meta.version > maxVersion) {
+				latest = spec;
+				maxVersion = spec.meta.version;
+			}
+		}
+		return latest;
+	}
+	/**
+	* Get an agent specification or throw if not found.
+	*
+	* @param name - Agent name
+	* @param version - Optional version
+	* @returns The agent spec
+	* @throws Error if the spec is not found
+	*/
+	require(name, version) {
+		const spec = this.get(name, version);
+		if (!spec) throw new Error(`Agent spec not found for ${name}${version != null ? `.v${version}` : ""}`);
+		return spec;
+	}
+	/**
+	* Check if an agent is registered.
+	*
+	* @param name - Agent name
+	* @param version - Optional version
+	*/
+	has(name, version) {
+		return this.get(name, version) !== void 0;
+	}
+	/**
+	* Get all versions of an agent.
+	*
+	* @param name - Agent name
+	* @returns Array of specs sorted by version (ascending)
+	*/
+	getVersions(name) {
+		const versions = [];
+		for (const spec of this.specs.values()) if (spec.meta.key === name) versions.push(spec);
+		return versions.sort((a, b) => a.meta.version - b.meta.version);
+	}
+	/**
+	* Clear all registered specs.
+	*/
+	clear() {
+		this.specs.clear();
+	}
+};
+/**
+* Create a new agent registry.
+*/
+function createAgentRegistry() {
+	return new AgentRegistry();
+}
+
+//#endregion
+export { AgentRegistry, createAgentRegistry };
+//# sourceMappingURL=registry.js.map

package/dist/spec/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":["latest: AgentSpec | undefined","versions: AgentSpec[]"],"sources":["../../src/spec/registry.ts"],"sourcesContent":["import type { AgentSpec } from './spec';\nimport { agentKey } from './spec';\n\n/**\n * Registry for managing agent specifications.\n *\n * Provides registration, lookup, and version management for agent specs.\n */\nexport class AgentRegistry {\n  private readonly specs = new Map<string, AgentSpec>();\n\n  /**\n   * Register an agent specification.\n   *\n   * @param spec - The agent specification to register\n   * @returns This registry for chaining\n   * @throws Error if the spec is already registered\n   */\n  register(spec: AgentSpec): this {\n    const key = agentKey(spec.meta);\n    if (this.specs.has(key)) {\n      throw new Error(`Duplicate agent spec registered for ${key}`);\n    }\n    this.specs.set(key, spec);\n    return this;\n  }\n\n  /**\n   * Unregister an agent specification.\n   *\n   * @param name - Agent name\n   * @param version - Agent version\n   * @returns True if the spec was removed\n   */\n  unregister(name: string, version: number): boolean {\n    return this.specs.delete(`${name}.v${version}`);\n  }\n\n  /**\n   * List all registered agent specifications.\n   */\n  list(): AgentSpec[] {\n    return [...this.specs.values()];\n  }\n\n  /**\n   * List all unique agent names (without versions).\n   */\n  listNames(): string[] {\n    const names = new Set<string>();\n    for (const spec of this.specs.values()) {\n      names.add(spec.meta.key);\n    }\n    return [...names];\n  }\n\n  /**\n   * Get an agent specification by name and optional version.\n   *\n   * @param name - Agent name\n   * @param version - Optional version. If omitted, returns the latest version.\n   * @returns The agent spec or undefined if not found\n   */\n  get(name: string, version?: number): AgentSpec | undefined {\n    if (version != null) {\n      return this.specs.get(`${name}.v${version}`);\n    }\n\n    // Find latest version\n    let latest: AgentSpec | undefined;\n    let maxVersion = -Infinity;\n    for (const spec of this.specs.values()) {\n      if (spec.meta.key !== name) continue;\n      if (spec.meta.version > maxVersion) {\n        latest = spec;\n        maxVersion = spec.meta.version;\n      }\n    }\n    return latest;\n  }\n\n  /**\n   * Get an agent specification or throw if not found.\n   *\n   * @param name - Agent name\n   * @param version - Optional version\n   * @returns The agent spec\n   * @throws Error if the spec is not found\n   */\n  require(name: string, version?: number): AgentSpec {\n    const spec = this.get(name, version);\n    if (!spec) {\n      throw new Error(\n        `Agent spec not found for ${name}${version != null ? `.v${version}` : ''}`\n      );\n    }\n    return spec;\n  }\n\n  /**\n   * Check if an agent is registered.\n   *\n   * @param name - Agent name\n   * @param version - Optional version\n   */\n  has(name: string, version?: number): boolean {\n    return this.get(name, version) !== undefined;\n  }\n\n  /**\n   * Get all versions of an agent.\n   *\n   * @param name - Agent name\n   * @returns Array of specs sorted by version (ascending)\n   */\n  getVersions(name: string): AgentSpec[] {\n    const versions: AgentSpec[] = [];\n    for (const spec of this.specs.values()) {\n      if (spec.meta.key === name) {\n        versions.push(spec);\n      }\n    }\n    return versions.sort((a, b) => a.meta.version - b.meta.version);\n  }\n\n  /**\n   * Clear all registered specs.\n   */\n  clear(): void {\n    this.specs.clear();\n  }\n}\n\n/**\n * Create a new agent registry.\n */\nexport function createAgentRegistry(): AgentRegistry {\n  return new AgentRegistry();\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,gBAAb,MAA2B;CACzB,AAAiB,wBAAQ,IAAI,KAAwB;;;;;;;;CASrD,SAAS,MAAuB;EAC9B,MAAM,MAAM,SAAS,KAAK,KAAK;AAC/B,MAAI,KAAK,MAAM,IAAI,IAAI,CACrB,OAAM,IAAI,MAAM,uCAAuC,MAAM;AAE/D,OAAK,MAAM,IAAI,KAAK,KAAK;AACzB,SAAO;;;;;;;;;CAUT,WAAW,MAAc,SAA0B;AACjD,SAAO,KAAK,MAAM,OAAO,GAAG,KAAK,IAAI,UAAU;;;;;CAMjD,OAAoB;AAClB,SAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC;;;;;CAMjC,YAAsB;EACpB,MAAM,wBAAQ,IAAI,KAAa;AAC/B,OAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,CACpC,OAAM,IAAI,KAAK,KAAK,IAAI;AAE1B,SAAO,CAAC,GAAG,MAAM;;;;;;;;;CAUnB,IAAI,MAAc,SAAyC;AACzD,MAAI,WAAW,KACb,QAAO,KAAK,MAAM,IAAI,GAAG,KAAK,IAAI,UAAU;EAI9C,IAAIA;EACJ,IAAI,aAAa;AACjB,OAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,EAAE;AACtC,OAAI,KAAK,KAAK,QAAQ,KAAM;AAC5B,OAAI,KAAK,KAAK,UAAU,YAAY;AAClC,aAAS;AACT,iBAAa,KAAK,KAAK;;;AAG3B,SAAO;;;;;;;;;;CAWT,QAAQ,MAAc,SAA6B;EACjD,MAAM,OAAO,KAAK,IAAI,MAAM,QAAQ;AACpC,MAAI,CAAC,KACH,OAAM,IAAI,MACR,4BAA4B,OAAO,WAAW,OAAO,KAAK,YAAY,KACvE;AAEH,SAAO;;;;;;;;CAST,IAAI,MAAc,SAA2B;AAC3C,SAAO,KAAK,IAAI,MAAM,QAAQ,KAAK;;;;;;;;CASrC,YAAY,MAA2B;EACrC,MAAMC,WAAwB,EAAE;AAChC,OAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,CACpC,KAAI,KAAK,KAAK,QAAQ,KACpB,UAAS,KAAK,KAAK;AAGvB,SAAO,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ;;;;;CAMjE,QAAc;AACZ,OAAK,MAAM,OAAO;;;;;;AAOtB,SAAgB,sBAAqC;AACnD,QAAO,IAAI,eAAe"}

package/dist/spec/spec.d.ts

@@ -0,0 +1,127 @@
+import { OwnerShipMeta } from "@lssm/lib.contracts/ownership";
+import { KnowledgeCategory } from "@lssm/lib.contracts/knowledge/spec";
+import { PolicyRef } from "@lssm/lib.contracts/policy/spec";
+
+//#region src/spec/spec.d.ts
+
+/**
+ * Metadata for an agent specification.
+ */
+type AgentMeta = OwnerShipMeta;
+/**
+ * Configuration for a tool that an agent can use.
+ */
+interface AgentToolConfig {
+  /** Tool name (unique within the agent) */
+  name: string;
+  /** Human-readable description for the LLM */
+  description?: string;
+  /** JSON Schema fragment for tool parameters */
+  schema?: Record<string, unknown>;
+  /** Optional cooldown in milliseconds between invocations */
+  cooldownMs?: number;
+  /** Maximum execution time before timeout */
+  timeoutMs?: number;
+  /** Whether the tool can be executed without human approval (AI SDK needsApproval = !automationSafe) */
+  automationSafe?: boolean;
+  /** Explicit approval requirement (overrides automationSafe) */
+  requiresApproval?: boolean;
+  /** Optional policy guard that must evaluate to allow the tool call */
+  policy?: PolicyRef;
+}
+/**
+ * Reference to a knowledge space that the agent can access.
+ */
+interface AgentKnowledgeRef {
+  /** Knowledge space key */
+  key: string;
+  /** Optional specific version */
+  version?: number;
+  /** Filter by knowledge category */
+  category?: KnowledgeCategory;
+  /** Whether the knowledge is required (static injection) or optional (dynamic RAG) */
+  required?: boolean;
+  /** Additional instructions appended when the space is available */
+  instructions?: string;
+}
+/**
+ * Memory configuration for agent session persistence.
+ */
+interface AgentMemoryConfig {
+  /** Maximum entries to keep in memory */
+  maxEntries?: number;
+  /** Time-to-live in minutes */
+  ttlMinutes?: number;
+  /** Number of messages before triggering summarization */
+  summaryTrigger?: number;
+  /** Whether to persist to long-term storage */
+  persistLongTerm?: boolean;
+}
+/**
+ * Confidence policy for agent responses.
+ */
+interface AgentConfidencePolicy {
+  /** Minimum acceptable confidence before escalation. Defaults to 0.7 */
+  min?: number;
+  /** Default value used when provider does not report confidence */
+  default?: number;
+}
+/**
+ * Escalation policy for handling uncertain or failed agent responses.
+ */
+interface AgentEscalationPolicy {
+  /** Auto escalate when confidence < threshold */
+  confidenceThreshold?: number;
+  /** Escalate when a tool throws irrecoverable errors */
+  onToolFailure?: boolean;
+  /** Escalate when iteration budget exceeded */
+  onTimeout?: boolean;
+  /** Optional human approval workflow ID */
+  approvalWorkflow?: string;
+}
+/**
+ * Combined policy configuration for an agent.
+ */
+interface AgentPolicy {
+  confidence?: AgentConfidencePolicy;
+  escalation?: AgentEscalationPolicy;
+  /** Feature flags to apply to this agent */
+  flags?: string[];
+}
+/**
+ * Complete specification for a ContractSpec agent.
+ */
+interface AgentSpec {
+  meta: AgentMeta;
+  /** System instructions for the agent */
+  instructions: string;
+  /** Human-readable description */
+  description?: string;
+  /** Tags for categorization */
+  tags?: string[];
+  /** Tools the agent can use */
+  tools: AgentToolConfig[];
+  /** Memory/session configuration */
+  memory?: AgentMemoryConfig;
+  /** Knowledge spaces the agent can access */
+  knowledge?: AgentKnowledgeRef[];
+  /** Policy configuration */
+  policy?: AgentPolicy;
+  /** Maximum steps per generation (defaults to 10) */
+  maxSteps?: number;
+}
+/**
+ * Define and validate an agent specification.
+ *
+ * @param spec - The agent specification
+ * @returns The frozen, validated specification
+ * @throws Error if the specification is invalid
+ */
+declare function defineAgent(spec: AgentSpec): AgentSpec;
+/**
+ * Generate a unique key for an agent spec.
+ */
+declare function agentKey(meta: AgentMeta): string;
+//#endregion
+export { AgentConfidencePolicy, AgentEscalationPolicy, AgentKnowledgeRef, AgentMemoryConfig, AgentMeta, AgentPolicy, AgentSpec, AgentToolConfig, agentKey, defineAgent };
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/spec/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAOA;AAKiB,KALL,SAAA,GAAY,aAWb;AAgBX;AAgBA;AAcA;AAUiB,UA9DA,eAAA,CA8DqB;EAcrB;EAUA,IAAA,EAAA,MAAS;EAClB;EAQC,WAAA,CAAA,EAAA,MAAA;EAEE;EAEG,MAAA,CAAA,EA7FH,MA6FG,CAAA,MAAA,EAAA,OAAA,CAAA;EAEH;EAAW,UAAA,CAAA,EAAA,MAAA;EAYN;EA+BA,SAAA,CAAA,EAAQ,MAAA;;;;;;WAhIb;;;;;UAMM,iBAAA;;;;;;aAMJ;;;;;;;;;UAUI,iBAAA;;;;;;;;;;;;;UAcA,qBAAA;;;;;;;;;UAUA,qBAAA;;;;;;;;;;;;;UAcA,WAAA;eACF;eACA;;;;;;;UAQE,SAAA;QACT;;;;;;;;SAQC;;WAEE;;cAEG;;WAEH;;;;;;;;;;;iBAYK,WAAA,OAAkB,YAAY;;;;iBA+B9B,QAAA,OAAe"}

package/dist/spec/spec.js

@@ -1 +1,30 @@
-function e(e){if(!e.meta?.name)throw Error(`Agent name is required`);if(!Number.isFinite(e.meta.version))throw Error(`Agent ${e.meta.name} is missing a numeric version`);if(!e.instructions?.trim())throw Error(`Agent ${e.meta.name} requires instructions`);if(!e.tools?.length)throw Error(`Agent ${e.meta.name} must expose at least one tool`);let t=new Set;for(let n of e.tools){if(t.has(n.name))throw Error(`Agent ${e.meta.name} has duplicate tool name: ${n.name}`);t.add(n.name)}return Object.freeze(e)}function t(e){return`${e.name}.v${e.version}`}export{t as agentKey,e as defineAgent};
+//#region src/spec/spec.ts
+/**
+* Define and validate an agent specification.
+*
+* @param spec - The agent specification
+* @returns The frozen, validated specification
+* @throws Error if the specification is invalid
+*/
+function defineAgent(spec) {
+	if (!spec.meta?.key) throw new Error("Agent key is required");
+	if (!Number.isFinite(spec.meta.version)) throw new Error(`Agent ${spec.meta.key} is missing a numeric version`);
+	if (!spec.instructions?.trim()) throw new Error(`Agent ${spec.meta.key} requires instructions`);
+	if (!spec.tools?.length) throw new Error(`Agent ${spec.meta.key} must expose at least one tool`);
+	const toolNames = /* @__PURE__ */ new Set();
+	for (const tool of spec.tools) {
+		if (toolNames.has(tool.name)) throw new Error(`Agent ${spec.meta.key} has duplicate tool name: ${tool.name}`);
+		toolNames.add(tool.name);
+	}
+	return Object.freeze(spec);
+}
+/**
+* Generate a unique key for an agent spec.
+*/
+function agentKey(meta) {
+	return `${meta.key}.v${meta.version}`;
+}
+
+//#endregion
+export { agentKey, defineAgent };
+//# sourceMappingURL=spec.js.map

package/dist/spec/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","names":[],"sources":["../../src/spec/spec.ts"],"sourcesContent":["import type { OwnerShipMeta } from '@lssm/lib.contracts/ownership';\nimport type { KnowledgeCategory } from '@lssm/lib.contracts/knowledge/spec';\nimport type { PolicyRef } from '@lssm/lib.contracts/policy/spec';\n\n/**\n * Metadata for an agent specification.\n */\nexport type AgentMeta = OwnerShipMeta;\n\n/**\n * Configuration for a tool that an agent can use.\n */\nexport interface AgentToolConfig {\n  /** Tool name (unique within the agent) */\n  name: string;\n  /** Human-readable description for the LLM */\n  description?: string;\n  /** JSON Schema fragment for tool parameters */\n  schema?: Record<string, unknown>;\n  /** Optional cooldown in milliseconds between invocations */\n  cooldownMs?: number;\n  /** Maximum execution time before timeout */\n  timeoutMs?: number;\n  /** Whether the tool can be executed without human approval (AI SDK needsApproval = !automationSafe) */\n  automationSafe?: boolean;\n  /** Explicit approval requirement (overrides automationSafe) */\n  requiresApproval?: boolean;\n  /** Optional policy guard that must evaluate to allow the tool call */\n  policy?: PolicyRef;\n}\n\n/**\n * Reference to a knowledge space that the agent can access.\n */\nexport interface AgentKnowledgeRef {\n  /** Knowledge space key */\n  key: string;\n  /** Optional specific version */\n  version?: number;\n  /** Filter by knowledge category */\n  category?: KnowledgeCategory;\n  /** Whether the knowledge is required (static injection) or optional (dynamic RAG) */\n  required?: boolean;\n  /** Additional instructions appended when the space is available */\n  instructions?: string;\n}\n\n/**\n * Memory configuration for agent session persistence.\n */\nexport interface AgentMemoryConfig {\n  /** Maximum entries to keep in memory */\n  maxEntries?: number;\n  /** Time-to-live in minutes */\n  ttlMinutes?: number;\n  /** Number of messages before triggering summarization */\n  summaryTrigger?: number;\n  /** Whether to persist to long-term storage */\n  persistLongTerm?: boolean;\n}\n\n/**\n * Confidence policy for agent responses.\n */\nexport interface AgentConfidencePolicy {\n  /** Minimum acceptable confidence before escalation. Defaults to 0.7 */\n  min?: number;\n  /** Default value used when provider does not report confidence */\n  default?: number;\n}\n\n/**\n * Escalation policy for handling uncertain or failed agent responses.\n */\nexport interface AgentEscalationPolicy {\n  /** Auto escalate when confidence < threshold */\n  confidenceThreshold?: number;\n  /** Escalate when a tool throws irrecoverable errors */\n  onToolFailure?: boolean;\n  /** Escalate when iteration budget exceeded */\n  onTimeout?: boolean;\n  /** Optional human approval workflow ID */\n  approvalWorkflow?: string;\n}\n\n/**\n * Combined policy configuration for an agent.\n */\nexport interface AgentPolicy {\n  confidence?: AgentConfidencePolicy;\n  escalation?: AgentEscalationPolicy;\n  /** Feature flags to apply to this agent */\n  flags?: string[];\n}\n\n/**\n * Complete specification for a ContractSpec agent.\n */\nexport interface AgentSpec {\n  meta: AgentMeta;\n  /** System instructions for the agent */\n  instructions: string;\n  /** Human-readable description */\n  description?: string;\n  /** Tags for categorization */\n  tags?: string[];\n  /** Tools the agent can use */\n  tools: AgentToolConfig[];\n  /** Memory/session configuration */\n  memory?: AgentMemoryConfig;\n  /** Knowledge spaces the agent can access */\n  knowledge?: AgentKnowledgeRef[];\n  /** Policy configuration */\n  policy?: AgentPolicy;\n  /** Maximum steps per generation (defaults to 10) */\n  maxSteps?: number;\n}\n\n/**\n * Define and validate an agent specification.\n *\n * @param spec - The agent specification\n * @returns The frozen, validated specification\n * @throws Error if the specification is invalid\n */\nexport function defineAgent(spec: AgentSpec): AgentSpec {\n  if (!spec.meta?.key) {\n    throw new Error('Agent key is required');\n  }\n  if (!Number.isFinite(spec.meta.version)) {\n    throw new Error(`Agent ${spec.meta.key} is missing a numeric version`);\n  }\n  if (!spec.instructions?.trim()) {\n    throw new Error(`Agent ${spec.meta.key} requires instructions`);\n  }\n  if (!spec.tools?.length) {\n    throw new Error(`Agent ${spec.meta.key} must expose at least one tool`);\n  }\n\n  // Validate tool names are unique\n  const toolNames = new Set<string>();\n  for (const tool of spec.tools) {\n    if (toolNames.has(tool.name)) {\n      throw new Error(\n        `Agent ${spec.meta.key} has duplicate tool name: ${tool.name}`\n      );\n    }\n    toolNames.add(tool.name);\n  }\n\n  return Object.freeze(spec);\n}\n\n/**\n * Generate a unique key for an agent spec.\n */\nexport function agentKey(meta: AgentMeta): string {\n  return `${meta.key}.v${meta.version}`;\n}\n"],"mappings":";;;;;;;;AA6HA,SAAgB,YAAY,MAA4B;AACtD,KAAI,CAAC,KAAK,MAAM,IACd,OAAM,IAAI,MAAM,wBAAwB;AAE1C,KAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,CACrC,OAAM,IAAI,MAAM,SAAS,KAAK,KAAK,IAAI,+BAA+B;AAExE,KAAI,CAAC,KAAK,cAAc,MAAM,CAC5B,OAAM,IAAI,MAAM,SAAS,KAAK,KAAK,IAAI,wBAAwB;AAEjE,KAAI,CAAC,KAAK,OAAO,OACf,OAAM,IAAI,MAAM,SAAS,KAAK,KAAK,IAAI,gCAAgC;CAIzE,MAAM,4BAAY,IAAI,KAAa;AACnC,MAAK,MAAM,QAAQ,KAAK,OAAO;AAC7B,MAAI,UAAU,IAAI,KAAK,KAAK,CAC1B,OAAM,IAAI,MACR,SAAS,KAAK,KAAK,IAAI,4BAA4B,KAAK,OACzD;AAEH,YAAU,IAAI,KAAK,KAAK;;AAG1B,QAAO,OAAO,OAAO,KAAK;;;;;AAM5B,SAAgB,SAAS,MAAyB;AAChD,QAAO,GAAG,KAAK,IAAI,IAAI,KAAK"}

package/dist/telemetry/adapter.d.ts

@@ -0,0 +1,73 @@
+import { StepResult, ToolSet } from "ai";
+
+//#region src/telemetry/adapter.d.ts
+
+/**
+ * Metric sample compatible with @lssm/lib.evolution OperationMetricSample.
+ */
+interface OperationMetricSample {
+  operation: {
+    name: string;
+    version: number;
+  };
+  durationMs: number;
+  success: boolean;
+  timestamp: Date;
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Interface for collecting telemetry metrics.
+ *
+ * Implementations can send metrics to:
+ * - @lssm/lib.evolution for self-improvement
+ * - PostHog for analytics
+ * - Custom monitoring systems
+ */
+interface TelemetryCollector {
+  /**
+   * Collect a metric sample.
+   */
+  collect(sample: OperationMetricSample): Promise<void>;
+}
+/**
+ * Track an agent step for telemetry.
+ *
+ * Called from ContractSpecAgent.onStepFinish to feed metrics
+ * to the evolution engine.
+ *
+ * @param collector - Telemetry collector
+ * @param agentId - Agent identifier (e.g., "support.bot.v1")
+ * @param step - AI SDK step result
+ * @param durationMs - Optional step duration in milliseconds
+ */
+declare function trackAgentStep(collector: TelemetryCollector, agentId: string, step: StepResult<ToolSet>, durationMs?: number): Promise<void>;
+/**
+ * In-memory telemetry collector for testing.
+ */
+declare class InMemoryTelemetryCollector implements TelemetryCollector {
+  private readonly samples;
+  collect(sample: OperationMetricSample): Promise<void>;
+  /**
+   * Get all collected samples.
+   */
+  getSamples(): OperationMetricSample[];
+  /**
+   * Get samples for a specific operation.
+   */
+  getSamplesForOperation(operationName: string): OperationMetricSample[];
+  /**
+   * Clear all samples.
+   */
+  clear(): void;
+}
+/**
+ * Create an in-memory telemetry collector.
+ */
+declare function createInMemoryTelemetryCollector(): InMemoryTelemetryCollector;
+/**
+ * No-op telemetry collector that discards all metrics.
+ */
+declare const noopTelemetryCollector: TelemetryCollector;
+//#endregion
+export { InMemoryTelemetryCollector, OperationMetricSample, TelemetryCollector, createInMemoryTelemetryCollector, noopTelemetryCollector, trackAgentStep };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/telemetry/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","names":[],"sources":["../../src/telemetry/adapter.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAgBiB,UAhBA,qBAAA,CAoBC;EA0BI,SAAA,EAAA;IACT,IAAA,EAAA,MAAA;IAEM,OAAA,EAAA,MAAA;EAAX,CAAA;EAEL,UAAA,EAAA,MAAA;EAAO,OAAA,EAAA,OAAA;EAyCG,SAAA,EAxFA,IAwFA;EAGW,QAAA,CAAA,EA1FX,MA0FW,CAAA,MAAA,EAAA,OAAA,CAAA;;;;;;AA6BxB;AAOA;;;UAnHiB,kBAAA;;;;kBAIC,wBAAwB;;;;;;;;;;;;;iBA0BpB,cAAA,YACT,2CAEL,WAAW,gCAEhB;;;;cAyCU,0BAAA,YAAsC;;kBAG3B,wBAAwB;;;;gBAOhC;;;;iDAOiC;;;;;;;;;iBAejC,gCAAA,CAAA,GAAoC;;;;cAOvC,wBAAwB"}