@contractspec/lib.ai-agent 1.44.0

package/dist/memory/manager.js

@@ -0,0 +1,80 @@
+import { randomUUID } from "node:crypto";
+
+//#region src/memory/manager.ts
+/**
+* Extract text content from a ModelMessage.
+* Handles both string content and array content parts.
+*/
+function extractMessageContent(message) {
+	const content = message.content;
+	if (typeof content === "string") return content;
+	if (Array.isArray(content)) return content.map((part) => {
+		if (typeof part === "string") return part;
+		if ("text" in part && typeof part.text === "string") return part.text;
+		return "";
+	}).filter(Boolean).join("");
+	return "";
+}
+/**
+* Extract text content from an AgentMessage.
+*/
+function extractAgentMessageContent(message) {
+	const content = message.content;
+	if (typeof content === "string") return content;
+	if (Array.isArray(content)) return content.map((part) => {
+		if (typeof part === "string") return part;
+		if ("text" in part && typeof part.text === "string") return part.text;
+		return "";
+	}).filter(Boolean).join("");
+	return "";
+}
+/**
+* Map ModelMessage role to memory entry type.
+*/
+function roleToEntryType(role) {
+	switch (role) {
+		case "assistant": return "assistant";
+		case "system": return "system";
+		case "tool": return "tool";
+		case "user":
+		default: return "user";
+	}
+}
+var BaseAgentMemoryManager = class {
+	async append(session, entry) {
+		const current = await this.load(session.sessionId) ?? this.bootstrapMemory(session);
+		const finalEntry = {
+			id: randomUUID(),
+			createdAt: entry.createdAt ?? /* @__PURE__ */ new Date(),
+			...entry
+		};
+		current.memory.entries.push(finalEntry);
+		await this.save(current);
+		return current;
+	}
+	async summarize(_session) {}
+	async prune(_session) {}
+	bootstrapMemory(session) {
+		return {
+			session,
+			memory: { entries: session.messages.map((message) => ({
+				id: randomUUID(),
+				createdAt: /* @__PURE__ */ new Date(),
+				type: roleToEntryType(message.role),
+				content: extractMessageContent(message)
+			})) }
+		};
+	}
+};
+function trackMessageInMemory(manager, session, message) {
+	if (!manager) return;
+	manager.append(session, {
+		type: message.role,
+		content: extractAgentMessageContent(message),
+		metadata: message.metadata
+	});
+}
+
+//#endregion
+export { BaseAgentMemoryManager, trackMessageInMemory };
+//# sourceMappingURL=manager.js.map

package/dist/memory/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","names":["finalEntry: AgentMemoryEntry"],"sources":["../../src/memory/manager.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { ModelMessage } from 'ai';\nimport type { AgentMessage, AgentSessionState } from '../types';\n\nexport interface AgentMemoryEntry {\n  id: string;\n  type: 'user' | 'assistant' | 'tool' | 'system';\n  content: string;\n  createdAt: Date;\n  metadata?: Record<string, string>;\n}\n\nexport interface AgentMemorySnapshot {\n  entries: AgentMemoryEntry[];\n  summary?: string;\n  lastSummarizedAt?: Date;\n}\n\nexport interface AgentSessionMemory {\n  session: AgentSessionState;\n  memory: AgentMemorySnapshot;\n}\n\nexport interface AgentMemoryManager {\n  load(sessionId: string): Promise<AgentSessionMemory | null>;\n  save(snapshot: AgentSessionMemory): Promise<void>;\n  append(\n    session: AgentSessionState,\n    entry: Omit<AgentMemoryEntry, 'id' | 'createdAt'> & { createdAt?: Date }\n  ): Promise<AgentSessionMemory>;\n  summarize(\n    session: AgentSessionState\n  ): Promise<AgentMemorySnapshot | undefined>;\n  prune(session: AgentSessionState): Promise<void>;\n}\n\n/**\n * Extract text content from a ModelMessage.\n * Handles both string content and array content parts.\n */\nfunction extractMessageContent(message: ModelMessage): string {\n  const content = message.content;\n\n  // Handle string content directly\n  if (typeof content === 'string') {\n    return content;\n  }\n\n  // Handle array content (parts)\n  if (Array.isArray(content)) {\n    return content\n      .map((part) => {\n        if (typeof part === 'string') return part;\n        if ('text' in part && typeof part.text === 'string') return part.text;\n        return '';\n      })\n      .filter(Boolean)\n      .join('');\n  }\n\n  return '';\n}\n\n/**\n * Extract text content from an AgentMessage.\n */\nfunction extractAgentMessageContent(message: AgentMessage): string {\n  const content = message.content;\n\n  if (typeof content === 'string') {\n    return content;\n  }\n\n  if (Array.isArray(content)) {\n    return content\n      .map((part) => {\n        if (typeof part === 'string') return part;\n        if ('text' in part && typeof part.text === 'string') return part.text;\n        return '';\n      })\n      .filter(Boolean)\n      .join('');\n  }\n\n  return '';\n}\n\n/**\n * Map ModelMessage role to memory entry type.\n */\nfunction roleToEntryType(\n  role: ModelMessage['role']\n): 'user' | 'assistant' | 'tool' | 'system' {\n  switch (role) {\n    case 'assistant':\n      return 'assistant';\n    case 'system':\n      return 'system';\n    case 'tool':\n      return 'tool';\n    case 'user':\n    default:\n      return 'user';\n  }\n}\n\nexport abstract class BaseAgentMemoryManager implements AgentMemoryManager {\n  abstract load(sessionId: string): Promise<AgentSessionMemory | null>;\n  abstract save(snapshot: AgentSessionMemory): Promise<void>;\n\n  async append(\n    session: AgentSessionState,\n    entry: Omit<AgentMemoryEntry, 'id' | 'createdAt'> & { createdAt?: Date }\n  ): Promise<AgentSessionMemory> {\n    const current =\n      (await this.load(session.sessionId)) ?? this.bootstrapMemory(session);\n    const finalEntry: AgentMemoryEntry = {\n      id: randomUUID(),\n      createdAt: entry.createdAt ?? new Date(),\n      ...entry,\n    };\n    current.memory.entries.push(finalEntry);\n    await this.save(current);\n    return current;\n  }\n\n  async summarize(\n    _session: AgentSessionState\n  ): Promise<AgentMemorySnapshot | undefined> {\n    return undefined;\n  }\n\n  async prune(_session: AgentSessionState): Promise<void> {\n    // noop by default\n  }\n\n  protected bootstrapMemory(session: AgentSessionState): AgentSessionMemory {\n    return {\n      session,\n      memory: {\n        entries: session.messages.map<AgentMemoryEntry>((message) => ({\n          id: randomUUID(),\n          createdAt: new Date(),\n          type: roleToEntryType(message.role),\n          content: extractMessageContent(message),\n        })),\n      },\n    };\n  }\n}\n\nexport function trackMessageInMemory(\n  manager: AgentMemoryManager | undefined,\n  session: AgentSessionState,\n  message: AgentMessage\n) {\n  if (!manager) return;\n  void manager.append(session, {\n    type: message.role,\n    content: extractAgentMessageContent(message),\n    metadata: message.metadata,\n  });\n}\n"],"mappings":";;;;;;;AAwCA,SAAS,sBAAsB,SAA+B;CAC5D,MAAM,UAAU,QAAQ;AAGxB,KAAI,OAAO,YAAY,SACrB,QAAO;AAIT,KAAI,MAAM,QAAQ,QAAQ,CACxB,QAAO,QACJ,KAAK,SAAS;AACb,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,MAAI,UAAU,QAAQ,OAAO,KAAK,SAAS,SAAU,QAAO,KAAK;AACjE,SAAO;GACP,CACD,OAAO,QAAQ,CACf,KAAK,GAAG;AAGb,QAAO;;;;;AAMT,SAAS,2BAA2B,SAA+B;CACjE,MAAM,UAAU,QAAQ;AAExB,KAAI,OAAO,YAAY,SACrB,QAAO;AAGT,KAAI,MAAM,QAAQ,QAAQ,CACxB,QAAO,QACJ,KAAK,SAAS;AACb,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,MAAI,UAAU,QAAQ,OAAO,KAAK,SAAS,SAAU,QAAO,KAAK;AACjE,SAAO;GACP,CACD,OAAO,QAAQ,CACf,KAAK,GAAG;AAGb,QAAO;;;;;AAMT,SAAS,gBACP,MAC0C;AAC1C,SAAQ,MAAR;EACE,KAAK,YACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK;EACL,QACE,QAAO;;;AAIb,IAAsB,yBAAtB,MAA2E;CAIzE,MAAM,OACJ,SACA,OAC6B;EAC7B,MAAM,UACH,MAAM,KAAK,KAAK,QAAQ,UAAU,IAAK,KAAK,gBAAgB,QAAQ;EACvE,MAAMA,aAA+B;GACnC,IAAI,YAAY;GAChB,WAAW,MAAM,6BAAa,IAAI,MAAM;GACxC,GAAG;GACJ;AACD,UAAQ,OAAO,QAAQ,KAAK,WAAW;AACvC,QAAM,KAAK,KAAK,QAAQ;AACxB,SAAO;;CAGT,MAAM,UACJ,UAC0C;CAI5C,MAAM,MAAM,UAA4C;CAIxD,AAAU,gBAAgB,SAAgD;AACxE,SAAO;GACL;GACA,QAAQ,EACN,SAAS,QAAQ,SAAS,KAAuB,aAAa;IAC5D,IAAI,YAAY;IAChB,2BAAW,IAAI,MAAM;IACrB,MAAM,gBAAgB,QAAQ,KAAK;IACnC,SAAS,sBAAsB,QAAQ;IACxC,EAAE,EACJ;GACF;;;AAIL,SAAgB,qBACd,SACA,SACA,SACA;AACA,KAAI,CAAC,QAAS;AACd,CAAK,QAAQ,OAAO,SAAS;EAC3B,MAAM,QAAQ;EACd,SAAS,2BAA2B,QAAQ;EAC5C,UAAU,QAAQ;EACnB,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,3 @@
+import { jsonSchemaToZod, jsonSchemaToZodSafe } from "./json-schema-to-zod.js";
+import { SchemaOutput, enumToChoiceOutput, jsonSchemaToArrayOutput, jsonSchemaToOutput, textOutput, zodToOutput } from "./schema-output.js";
+export { SchemaOutput, enumToChoiceOutput, jsonSchemaToArrayOutput, jsonSchemaToOutput, jsonSchemaToZod, jsonSchemaToZodSafe, textOutput, zodToOutput };

package/dist/schema/index.js

@@ -0,0 +1,4 @@
+import { jsonSchemaToZod, jsonSchemaToZodSafe } from "./json-schema-to-zod.js";
+import { SchemaOutput, enumToChoiceOutput, jsonSchemaToArrayOutput, jsonSchemaToOutput, textOutput, zodToOutput } from "./schema-output.js";
+
+export { SchemaOutput, enumToChoiceOutput, jsonSchemaToArrayOutput, jsonSchemaToOutput, jsonSchemaToZod, jsonSchemaToZodSafe, textOutput, zodToOutput };

package/dist/schema/json-schema-to-zod.d.ts

@@ -0,0 +1,55 @@
+import { ZodType } from "zod";
+
+//#region src/schema/json-schema-to-zod.d.ts
+
+/**
+ * JSON Schema type definitions for conversion.
+ */
+interface JsonSchema {
+  type?: string;
+  properties?: Record<string, JsonSchema>;
+  required?: string[];
+  items?: JsonSchema;
+  enum?: (string | number | boolean)[];
+  const?: unknown;
+  anyOf?: JsonSchema[];
+  oneOf?: JsonSchema[];
+  allOf?: JsonSchema[];
+  description?: string;
+  default?: unknown;
+  minimum?: number;
+  maximum?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+  format?: string;
+  nullable?: boolean;
+  [key: string]: unknown;
+}
+/**
+ * Convert a JSON Schema to a Zod schema.
+ *
+ * Supports common JSON Schema types and constraints:
+ * - string, number, integer, boolean, null
+ * - object with properties and required
+ * - array with items
+ * - enum and const
+ * - anyOf, oneOf, allOf
+ * - format constraints (email, uri, uuid, date-time)
+ * - numeric constraints (minimum, maximum)
+ * - string constraints (minLength, maxLength, pattern)
+ *
+ * @param schema - JSON Schema object
+ * @returns Zod schema
+ */
+declare function jsonSchemaToZod(schema: JsonSchema | Record<string, unknown>): ZodType;
+/**
+ * Convert a JSON Schema to a Zod schema with a default empty object fallback.
+ *
+ * @param schema - Optional JSON Schema object
+ * @returns Zod schema (defaults to empty object schema)
+ */
+declare function jsonSchemaToZodSafe(schema?: Record<string, unknown>): ZodType;
+//#endregion
+export { jsonSchemaToZod, jsonSchemaToZodSafe };
+//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/dist/schema/json-schema-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.d.ts","names":[],"sources":["../../src/schema/json-schema-to-zod.ts"],"sourcesContent":[],"mappings":";;;;;;AAAsC;UAK5B,UAAA,CAEoB;EAAf,IAAA,CAAA,EAAA,MAAA;EAEL,UAAA,CAAA,EAFK,MAEL,CAAA,MAAA,EAFoB,UAEpB,CAAA;EAGA,QAAA,CAAA,EAAA,MAAA,EAAA;EACA,KAAA,CAAA,EAJA,UAIA;EACA,IAAA,CAAA,EAAA,CAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA,EAAA;EAAU,KAAA,CAAA,EAAA,OAAA;EA6BJ,KAAA,CAAA,EA/BN,UA+BqB,EAAA;EACrB,KAAA,CAAA,EA/BA,UA+BA,EAAA;EAAa,KAAA,CAAA,EA9Bb,UA8Ba,EAAA;EACpB,WAAA,CAAA,EAAA,MAAA;EAAO,OAAA,CAAA,EAAA,OAAA;EAyKM,OAAA,CAAA,EAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;iBA3KA,eAAA,SACN,aAAa,0BACpB;;;;;;;iBAyKa,mBAAA,UAA6B,0BAA0B"}

package/dist/schema/json-schema-to-zod.js

@@ -0,0 +1,124 @@
+import { z } from "zod";
+
+//#region src/schema/json-schema-to-zod.ts
+/**
+* Convert a JSON Schema to a Zod schema.
+*
+* Supports common JSON Schema types and constraints:
+* - string, number, integer, boolean, null
+* - object with properties and required
+* - array with items
+* - enum and const
+* - anyOf, oneOf, allOf
+* - format constraints (email, uri, uuid, date-time)
+* - numeric constraints (minimum, maximum)
+* - string constraints (minLength, maxLength, pattern)
+*
+* @param schema - JSON Schema object
+* @returns Zod schema
+*/
+function jsonSchemaToZod(schema) {
+	const s = schema;
+	const makeNullable = (zodSchema) => {
+		return s.nullable ? z.union([zodSchema, z.null()]) : zodSchema;
+	};
+	if (s.const !== void 0) return z.literal(s.const);
+	if (s.enum) {
+		const values = s.enum;
+		return makeNullable(z.enum(values.map(String)));
+	}
+	if (s.anyOf && s.anyOf.length > 0) {
+		const schemas = s.anyOf.map((sub) => jsonSchemaToZod(sub));
+		if (schemas.length === 1) return schemas[0] ?? z.unknown();
+		return z.union([
+			schemas[0] ?? z.unknown(),
+			schemas[1] ?? z.unknown(),
+			...schemas.slice(2)
+		]);
+	}
+	if (s.oneOf && s.oneOf.length > 0) {
+		const schemas = s.oneOf.map((sub) => jsonSchemaToZod(sub));
+		if (schemas.length === 1) return schemas[0] ?? z.unknown();
+		return z.union([
+			schemas[0] ?? z.unknown(),
+			schemas[1] ?? z.unknown(),
+			...schemas.slice(2)
+		]);
+	}
+	if (s.allOf && s.allOf.length > 0) return s.allOf.map((sub) => jsonSchemaToZod(sub)).reduce((acc, curr) => z.intersection(acc, curr));
+	switch (s.type) {
+		case "string": return makeNullable(buildStringSchema(s));
+		case "number":
+		case "integer": return makeNullable(buildNumberSchema(s));
+		case "boolean": return makeNullable(z.boolean());
+		case "null": return z.null();
+		case "array": return makeNullable(buildArraySchema(s));
+		case "object": return makeNullable(buildObjectSchema(s));
+		default: return z.unknown();
+	}
+}
+function buildStringSchema(schema) {
+	let zodSchema = z.string();
+	if (schema.description) zodSchema = zodSchema.describe(schema.description);
+	switch (schema.format) {
+		case "email":
+			zodSchema = zodSchema.email();
+			break;
+		case "uri":
+		case "url":
+			zodSchema = zodSchema.url();
+			break;
+		case "uuid":
+			zodSchema = zodSchema.uuid();
+			break;
+		case "date-time":
+			zodSchema = zodSchema.datetime();
+			break;
+		case "date":
+			zodSchema = zodSchema.date();
+			break;
+	}
+	if (schema.minLength !== void 0) zodSchema = zodSchema.min(schema.minLength);
+	if (schema.maxLength !== void 0) zodSchema = zodSchema.max(schema.maxLength);
+	if (schema.pattern) zodSchema = zodSchema.regex(new RegExp(schema.pattern));
+	return zodSchema;
+}
+function buildNumberSchema(schema) {
+	let zodSchema = schema.type === "integer" ? z.number().int() : z.number();
+	if (schema.description) zodSchema = zodSchema.describe(schema.description);
+	if (schema.minimum !== void 0) zodSchema = zodSchema.min(schema.minimum);
+	if (schema.maximum !== void 0) zodSchema = zodSchema.max(schema.maximum);
+	return zodSchema;
+}
+function buildArraySchema(schema) {
+	const itemsSchema = schema.items ? jsonSchemaToZod(schema.items) : z.unknown();
+	let zodSchema = z.array(itemsSchema);
+	if (schema.description) zodSchema = zodSchema.describe(schema.description);
+	return zodSchema;
+}
+function buildObjectSchema(schema) {
+	const properties = schema.properties ?? {};
+	const required = new Set(schema.required ?? []);
+	const shape = {};
+	for (const [key, propSchema] of Object.entries(properties)) {
+		const zodProp = jsonSchemaToZod(propSchema);
+		shape[key] = required.has(key) ? zodProp : zodProp.optional();
+	}
+	let zodSchema = z.object(shape);
+	if (schema.description) zodSchema = zodSchema.describe(schema.description);
+	return zodSchema;
+}
+/**
+* Convert a JSON Schema to a Zod schema with a default empty object fallback.
+*
+* @param schema - Optional JSON Schema object
+* @returns Zod schema (defaults to empty object schema)
+*/
+function jsonSchemaToZodSafe(schema) {
+	if (!schema || Object.keys(schema).length === 0) return z.object({});
+	return jsonSchemaToZod(schema);
+}
+
+//#endregion
+export { jsonSchemaToZod, jsonSchemaToZodSafe };
+//# sourceMappingURL=json-schema-to-zod.js.map

package/dist/schema/json-schema-to-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.js","names":["shape: Record<string, ZodType>"],"sources":["../../src/schema/json-schema-to-zod.ts"],"sourcesContent":["import { z, type ZodType } from 'zod';\n\n/**\n * JSON Schema type definitions for conversion.\n */\ninterface JsonSchema {\n  type?: string;\n  properties?: Record<string, JsonSchema>;\n  required?: string[];\n  items?: JsonSchema;\n  enum?: (string | number | boolean)[];\n  const?: unknown;\n  anyOf?: JsonSchema[];\n  oneOf?: JsonSchema[];\n  allOf?: JsonSchema[];\n  description?: string;\n  default?: unknown;\n  minimum?: number;\n  maximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  format?: string;\n  nullable?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * Convert a JSON Schema to a Zod schema.\n *\n * Supports common JSON Schema types and constraints:\n * - string, number, integer, boolean, null\n * - object with properties and required\n * - array with items\n * - enum and const\n * - anyOf, oneOf, allOf\n * - format constraints (email, uri, uuid, date-time)\n * - numeric constraints (minimum, maximum)\n * - string constraints (minLength, maxLength, pattern)\n *\n * @param schema - JSON Schema object\n * @returns Zod schema\n */\nexport function jsonSchemaToZod(\n  schema: JsonSchema | Record<string, unknown>\n): ZodType {\n  const s = schema as JsonSchema;\n\n  // Handle nullable\n  const makeNullable = (zodSchema: ZodType): ZodType => {\n    return s.nullable ? z.union([zodSchema, z.null()]) : zodSchema;\n  };\n\n  // Handle const\n  if (s.const !== undefined) {\n    return z.literal(s.const as string | number | boolean);\n  }\n\n  // Handle enum\n  if (s.enum) {\n    const values = s.enum as [\n      string | number | boolean,\n      ...(string | number | boolean)[],\n    ];\n    return makeNullable(z.enum(values.map(String) as [string, ...string[]]));\n  }\n\n  // Handle anyOf\n  if (s.anyOf && s.anyOf.length > 0) {\n    const schemas = s.anyOf.map((sub) => jsonSchemaToZod(sub));\n    if (schemas.length === 1) return schemas[0] ?? z.unknown();\n    return z.union([\n      schemas[0] ?? z.unknown(),\n      schemas[1] ?? z.unknown(),\n      ...schemas.slice(2),\n    ]);\n  }\n\n  // Handle oneOf (same as anyOf for Zod purposes)\n  if (s.oneOf && s.oneOf.length > 0) {\n    const schemas = s.oneOf.map((sub) => jsonSchemaToZod(sub));\n    if (schemas.length === 1) return schemas[0] ?? z.unknown();\n    return z.union([\n      schemas[0] ?? z.unknown(),\n      schemas[1] ?? z.unknown(),\n      ...schemas.slice(2),\n    ]);\n  }\n\n  // Handle allOf (intersection)\n  if (s.allOf && s.allOf.length > 0) {\n    const schemas = s.allOf.map((sub) => jsonSchemaToZod(sub));\n    return schemas.reduce((acc, curr) => z.intersection(acc, curr));\n  }\n\n  // Handle type\n  switch (s.type) {\n    case 'string':\n      return makeNullable(buildStringSchema(s));\n    case 'number':\n    case 'integer':\n      return makeNullable(buildNumberSchema(s));\n    case 'boolean':\n      return makeNullable(z.boolean());\n    case 'null':\n      return z.null();\n    case 'array':\n      return makeNullable(buildArraySchema(s));\n    case 'object':\n      return makeNullable(buildObjectSchema(s));\n    default:\n      // Unknown type, accept anything\n      return z.unknown();\n  }\n}\n\nfunction buildStringSchema(schema: JsonSchema): ZodType {\n  let zodSchema = z.string();\n\n  if (schema.description) {\n    zodSchema = zodSchema.describe(schema.description);\n  }\n\n  // Format constraints\n  switch (schema.format) {\n    case 'email':\n      zodSchema = zodSchema.email();\n      break;\n    case 'uri':\n    case 'url':\n      zodSchema = zodSchema.url();\n      break;\n    case 'uuid':\n      zodSchema = zodSchema.uuid();\n      break;\n    case 'date-time':\n      zodSchema = zodSchema.datetime();\n      break;\n    case 'date':\n      zodSchema = zodSchema.date();\n      break;\n  }\n\n  // Length constraints\n  if (schema.minLength !== undefined) {\n    zodSchema = zodSchema.min(schema.minLength);\n  }\n  if (schema.maxLength !== undefined) {\n    zodSchema = zodSchema.max(schema.maxLength);\n  }\n\n  // Pattern constraint\n  if (schema.pattern) {\n    zodSchema = zodSchema.regex(new RegExp(schema.pattern));\n  }\n\n  return zodSchema;\n}\n\nfunction buildNumberSchema(schema: JsonSchema): ZodType {\n  let zodSchema = schema.type === 'integer' ? z.number().int() : z.number();\n\n  if (schema.description) {\n    zodSchema = zodSchema.describe(schema.description);\n  }\n\n  if (schema.minimum !== undefined) {\n    zodSchema = zodSchema.min(schema.minimum);\n  }\n  if (schema.maximum !== undefined) {\n    zodSchema = zodSchema.max(schema.maximum);\n  }\n\n  return zodSchema;\n}\n\nfunction buildArraySchema(schema: JsonSchema): ZodType {\n  const itemsSchema = schema.items\n    ? jsonSchemaToZod(schema.items)\n    : z.unknown();\n  let zodSchema = z.array(itemsSchema);\n\n  if (schema.description) {\n    zodSchema = zodSchema.describe(schema.description);\n  }\n\n  return zodSchema;\n}\n\nfunction buildObjectSchema(schema: JsonSchema): ZodType {\n  const properties = schema.properties ?? {};\n  const required = new Set(schema.required ?? []);\n\n  const shape: Record<string, ZodType> = {};\n  for (const [key, propSchema] of Object.entries(properties)) {\n    const zodProp = jsonSchemaToZod(propSchema);\n    shape[key] = required.has(key) ? zodProp : zodProp.optional();\n  }\n\n  let zodSchema = z.object(shape);\n\n  if (schema.description) {\n    zodSchema = zodSchema.describe(schema.description);\n  }\n\n  return zodSchema;\n}\n\n/**\n * Convert a JSON Schema to a Zod schema with a default empty object fallback.\n *\n * @param schema - Optional JSON Schema object\n * @returns Zod schema (defaults to empty object schema)\n */\nexport function jsonSchemaToZodSafe(schema?: Record<string, unknown>): ZodType {\n  if (!schema || Object.keys(schema).length === 0) {\n    return z.object({});\n  }\n  return jsonSchemaToZod(schema);\n}\n"],"mappings":"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"}

package/dist/schema/schema-output.d.ts

@@ -0,0 +1,77 @@
+import { Output } from "ai";
+import { ZodType } from "zod";
+
+//#region src/schema/schema-output.d.ts
+
+/**
+ * Bridge between ContractSpec SchemaModel and AI SDK Output.
+ *
+ * This module provides utilities to convert ContractSpec schema definitions
+ * to AI SDK v6 Output.* structured output configurations.
+ */
+type ObjectOutputReturn = ReturnType<typeof Output.object>;
+type ArrayOutputReturn = ReturnType<typeof Output.array>;
+type ChoiceOutputReturn = ReturnType<typeof Output.choice>;
+type TextOutputReturn = ReturnType<typeof Output.text>;
+/**
+ * Create an AI SDK Output.object from a JSON Schema.
+ *
+ * @param schema - JSON Schema object
+ * @returns AI SDK Output configuration
+ */
+declare function jsonSchemaToOutput(schema: Record<string, unknown>): ObjectOutputReturn;
+/**
+ * Create an AI SDK Output.array from a JSON Schema items definition.
+ *
+ * @param itemSchema - JSON Schema for array items
+ * @returns AI SDK Output configuration
+ */
+declare function jsonSchemaToArrayOutput(itemSchema: Record<string, unknown>): ArrayOutputReturn;
+/**
+ * Create an AI SDK Output.choice from enum values.
+ *
+ * @param choices - Array of choice values
+ * @returns AI SDK Output configuration
+ */
+declare function enumToChoiceOutput(choices: string[]): ChoiceOutputReturn;
+/**
+ * Create an AI SDK Output from a Zod schema directly.
+ *
+ * @param schema - Zod schema
+ * @returns AI SDK Output configuration
+ */
+declare function zodToOutput<T extends ZodType>(schema: T): ObjectOutputReturn;
+/**
+ * Create a simple text output configuration.
+ *
+ * @returns AI SDK Output configuration for text
+ */
+declare function textOutput(): TextOutputReturn;
+/**
+ * Output builder that can be used fluently.
+ */
+declare const SchemaOutput: {
+  /**
+   * Create an object output from JSON Schema.
+   */
+  readonly fromJsonSchema: typeof jsonSchemaToOutput;
+  /**
+   * Create an array output from JSON Schema.
+   */
+  readonly arrayFromJsonSchema: typeof jsonSchemaToArrayOutput;
+  /**
+   * Create a choice output from enum.
+   */
+  readonly fromEnum: typeof enumToChoiceOutput;
+  /**
+   * Create an output from Zod schema.
+   */
+  readonly fromZod: typeof zodToOutput;
+  /**
+   * Create a text output.
+   */
+  readonly text: typeof textOutput;
+};
+//#endregion
+export { SchemaOutput, enumToChoiceOutput, jsonSchemaToArrayOutput, jsonSchemaToOutput, textOutput, zodToOutput };
+//# sourceMappingURL=schema-output.d.ts.map

package/dist/schema/schema-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-output.d.ts","names":[],"sources":["../../src/schema/schema-output.ts"],"sourcesContent":[],"mappings":";;;;;;;AACmC;AAWC;AACD;AACC;AASpC,KAXK,kBAAA,GAAqB,UAWQ,CACxB,OAZkC,MAAA,CAAO,MAahD,CAAA;AAaH,KAzBK,iBAAA,GAAoB,UAyBc,CAAA,OAzBI,MAAA,CAAO,KA2B/C,CAAA;AAaH,KAvCK,kBAAA,GAAqB,UAuCQ,CAAqB,OAvCX,MAAA,CAAO,MAuCsB,CAAA;AAYzE,KAlDK,gBAAA,GAAmB,UAkDG,CAAA,OAlDe,MAAA,CAAO,IAkDtB,CAAA;;;;;AAW3B;AAOA;iBA5DgB,kBAAA,SACN,0BACP;;;;;;;iBAaa,uBAAA,aACF,0BACX;;;;;;;iBAaa,kBAAA,qBAAuC;;;;;;;iBAYvC,sBAAsB,iBAAiB,IAAI;;;;;;iBAW3C,UAAA,CAAA,GAAc;;;;cAOjB"}

package/dist/schema/schema-output.js

@@ -0,0 +1,65 @@
+import { jsonSchemaToZod } from "./json-schema-to-zod.js";
+import { Output } from "ai";
+import "zod";
+
+//#region src/schema/schema-output.ts
+/**
+* Create an AI SDK Output.object from a JSON Schema.
+*
+* @param schema - JSON Schema object
+* @returns AI SDK Output configuration
+*/
+function jsonSchemaToOutput(schema) {
+	const zodSchema = jsonSchemaToZod(schema);
+	return Output.object({ schema: zodSchema });
+}
+/**
+* Create an AI SDK Output.array from a JSON Schema items definition.
+*
+* @param itemSchema - JSON Schema for array items
+* @returns AI SDK Output configuration
+*/
+function jsonSchemaToArrayOutput(itemSchema) {
+	const zodSchema = jsonSchemaToZod(itemSchema);
+	return Output.array({ element: zodSchema });
+}
+/**
+* Create an AI SDK Output.choice from enum values.
+*
+* @param choices - Array of choice values
+* @returns AI SDK Output configuration
+*/
+function enumToChoiceOutput(choices) {
+	return Output.choice({ options: choices });
+}
+/**
+* Create an AI SDK Output from a Zod schema directly.
+*
+* @param schema - Zod schema
+* @returns AI SDK Output configuration
+*/
+function zodToOutput(schema) {
+	return Output.object({ schema });
+}
+/**
+* Create a simple text output configuration.
+*
+* @returns AI SDK Output configuration for text
+*/
+function textOutput() {
+	return Output.text();
+}
+/**
+* Output builder that can be used fluently.
+*/
+const SchemaOutput = {
+	fromJsonSchema: jsonSchemaToOutput,
+	arrayFromJsonSchema: jsonSchemaToArrayOutput,
+	fromEnum: enumToChoiceOutput,
+	fromZod: zodToOutput,
+	text: textOutput
+};
+
+//#endregion
+export { SchemaOutput, enumToChoiceOutput, jsonSchemaToArrayOutput, jsonSchemaToOutput, textOutput, zodToOutput };
+//# sourceMappingURL=schema-output.js.map

package/dist/schema/schema-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-output.js","names":[],"sources":["../../src/schema/schema-output.ts"],"sourcesContent":["import { Output } from 'ai';\nimport { type ZodType } from 'zod';\nimport { jsonSchemaToZod } from './json-schema-to-zod';\n\n/**\n * Bridge between ContractSpec SchemaModel and AI SDK Output.\n *\n * This module provides utilities to convert ContractSpec schema definitions\n * to AI SDK v6 Output.* structured output configurations.\n */\n\n// Extract return types from Output functions for explicit type annotations\ntype ObjectOutputReturn = ReturnType<typeof Output.object>;\ntype ArrayOutputReturn = ReturnType<typeof Output.array>;\ntype ChoiceOutputReturn = ReturnType<typeof Output.choice>;\ntype TextOutputReturn = ReturnType<typeof Output.text>;\n\n/**\n * Create an AI SDK Output.object from a JSON Schema.\n *\n * @param schema - JSON Schema object\n * @returns AI SDK Output configuration\n */\nexport function jsonSchemaToOutput(\n  schema: Record<string, unknown>\n): ObjectOutputReturn {\n  const zodSchema = jsonSchemaToZod(schema);\n  return Output.object({\n    schema: zodSchema,\n  });\n}\n\n/**\n * Create an AI SDK Output.array from a JSON Schema items definition.\n *\n * @param itemSchema - JSON Schema for array items\n * @returns AI SDK Output configuration\n */\nexport function jsonSchemaToArrayOutput(\n  itemSchema: Record<string, unknown>\n): ArrayOutputReturn {\n  const zodSchema = jsonSchemaToZod(itemSchema);\n  return Output.array({\n    element: zodSchema,\n  });\n}\n\n/**\n * Create an AI SDK Output.choice from enum values.\n *\n * @param choices - Array of choice values\n * @returns AI SDK Output configuration\n */\nexport function enumToChoiceOutput(choices: string[]): ChoiceOutputReturn {\n  return Output.choice({\n    options: choices as [string, ...string[]],\n  });\n}\n\n/**\n * Create an AI SDK Output from a Zod schema directly.\n *\n * @param schema - Zod schema\n * @returns AI SDK Output configuration\n */\nexport function zodToOutput<T extends ZodType>(schema: T): ObjectOutputReturn {\n  return Output.object({\n    schema,\n  });\n}\n\n/**\n * Create a simple text output configuration.\n *\n * @returns AI SDK Output configuration for text\n */\nexport function textOutput(): TextOutputReturn {\n  return Output.text();\n}\n\n/**\n * Output builder that can be used fluently.\n */\nexport const SchemaOutput = {\n  /**\n   * Create an object output from JSON Schema.\n   */\n  fromJsonSchema: jsonSchemaToOutput,\n\n  /**\n   * Create an array output from JSON Schema.\n   */\n  arrayFromJsonSchema: jsonSchemaToArrayOutput,\n\n  /**\n   * Create a choice output from enum.\n   */\n  fromEnum: enumToChoiceOutput,\n\n  /**\n   * Create an output from Zod schema.\n   */\n  fromZod: zodToOutput,\n\n  /**\n   * Create a text output.\n   */\n  text: textOutput,\n} as const;\n"],"mappings":";;;;;;;;;;;AAuBA,SAAgB,mBACd,QACoB;CACpB,MAAM,YAAY,gBAAgB,OAAO;AACzC,QAAO,OAAO,OAAO,EACnB,QAAQ,WACT,CAAC;;;;;;;;AASJ,SAAgB,wBACd,YACmB;CACnB,MAAM,YAAY,gBAAgB,WAAW;AAC7C,QAAO,OAAO,MAAM,EAClB,SAAS,WACV,CAAC;;;;;;;;AASJ,SAAgB,mBAAmB,SAAuC;AACxE,QAAO,OAAO,OAAO,EACnB,SAAS,SACV,CAAC;;;;;;;;AASJ,SAAgB,YAA+B,QAA+B;AAC5E,QAAO,OAAO,OAAO,EACnB,QACD,CAAC;;;;;;;AAQJ,SAAgB,aAA+B;AAC7C,QAAO,OAAO,MAAM;;;;;AAMtB,MAAa,eAAe;CAI1B,gBAAgB;CAKhB,qBAAqB;CAKrB,UAAU;CAKV,SAAS;CAKT,MAAM;CACP"}

package/dist/session/index.d.ts

@@ -0,0 +1,2 @@
+import { AgentSessionStore, InMemorySessionStore, createInMemorySessionStore, generateSessionId } from "./store.js";
+export { AgentSessionStore, InMemorySessionStore, createInMemorySessionStore, generateSessionId };

package/dist/session/index.js

@@ -0,0 +1,3 @@
+import { InMemorySessionStore, createInMemorySessionStore, generateSessionId } from "./store.js";
+
+export { InMemorySessionStore, createInMemorySessionStore, generateSessionId };

package/dist/session/store.d.ts

@@ -0,0 +1,74 @@
+import { AgentSessionState } from "../types.js";
+import { ModelMessage, StepResult, ToolSet } from "ai";
+
+//#region src/session/store.d.ts
+
+/**
+ * Interface for persisting agent session state.
+ *
+ * Implementations can use in-memory storage, databases,
+ * or external services like Redis.
+ */
+interface AgentSessionStore {
+  /**
+   * Get a session by ID.
+   */
+  get(sessionId: string): Promise<AgentSessionState | null>;
+  /**
+   * Create a new session.
+   */
+  create(session: Omit<AgentSessionState, 'createdAt' | 'updatedAt'>): Promise<AgentSessionState>;
+  /**
+   * Append a step to a session.
+   */
+  appendStep(sessionId: string, step: StepResult<ToolSet>): Promise<void>;
+  /**
+   * Append a message to a session.
+   */
+  appendMessage(sessionId: string, message: ModelMessage): Promise<void>;
+  /**
+   * Update session properties.
+   */
+  update(sessionId: string, updates: Partial<Pick<AgentSessionState, 'status' | 'metadata'>>): Promise<void>;
+  /**
+   * Delete a session.
+   */
+  delete(sessionId: string): Promise<boolean>;
+  /**
+   * List sessions by agent ID.
+   */
+  listByAgent(agentId: string, limit?: number): Promise<AgentSessionState[]>;
+  /**
+   * List sessions by tenant ID.
+   */
+  listByTenant(tenantId: string, limit?: number): Promise<AgentSessionState[]>;
+}
+/**
+ * In-memory session store for development and testing.
+ */
+declare class InMemorySessionStore implements AgentSessionStore {
+  private readonly sessions;
+  get(sessionId: string): Promise<AgentSessionState | null>;
+  create(session: Omit<AgentSessionState, 'createdAt' | 'updatedAt'>): Promise<AgentSessionState>;
+  appendStep(sessionId: string, step: StepResult<ToolSet>): Promise<void>;
+  appendMessage(sessionId: string, message: ModelMessage): Promise<void>;
+  update(sessionId: string, updates: Partial<Pick<AgentSessionState, 'status' | 'metadata'>>): Promise<void>;
+  delete(sessionId: string): Promise<boolean>;
+  listByAgent(agentId: string, limit?: number): Promise<AgentSessionState[]>;
+  listByTenant(tenantId: string, limit?: number): Promise<AgentSessionState[]>;
+  /**
+   * Clear all sessions (for testing).
+   */
+  clear(): void;
+}
+/**
+ * Create an in-memory session store.
+ */
+declare function createInMemorySessionStore(): AgentSessionStore;
+/**
+ * Generate a unique session ID.
+ */
+declare function generateSessionId(): string;
+//#endregion
+export { AgentSessionStore, InMemorySessionStore, createInMemorySessionStore, generateSessionId };
+//# sourceMappingURL=store.d.ts.map

package/dist/session/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","names":[],"sources":["../../src/session/store.ts"],"sourcesContent":[],"mappings":";;;;;;;AASA;;;;AAUa,UAVI,iBAAA,CAUJ;EACA;;;EAKyB,GAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAZZ,OAYY,CAZJ,iBAYI,GAAA,IAAA,CAAA;EAAsB;;;EAYlC,MAAA,CAAA,OAAA,EAlBb,IAkBa,CAlBR,iBAkBQ,EAAA,WAAA,GAAA,WAAA,CAAA,CAAA,EAjBrB,OAiBqB,CAjBb,iBAiBa,CAAA;EAAL;;;EAMQ,UAAA,CAAA,SAAA,EAAA,MAAA,EAAA,IAAA,EAlBS,UAkBT,CAlBoB,OAkBpB,CAAA,CAAA,EAlB+B,OAkB/B,CAAA,IAAA,CAAA;EAK2B;;;EAKN,aAAA,CAAA,SAAA,EAAA,MAAA,EAAA,OAAA,EAvBN,YAuBM,CAAA,EAvBS,OAuBT,CAAA,IAAA,CAAA;EAAO;AAMzD;;EAGgC,MAAA,CAAA,SAAA,EAAA,MAAA,EAAA,OAAA,EAzBnB,OAyBmB,CAzBX,IAyBW,CAzBN,iBAyBM,EAAA,QAAA,GAAA,UAAA,CAAA,CAAA,CAAA,EAxB3B,OAwB2B,CAAA,IAAA,CAAA;EAKd;;;EACb,MAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAzBwB,OAyBxB,CAAA,OAAA,CAAA;EAagB;;;EAS6B,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EA1CF,OA0CE,CA1CM,iBA0CN,EAAA,CAAA;EAAe;;;EAUpD,YAAA,CAAA,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,MAAA,CAAA,EA/CqC,OA+CrC,CA/C6C,iBA+C7C,EAAA,CAAA;;;;;AA+BA,cAxEA,oBAAA,YAAgC,iBAwEhC,CAAA;EAAR,iBAAA,QAAA;EAxEwC,GAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAGb,OAHa,CAGL,iBAHK,GAAA,IAAA,CAAA;EAAiB,MAAA,CAAA,OAAA,EAQjD,IARiD,CAQ5C,iBAR4C,EAAA,WAAA,GAAA,WAAA,CAAA,CAAA,EASzD,OATyD,CASjD,iBATiD,CAAA;EAgG9C,UAAA,CAAA,SAAA,EAAA,MAAA,EAA0B,IAAA,EA1EhC,UA0EoC,CA1EzB,OA0EyB,CAAA,CAAA,EAzEzC,OAyE0D,CAAA,IAAA,CAAA;EAO/C,aAAA,CAAA,SAAiB,EAAA,MAAA,EAAA,OAAA,EAxEiB,YAwEjB,CAAA,EAxEgC,OAwEhC,CAAA,IAAA,CAAA;qCA9DpB,QAAQ,KAAK,6CACrB;6BAO8B;gDAO9B,QAAQ;kDAgBR,QAAQ;;;;;;;;;iBAwBG,0BAAA,CAAA,GAA8B;;;;iBAO9B,iBAAA,CAAA"}

package/dist/session/store.js

@@ -0,0 +1,79 @@
+//#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

@@ -0,0 +1,4 @@
+import { agentKey, defineAgent } from "./spec.js";
+import { AgentRegistry, createAgentRegistry } from "./registry.js";
+
+export { AgentRegistry, agentKey, createAgentRegistry, defineAgent };