agent-framework-js 0.1.1

package/dist/chunk-V472N2PK.js

@@ -0,0 +1,91 @@
+import { Thread } from './chunk-XPXTXOYQ.js';
+import { requireCapability } from './chunk-ACBIHS5H.js';
+
+// src/persistence/store.ts
+var ThreadPersistence = {
+  /** Persist a thread under the key `thread:<id>`. */
+  async save(store, thread) {
+    await store.set(`thread:${thread.id}`, thread.toJSON());
+  },
+  /** Load and rehydrate a thread, or undefined if absent. */
+  async load(store, id) {
+    const data = await store.get(`thread:${id}`);
+    return data ? Thread.fromJSON(data) : void 0;
+  }
+};
+
+// src/persistence/memory.ts
+function createMemoryStore() {
+  const map = /* @__PURE__ */ new Map();
+  return {
+    async get(key) {
+      return map.get(key);
+    },
+    async set(key, value) {
+      map.set(key, value);
+    },
+    async delete(key) {
+      map.delete(key);
+    }
+  };
+}
+
+// src/persistence/browser.ts
+function createBrowserStore(options = {}) {
+  const backend = options.backend ?? "local";
+  const ns = options.namespace ?? "afjs";
+  return backend === "indexeddb" ? indexedDbStore(ns) : localStorageStore(ns);
+}
+function localStorageStore(ns) {
+  requireCapability("hasLocalStorage", "localStorage store");
+  const ls = globalThis.localStorage;
+  const k = (key) => `${ns}:${key}`;
+  return {
+    async get(key) {
+      const raw = ls.getItem(k(key));
+      return raw == null ? void 0 : JSON.parse(raw);
+    },
+    async set(key, value) {
+      ls.setItem(k(key), JSON.stringify(value));
+    },
+    async delete(key) {
+      ls.removeItem(k(key));
+    }
+  };
+}
+function indexedDbStore(ns) {
+  requireCapability("hasIndexedDB", "IndexedDB store");
+  const idb = globalThis.indexedDB;
+  function open() {
+    return new Promise((resolve, reject) => {
+      const req = idb.open(ns, 1);
+      req.onupgradeneeded = () => req.result.createObjectStore("kv");
+      req.onsuccess = () => resolve(req.result);
+      req.onerror = () => reject(req.error);
+    });
+  }
+  async function tx(mode, fn) {
+    const db = await open();
+    return new Promise((resolve, reject) => {
+      const store = db.transaction("kv", mode).objectStore("kv");
+      const req = fn(store);
+      req.onsuccess = () => resolve(req.result);
+      req.onerror = () => reject(req.error);
+    });
+  }
+  return {
+    async get(key) {
+      return tx("readonly", (s) => s.get(key));
+    },
+    async set(key, value) {
+      await tx("readwrite", (s) => s.put(value, key));
+    },
+    async delete(key) {
+      await tx("readwrite", (s) => s.delete(key));
+    }
+  };
+}
+
+export { ThreadPersistence, createBrowserStore, createMemoryStore };
+//# sourceMappingURL=chunk-V472N2PK.js.map
+//# sourceMappingURL=chunk-V472N2PK.js.map

package/dist/chunk-V472N2PK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/persistence/store.ts","../src/persistence/memory.ts","../src/persistence/browser.ts"],"names":[],"mappings":"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","file":"chunk-V472N2PK.js","sourcesContent":["/**\n * Pluggable storage abstraction for persisting conversation/thread state in a\n * no-backend environment. No database server is assumed. (FR-024)\n *\n * @packageDocumentation\n */\n\nimport type { Thread } from \"../agents/thread.js\";\nimport { Thread as ThreadClass } from \"../agents/thread.js\";\n\n/** A minimal key/value store. */\nexport interface Store {\n\tget(key: string): Promise<unknown | undefined>;\n\tset(key: string, value: unknown): Promise<void>;\n\tdelete(key: string): Promise<void>;\n}\n\n/** Save and load threads via a {@link Store}. */\nexport const ThreadPersistence = {\n\t/** Persist a thread under the key `thread:<id>`. */\n\tasync save(store: Store, thread: Thread): Promise<void> {\n\t\tawait store.set(`thread:${thread.id}`, thread.toJSON());\n\t},\n\t/** Load and rehydrate a thread, or undefined if absent. */\n\tasync load(store: Store, id: string): Promise<Thread | undefined> {\n\t\tconst data = (await store.get(`thread:${id}`)) as\n\t\t\t| { id: string; messages: never[]; compacted?: boolean }\n\t\t\t| undefined;\n\t\treturn data ? ThreadClass.fromJSON(data) : undefined;\n\t},\n};\n","/**\n * In-memory store adapter. Works in every runtime; ideal as a default and for tests.\n * @packageDocumentation\n */\n\nimport type { Store } from \"./store.js\";\n\n/** Create an in-memory {@link Store}. */\nexport function createMemoryStore(): Store {\n\tconst map = new Map<string, unknown>();\n\treturn {\n\t\tasync get(key) {\n\t\t\treturn map.get(key);\n\t\t},\n\t\tasync set(key, value) {\n\t\t\tmap.set(key, value);\n\t\t},\n\t\tasync delete(key) {\n\t\t\tmap.delete(key);\n\t\t},\n\t};\n}\n","/**\n * Browser store adapters backed by `localStorage` or `IndexedDB`. Capability-gated\n * so a clear typed error is thrown if used where unavailable. (FR-024, FR-030a)\n *\n * @packageDocumentation\n */\n\nimport type { Store } from \"./store.js\";\nimport { requireCapability } from \"../core/runtime.js\";\n\n/** Options for {@link createBrowserStore}. */\nexport interface BrowserStoreOptions {\n\t/** Storage backend. Default \"local\". */\n\tbackend?: \"local\" | \"indexeddb\";\n\t/** Key namespace/prefix. Default \"afjs\". */\n\tnamespace?: string;\n}\n\n/** Create a browser-backed {@link Store}. */\nexport function createBrowserStore(options: BrowserStoreOptions = {}): Store {\n\tconst backend = options.backend ?? \"local\";\n\tconst ns = options.namespace ?? \"afjs\";\n\treturn backend === \"indexeddb\" ? indexedDbStore(ns) : localStorageStore(ns);\n}\n\nfunction localStorageStore(ns: string): Store {\n\trequireCapability(\"hasLocalStorage\", \"localStorage store\");\n\tconst ls = (globalThis as unknown as { localStorage: Storage }).localStorage;\n\tconst k = (key: string) => `${ns}:${key}`;\n\treturn {\n\t\tasync get(key) {\n\t\t\tconst raw = ls.getItem(k(key));\n\t\t\treturn raw == null ? undefined : JSON.parse(raw);\n\t\t},\n\t\tasync set(key, value) {\n\t\t\tls.setItem(k(key), JSON.stringify(value));\n\t\t},\n\t\tasync delete(key) {\n\t\t\tls.removeItem(k(key));\n\t\t},\n\t};\n}\n\nfunction indexedDbStore(ns: string): Store {\n\trequireCapability(\"hasIndexedDB\", \"IndexedDB store\");\n\tconst idb = (globalThis as unknown as { indexedDB: IDBFactory }).indexedDB;\n\n\tfunction open(): Promise<IDBDatabase> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tconst req = idb.open(ns, 1);\n\t\t\treq.onupgradeneeded = () => req.result.createObjectStore(\"kv\");\n\t\t\treq.onsuccess = () => resolve(req.result);\n\t\t\treq.onerror = () => reject(req.error);\n\t\t});\n\t}\n\n\tasync function tx<T>(mode: IDBTransactionMode, fn: (s: IDBObjectStore) => IDBRequest): Promise<T> {\n\t\tconst db = await open();\n\t\treturn new Promise<T>((resolve, reject) => {\n\t\t\tconst store = db.transaction(\"kv\", mode).objectStore(\"kv\");\n\t\t\tconst req = fn(store);\n\t\t\treq.onsuccess = () => resolve(req.result as T);\n\t\t\treq.onerror = () => reject(req.error);\n\t\t});\n\t}\n\n\treturn {\n\t\tasync get(key) {\n\t\t\treturn tx<unknown>(\"readonly\", (s) => s.get(key));\n\t\t},\n\t\tasync set(key, value) {\n\t\t\tawait tx(\"readwrite\", (s) => s.put(value, key));\n\t\t},\n\t\tasync delete(key) {\n\t\t\tawait tx(\"readwrite\", (s) => s.delete(key));\n\t\t},\n\t};\n}\n"]}

package/dist/chunk-V6O6SYAN.cjs

@@ -0,0 +1,43 @@
+'use strict';
+
+var chunkIJASUMIQ_cjs = require('./chunk-IJASUMIQ.cjs');
+
+// src/observability/tracing.ts
+var state = { enabled: false };
+function configureObservability(config) {
+  state.tracer = config.tracer;
+  state.enabled = config.enabled ?? !!config.tracer;
+}
+async function withSpan(name, attributes, fn) {
+  if (!state.enabled || !state.tracer) return fn();
+  const span = state.tracer.startSpan(name);
+  const safe = chunkIJASUMIQ_cjs.redact(attributes);
+  for (const [k, v] of Object.entries(safe)) {
+    span.setAttribute(k, typeof v === "object" ? JSON.stringify(v) : v);
+  }
+  try {
+    const result = await fn();
+    span.setStatus?.({ code: 1 });
+    return result;
+  } catch (e) {
+    span.setStatus?.({ code: 2, message: e.message });
+    span.recordException?.(chunkIJASUMIQ_cjs.redact({ message: e.message }));
+    throw e;
+  } finally {
+    span.end();
+  }
+}
+function isObservabilityEnabled() {
+  return state.enabled && !!state.tracer;
+}
+function resetObservability() {
+  state.tracer = void 0;
+  state.enabled = false;
+}
+
+exports.configureObservability = configureObservability;
+exports.isObservabilityEnabled = isObservabilityEnabled;
+exports.resetObservability = resetObservability;
+exports.withSpan = withSpan;
+//# sourceMappingURL=chunk-V6O6SYAN.cjs.map
+//# sourceMappingURL=chunk-V6O6SYAN.cjs.map

package/dist/chunk-V6O6SYAN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observability/tracing.ts"],"names":["redact"],"mappings":";;;;;AAqBA,IAAM,KAAA,GAA4B,EAAE,OAAA,EAAS,KAAA,EAAM;AAW5C,SAAS,uBAAuB,MAAA,EAAmC;AACzE,EAAA,KAAA,CAAM,SAAS,MAAA,CAAO,MAAA;AACtB,EAAA,KAAA,CAAM,OAAA,GAAU,MAAA,CAAO,OAAA,IAAW,CAAC,CAAC,MAAA,CAAO,MAAA;AAC5C;AAaA,eAAsB,QAAA,CACrB,IAAA,EACA,UAAA,EACA,EAAA,EACa;AACb,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,IAAW,CAAC,KAAA,CAAM,MAAA,SAAe,EAAA,EAAG;AAE/C,EAAA,MAAM,IAAA,GAAO,KAAA,CAAM,MAAA,CAAO,SAAA,CAAU,IAAI,CAAA;AACxC,EAAA,MAAM,IAAA,GAAOA,yBAAO,UAAU,CAAA;AAC9B,EAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,EAAG;AAC1C,IAAA,IAAA,CAAK,YAAA,CAAa,GAAG,OAAO,CAAA,KAAM,WAAW,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA,GAAK,CAAW,CAAA;AAAA,EAC9E;AACA,EAAA,IAAI;AACH,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,EAAG;AACxB,IAAA,IAAA,CAAK,SAAA,GAAY,EAAE,IAAA,EAAM,CAAA,EAAG,CAAA;AAC5B,IAAA,OAAO,MAAA;AAAA,EACR,SAAS,CAAA,EAAG;AACX,IAAA,IAAA,CAAK,YAAY,EAAE,IAAA,EAAM,GAAG,OAAA,EAAU,CAAA,CAAY,SAAS,CAAA;AAC3D,IAAA,IAAA,CAAK,kBAAkBA,wBAAA,CAAO,EAAE,SAAU,CAAA,CAAY,OAAA,EAAS,CAAC,CAAA;AAChE,IAAA,MAAM,CAAA;AAAA,EACP,CAAA,SAAE;AACD,IAAA,IAAA,CAAK,GAAA,EAAI;AAAA,EACV;AACD;AAGO,SAAS,sBAAA,GAAkC;AACjD,EAAA,OAAO,KAAA,CAAM,OAAA,IAAW,CAAC,CAAC,KAAA,CAAM,MAAA;AACjC;AAGO,SAAS,kBAAA,GAA2B;AAC1C,EAAA,KAAA,CAAM,MAAA,GAAS,MAAA;AACf,EAAA,KAAA,CAAM,OAAA,GAAU,KAAA;AACjB","file":"chunk-V6O6SYAN.cjs","sourcesContent":["/**\n * Observability via OpenTelemetry. Consumers supply their own tracer/exporters;\n * the framework emits spans for agent/tool/provider/workflow operations and routes\n * all attributes and errors through redaction so no secret ever leaks. (FR-025,\n * FR-026, FR-026a)\n *\n * The `@opentelemetry/api` package is an optional peer dependency.\n *\n * @packageDocumentation\n */\n\nimport { redact } from \"../core/redaction.js\";\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\ntype Tracer = any;\n\ninterface ObservabilityState {\n\ttracer?: Tracer;\n\tenabled: boolean;\n}\n\nconst state: ObservabilityState = { enabled: false };\n\n/** Configuration for {@link configureObservability}. */\nexport interface ObservabilityConfig {\n\t/** A consumer-supplied OpenTelemetry tracer. */\n\ttracer?: Tracer;\n\t/** Whether tracing is active. Default false. */\n\tenabled?: boolean;\n}\n\n/** Enable/disable tracing and set the tracer. */\nexport function configureObservability(config: ObservabilityConfig): void {\n\tstate.tracer = config.tracer;\n\tstate.enabled = config.enabled ?? !!config.tracer;\n}\n\n/** Re-export of the redaction helper for convenience. (FR-026a) */\nexport { redact };\n\n/**\n * Run `fn` inside a span named `name`. Attributes are redacted before being set.\n * If tracing is disabled or no tracer is configured, `fn` runs without a span.\n *\n * @param name - Span name, e.g. `agent.run`, `tool.invoke`.\n * @param attributes - Span attributes (redacted automatically).\n * @param fn - The operation to trace.\n */\nexport async function withSpan<T>(\n\tname: string,\n\tattributes: Record<string, unknown>,\n\tfn: () => Promise<T>,\n): Promise<T> {\n\tif (!state.enabled || !state.tracer) return fn();\n\n\tconst span = state.tracer.startSpan(name);\n\tconst safe = redact(attributes);\n\tfor (const [k, v] of Object.entries(safe)) {\n\t\tspan.setAttribute(k, typeof v === \"object\" ? JSON.stringify(v) : (v as never));\n\t}\n\ttry {\n\t\tconst result = await fn();\n\t\tspan.setStatus?.({ code: 1 }); // OK\n\t\treturn result;\n\t} catch (e) {\n\t\tspan.setStatus?.({ code: 2, message: (e as Error).message }); // ERROR\n\t\tspan.recordException?.(redact({ message: (e as Error).message }));\n\t\tthrow e;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n\n/** Whether tracing is currently active. */\nexport function isObservabilityEnabled(): boolean {\n\treturn state.enabled && !!state.tracer;\n}\n\n/** Reset observability state — intended for tests. */\nexport function resetObservability(): void {\n\tstate.tracer = undefined;\n\tstate.enabled = false;\n}\n"]}

package/dist/chunk-VLSVL5N2.js

@@ -0,0 +1,48 @@
+import { createAgent } from './chunk-RD5YUB2E.js';
+import { ValidationError } from './chunk-IXV4UIF5.js';
+
+// src/declarative/loader.ts
+function looksLikeJson(source) {
+  const t = source.trimStart();
+  return t.startsWith("{") || t.startsWith("[");
+}
+async function parse(source) {
+  if (looksLikeJson(source)) {
+    try {
+      return JSON.parse(source);
+    } catch (e) {
+      throw new ValidationError(`Invalid JSON definition: ${e.message}`);
+    }
+  }
+  const YAML = await import('yaml');
+  try {
+    return YAML.parse(source);
+  } catch (e) {
+    throw new ValidationError(`Invalid YAML definition: ${e.message}`);
+  }
+}
+function assertDefinition(value) {
+  const d = value;
+  if (!d || typeof d.name !== "string" || typeof d.instructions !== "string" || !d.provider) {
+    throw new ValidationError("Definition must include name, instructions, and provider");
+  }
+}
+async function loadAgentDefinition(source, deps) {
+  const parsed = await parse(source);
+  assertDefinition(parsed);
+  const provider = deps.providerFactory(parsed.provider, deps.getCredential);
+  const tools = (parsed.tools ?? []).map((name) => deps.tools?.[name]).filter((t) => !!t);
+  const skills = (parsed.skills ?? []).map((name) => deps.skills?.[name]).filter((s) => !!s);
+  return createAgent({
+    name: parsed.name,
+    instructions: parsed.instructions,
+    provider,
+    tools,
+    skills,
+    maxIterations: parsed.maxIterations
+  });
+}
+
+export { loadAgentDefinition };
+//# sourceMappingURL=chunk-VLSVL5N2.js.map
+//# sourceMappingURL=chunk-VLSVL5N2.js.map

package/dist/chunk-VLSVL5N2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/declarative/loader.ts"],"names":[],"mappings":";;;;AA+CA,SAAS,cAAc,MAAA,EAAyB;AAC/C,EAAA,MAAM,CAAA,GAAI,OAAO,SAAA,EAAU;AAC3B,EAAA,OAAO,EAAE,UAAA,CAAW,GAAG,CAAA,IAAK,CAAA,CAAE,WAAW,GAAG,CAAA;AAC7C;AAEA,eAAe,MAAM,MAAA,EAAkC;AACtD,EAAA,IAAI,aAAA,CAAc,MAAM,CAAA,EAAG;AAC1B,IAAA,IAAI;AACH,MAAA,OAAO,IAAA,CAAK,MAAM,MAAM,CAAA;AAAA,IACzB,SAAS,CAAA,EAAG;AACX,MAAA,MAAM,IAAI,eAAA,CAAgB,CAAA,yBAAA,EAA6B,CAAA,CAAY,OAAO,CAAA,CAAE,CAAA;AAAA,IAC7E;AAAA,EACD;AAEA,EAAA,MAAM,IAAA,GAAO,MAAM,OAAO,MAAM,CAAA;AAChC,EAAA,IAAI;AACH,IAAA,OAAO,IAAA,CAAK,MAAM,MAAM,CAAA;AAAA,EACzB,SAAS,CAAA,EAAG;AACX,IAAA,MAAM,IAAI,eAAA,CAAgB,CAAA,yBAAA,EAA6B,CAAA,CAAY,OAAO,CAAA,CAAE,CAAA;AAAA,EAC7E;AACD;AAEA,SAAS,iBAAiB,KAAA,EAAkD;AAC3E,EAAA,MAAM,CAAA,GAAI,KAAA;AACV,EAAA,IAAI,CAAC,CAAA,IAAK,OAAO,CAAA,CAAE,IAAA,KAAS,QAAA,IAAY,OAAO,CAAA,CAAE,YAAA,KAAiB,QAAA,IAAY,CAAC,CAAA,CAAE,QAAA,EAAU;AAC1F,IAAA,MAAM,IAAI,gBAAgB,0DAA0D,CAAA;AAAA,EACrF;AACD;AAaA,eAAsB,mBAAA,CAAoB,QAAgB,IAAA,EAAkC;AAC3F,EAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,MAAM,CAAA;AACjC,EAAA,gBAAA,CAAiB,MAAM,CAAA;AAEvB,EAAA,MAAM,WAAW,IAAA,CAAK,eAAA,CAAgB,MAAA,CAAO,QAAA,EAAU,KAAK,aAAa,CAAA;AACzE,EAAA,MAAM,SAAS,MAAA,CAAO,KAAA,IAAS,EAAC,EAC9B,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,KAAA,GAAQ,IAAI,CAAC,CAAA,CAChC,MAAA,CAAO,CAAC,CAAA,KAAiB,CAAC,CAAC,CAAC,CAAA;AAC9B,EAAA,MAAM,UAAU,MAAA,CAAO,MAAA,IAAU,EAAC,EAChC,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,GAAS,IAAI,CAAC,CAAA,CACjC,MAAA,CAAO,CAAC,CAAA,KAAkB,CAAC,CAAC,CAAC,CAAA;AAE/B,EAAA,OAAO,WAAA,CAAY;AAAA,IAClB,MAAM,MAAA,CAAO,IAAA;AAAA,IACb,cAAc,MAAA,CAAO,YAAA;AAAA,IACrB,QAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IACA,eAAe,MAAA,CAAO;AAAA,GACtB,CAAA;AACF","file":"chunk-VLSVL5N2.js","sourcesContent":["/**\n * Declarative agent definitions. Agents can be defined in YAML or JSON against a\n * single shared schema; the loader auto-detects the format (the YAML parser is\n * lazy-loaded so JSON-only/browser use pays no cost) and builds an equivalent\n * runnable agent. Credentials are still injected via callback, never embedded.\n * (FR-027, FR-005a)\n *\n * @packageDocumentation\n */\n\nimport type { ModelCapabilities } from \"../core/types.js\";\nimport type { Provider } from \"../providers/provider.js\";\nimport type { Tool } from \"../tools/tool.js\";\nimport type { Skill } from \"../skills/skill.js\";\nimport { createAgent, type Agent } from \"../agents/agent.js\";\nimport { ValidationError } from \"../core/errors.js\";\n\n/** Provider section of a declarative definition. */\nexport interface ProviderDefinition extends ModelCapabilities {\n\ttype: \"copilot\" | \"openai-compatible\";\n\tbaseUrl?: string;\n}\n\n/** A declarative agent definition (shared by YAML and JSON). */\nexport interface AgentDefinition {\n\tname: string;\n\tinstructions: string;\n\tprovider: ProviderDefinition;\n\t/** Names referencing tools provided in `deps.tools`. */\n\ttools?: string[];\n\t/** Names referencing skills provided in `deps.skills`. */\n\tskills?: string[];\n\tmaxIterations?: number;\n}\n\n/** Dependencies the loader needs to construct a live agent. */\nexport interface LoaderDeps {\n\t/** Build a provider from the definition + injected credential. */\n\tproviderFactory: (def: ProviderDefinition, getCredential: () => string | Promise<string>) => Provider;\n\t/** Credential callback — never embedded in the definition. (FR-005a) */\n\tgetCredential: () => string | Promise<string>;\n\t/** Registered tools available for reference by name. */\n\ttools?: Record<string, Tool>;\n\t/** Registered skills available for reference by name. */\n\tskills?: Record<string, Skill>;\n}\n\nfunction looksLikeJson(source: string): boolean {\n\tconst t = source.trimStart();\n\treturn t.startsWith(\"{\") || t.startsWith(\"[\");\n}\n\nasync function parse(source: string): Promise<unknown> {\n\tif (looksLikeJson(source)) {\n\t\ttry {\n\t\t\treturn JSON.parse(source);\n\t\t} catch (e) {\n\t\t\tthrow new ValidationError(`Invalid JSON definition: ${(e as Error).message}`);\n\t\t}\n\t}\n\t// Lazy-load the YAML parser only when needed. (FR-027)\n\tconst YAML = await import(\"yaml\");\n\ttry {\n\t\treturn YAML.parse(source);\n\t} catch (e) {\n\t\tthrow new ValidationError(`Invalid YAML definition: ${(e as Error).message}`);\n\t}\n}\n\nfunction assertDefinition(value: unknown): asserts value is AgentDefinition {\n\tconst d = value as Partial<AgentDefinition>;\n\tif (!d || typeof d.name !== \"string\" || typeof d.instructions !== \"string\" || !d.provider) {\n\t\tthrow new ValidationError(\"Definition must include name, instructions, and provider\");\n\t}\n}\n\n/**\n * Load an agent from a YAML or JSON definition string.\n *\n * @example\n * ```ts\n * const agent = await loadAgentDefinition(yamlOrJson, {\n *   providerFactory,\n *   getCredential: () => process.env.LMSTUDIO_KEY ?? \"\",\n * });\n * ```\n */\nexport async function loadAgentDefinition(source: string, deps: LoaderDeps): Promise<Agent> {\n\tconst parsed = await parse(source);\n\tassertDefinition(parsed);\n\n\tconst provider = deps.providerFactory(parsed.provider, deps.getCredential);\n\tconst tools = (parsed.tools ?? [])\n\t\t.map((name) => deps.tools?.[name])\n\t\t.filter((t): t is Tool => !!t);\n\tconst skills = (parsed.skills ?? [])\n\t\t.map((name) => deps.skills?.[name])\n\t\t.filter((s): s is Skill => !!s);\n\n\treturn createAgent({\n\t\tname: parsed.name,\n\t\tinstructions: parsed.instructions,\n\t\tprovider,\n\t\ttools,\n\t\tskills,\n\t\tmaxIterations: parsed.maxIterations,\n\t});\n}\n"]}

package/dist/chunk-WSMYH2IN.cjs

@@ -0,0 +1,86 @@
+'use strict';
+
+// src/skills/skill.ts
+function defineSkill(skill) {
+  return skill;
+}
+async function loadSource(source) {
+  switch (source.kind) {
+    case "inline":
+      return source.content;
+    case "code":
+      return source.load();
+    case "file": {
+      const { readFile } = await import('fs/promises');
+      return readFile(source.path, "utf8");
+    }
+  }
+}
+
+// src/skills/index.ts
+var STOPWORDS = /* @__PURE__ */ new Set([
+  "the",
+  "a",
+  "an",
+  "and",
+  "or",
+  "of",
+  "to",
+  "in",
+  "for",
+  "on",
+  "is",
+  "are",
+  "with",
+  "how",
+  "what",
+  "do",
+  "does",
+  "i",
+  "you",
+  "it",
+  "this",
+  "that"
+]);
+function tokenize(text) {
+  return new Set(
+    text.toLowerCase().split(/[^a-z0-9]+/).filter((w) => w.length > 2 && !STOPWORDS.has(w))
+  );
+}
+var SkillIndex = class {
+  entries = [];
+  constructor(skills = []) {
+    for (const s of skills) this.add(s);
+  }
+  /** Add a skill to the index (description-only). */
+  add(skill) {
+    this.entries.push({ skill, tokens: tokenize(`${skill.name} ${skill.description}`) });
+  }
+  /**
+   * Select skills relevant to `prompt` by keyword overlap with their descriptions.
+   *
+   * @param prompt - The user prompt.
+   * @param minOverlap - Minimum overlapping tokens to count as relevant. Default 1.
+   */
+  select(prompt, minOverlap = 1) {
+    const promptTokens = tokenize(prompt);
+    const scored = [];
+    for (const { skill, tokens } of this.entries) {
+      let score = 0;
+      for (const t of tokens) if (promptTokens.has(t)) score++;
+      if (score >= minOverlap) scored.push({ skill, score });
+    }
+    return scored.sort((a, b) => b.score - a.score).map((s) => s.skill);
+  }
+  /** Load the full content of a selected skill (concatenated sources). (FR-017) */
+  async load(skill) {
+    const parts = await Promise.all(skill.sources.map(loadSource));
+    return parts.join("\n\n");
+  }
+};
+
+exports.SkillIndex = SkillIndex;
+exports.defineSkill = defineSkill;
+exports.loadSource = loadSource;
+//# sourceMappingURL=chunk-WSMYH2IN.cjs.map
+//# sourceMappingURL=chunk-WSMYH2IN.cjs.map

package/dist/chunk-WSMYH2IN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skills/skill.ts","../src/skills/index.ts"],"names":[],"mappings":";;;AAqCO,SAAS,YAAY,KAAA,EAAqB;AAChD,EAAA,OAAO,KAAA;AACR;AAGA,eAAsB,WAAW,MAAA,EAAsC;AACtE,EAAA,QAAQ,OAAO,IAAA;AAAM,IACpB,KAAK,QAAA;AACJ,MAAA,OAAO,MAAA,CAAO,OAAA;AAAA,IACf,KAAK,MAAA;AACJ,MAAA,OAAO,OAAO,IAAA,EAAK;AAAA,IACpB,KAAK,MAAA,EAAQ;AACZ,MAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,OAAO,aAAkB,CAAA;AACpD,MAAA,OAAO,QAAA,CAAS,MAAA,CAAO,IAAA,EAAM,MAAM,CAAA;AAAA,IACpC;AAAA;AAEF;;;ACvCA,IAAM,SAAA,uBAAgB,GAAA,CAAI;AAAA,EACzB,KAAA;AAAA,EAAO,GAAA;AAAA,EAAK,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,IAAA;AAAA,EAAM,KAAA;AAAA,EACpE,MAAA;AAAA,EAAQ,KAAA;AAAA,EAAO,MAAA;AAAA,EAAQ,IAAA;AAAA,EAAM,MAAA;AAAA,EAAQ,GAAA;AAAA,EAAK,KAAA;AAAA,EAAO,IAAA;AAAA,EAAM,MAAA;AAAA,EAAQ;AAChE,CAAC,CAAA;AAED,SAAS,SAAS,IAAA,EAA2B;AAC5C,EAAA,OAAO,IAAI,GAAA;AAAA,IACV,KACE,WAAA,EAAY,CACZ,KAAA,CAAM,YAAY,EAClB,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,CAAA,IAAK,CAAC,SAAA,CAAU,GAAA,CAAI,CAAC,CAAC;AAAA,GAClD;AACD;AAGO,IAAM,aAAN,MAAiB;AAAA,EACN,UAAwD,EAAC;AAAA,EAE1E,WAAA,CAAY,MAAA,GAAkB,EAAC,EAAG;AACjC,IAAA,KAAA,MAAW,CAAA,IAAK,MAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,CAAC,CAAA;AAAA,EACnC;AAAA;AAAA,EAGA,IAAI,KAAA,EAAoB;AACvB,IAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,EAAE,KAAA,EAAO,QAAQ,QAAA,CAAS,CAAA,EAAG,KAAA,CAAM,IAAI,CAAA,CAAA,EAAI,KAAA,CAAM,WAAW,CAAA,CAAE,GAAG,CAAA;AAAA,EACpF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAA,CAAO,MAAA,EAAgB,UAAA,GAAa,CAAA,EAAY;AAC/C,IAAA,MAAM,YAAA,GAAe,SAAS,MAAM,CAAA;AACpC,IAAA,MAAM,SAAiD,EAAC;AACxD,IAAA,KAAA,MAAW,EAAE,KAAA,EAAO,MAAA,EAAO,IAAK,KAAK,OAAA,EAAS;AAC7C,MAAA,IAAI,KAAA,GAAQ,CAAA;AACZ,MAAA,KAAA,MAAW,KAAK,MAAA,EAAQ,IAAI,YAAA,CAAa,GAAA,CAAI,CAAC,CAAA,EAAG,KAAA,EAAA;AACjD,MAAA,IAAI,SAAS,UAAA,EAAY,MAAA,CAAO,KAAK,EAAE,KAAA,EAAO,OAAO,CAAA;AAAA,IACtD;AACA,IAAA,OAAO,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,KAAA,GAAQ,CAAA,CAAE,KAAK,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,KAAK,CAAA;AAAA,EACnE;AAAA;AAAA,EAGA,MAAM,KAAK,KAAA,EAA+B;AACzC,IAAA,MAAM,KAAA,GAAQ,MAAM,OAAA,CAAQ,GAAA,CAAI,MAAM,OAAA,CAAQ,GAAA,CAAI,UAAU,CAAC,CAAA;AAC7D,IAAA,OAAO,KAAA,CAAM,KAAK,MAAM,CAAA;AAAA,EACzB;AACD","file":"chunk-WSMYH2IN.cjs","sourcesContent":["/**\n * Skills: domain-specific knowledge bundles attached to agents. Skills use\n * progressive disclosure — only a skill's short description is used to decide\n * relevance, and its full content is loaded only when the skill is deemed needed.\n * (FR-016, FR-017)\n *\n * @packageDocumentation\n */\n\n/** A source of skill content, loaded on demand. */\nexport type SkillSource =\n\t| { kind: \"inline\"; content: string }\n\t| { kind: \"file\"; path: string }\n\t| { kind: \"code\"; load: () => Promise<string> };\n\n/** A domain knowledge bundle. */\nexport interface Skill {\n\t/** Unique skill name. */\n\tname: string;\n\t/** Short description — the ONLY text used to decide relevance. (FR-017) */\n\tdescription: string;\n\t/** Content sources, read only when the skill is selected. */\n\tsources: SkillSource[];\n}\n\n/**\n * Define a skill.\n *\n * @example\n * ```ts\n * const refund = defineSkill({\n *   name: \"refund-policy\",\n *   description: \"Company refund and return rules.\",\n *   sources: [{ kind: \"inline\", content: \"Refunds allowed within 30 days...\" }],\n * });\n * ```\n */\nexport function defineSkill(skill: Skill): Skill {\n\treturn skill;\n}\n\n/** Read a single source's content. File sources require a Node runtime. */\nexport async function loadSource(source: SkillSource): Promise<string> {\n\tswitch (source.kind) {\n\t\tcase \"inline\":\n\t\t\treturn source.content;\n\t\tcase \"code\":\n\t\t\treturn source.load();\n\t\tcase \"file\": {\n\t\t\tconst { readFile } = await import(\"node:fs/promises\");\n\t\t\treturn readFile(source.path, \"utf8\");\n\t\t}\n\t}\n}\n","/**\n * Client-side keyword/text index over skill descriptions. No embeddings and no\n * extra provider — relevance is decided by simple token overlap so it runs fully\n * in the browser/edge. Full content is loaded only after a skill is selected.\n * (FR-017, FR-017a)\n *\n * @packageDocumentation\n */\n\nimport type { Skill } from \"./skill.js\";\nimport { loadSource } from \"./skill.js\";\n\nexport * from \"./skill.js\";\n\nconst STOPWORDS = new Set([\n\t\"the\", \"a\", \"an\", \"and\", \"or\", \"of\", \"to\", \"in\", \"for\", \"on\", \"is\", \"are\",\n\t\"with\", \"how\", \"what\", \"do\", \"does\", \"i\", \"you\", \"it\", \"this\", \"that\",\n]);\n\nfunction tokenize(text: string): Set<string> {\n\treturn new Set(\n\t\ttext\n\t\t\t.toLowerCase()\n\t\t\t.split(/[^a-z0-9]+/)\n\t\t\t.filter((w) => w.length > 2 && !STOPWORDS.has(w)),\n\t);\n}\n\n/** Indexes skills by description and selects relevant ones for a prompt. */\nexport class SkillIndex {\n\tprivate readonly entries: Array<{ skill: Skill; tokens: Set<string> }> = [];\n\n\tconstructor(skills: Skill[] = []) {\n\t\tfor (const s of skills) this.add(s);\n\t}\n\n\t/** Add a skill to the index (description-only). */\n\tadd(skill: Skill): void {\n\t\tthis.entries.push({ skill, tokens: tokenize(`${skill.name} ${skill.description}`) });\n\t}\n\n\t/**\n\t * Select skills relevant to `prompt` by keyword overlap with their descriptions.\n\t *\n\t * @param prompt - The user prompt.\n\t * @param minOverlap - Minimum overlapping tokens to count as relevant. Default 1.\n\t */\n\tselect(prompt: string, minOverlap = 1): Skill[] {\n\t\tconst promptTokens = tokenize(prompt);\n\t\tconst scored: Array<{ skill: Skill; score: number }> = [];\n\t\tfor (const { skill, tokens } of this.entries) {\n\t\t\tlet score = 0;\n\t\t\tfor (const t of tokens) if (promptTokens.has(t)) score++;\n\t\t\tif (score >= minOverlap) scored.push({ skill, score });\n\t\t}\n\t\treturn scored.sort((a, b) => b.score - a.score).map((s) => s.skill);\n\t}\n\n\t/** Load the full content of a selected skill (concatenated sources). (FR-017) */\n\tasync load(skill: Skill): Promise<string> {\n\t\tconst parts = await Promise.all(skill.sources.map(loadSource));\n\t\treturn parts.join(\"\\n\\n\");\n\t}\n}\n"]}

package/dist/chunk-XPXTXOYQ.js

@@ -0,0 +1,81 @@
+// src/core/types.ts
+function textMessage(role, text) {
+  return { role, parts: [{ type: "text", text }] };
+}
+function hasImage(message) {
+  return message.parts.some((p) => p.type === "image");
+}
+function messageText(message) {
+  return message.parts.filter((p) => p.type === "text").map((p) => p.text).join("");
+}
+
+// src/agents/thread.ts
+function estimateTokens(messages) {
+  const chars = messages.reduce((sum, m) => sum + messageText(m).length, 0);
+  return Math.ceil(chars / 4);
+}
+var Thread = class _Thread {
+  id;
+  messages;
+  /** Whether the thread has been compacted at least once. */
+  compacted = false;
+  constructor(id, messages = []) {
+    this.id = id ?? cryptoRandomId();
+    this.messages = messages;
+  }
+  /** Append a message. */
+  add(message) {
+    this.messages.push(message);
+  }
+  /** Serializable snapshot for persistence. */
+  toJSON() {
+    return { id: this.id, messages: this.messages, compacted: this.compacted };
+  }
+  /** Restore a thread from a snapshot. */
+  static fromJSON(data) {
+    const t = new _Thread(data.id, data.messages);
+    t.compacted = data.compacted ?? false;
+    return t;
+  }
+  /**
+   * Compact the thread if it exceeds the threshold. System messages and the most
+   * recent turn are preserved; older turns are summarized via the model.
+   *
+   * @returns true if compaction occurred.
+   */
+  async maybeCompact(provider, options) {
+    const threshold = options?.compactionThreshold ?? 0.9;
+    const limit = provider.capabilities.maxInputTokens * threshold;
+    if (estimateTokens(this.messages) < limit) return false;
+    const summarizer = options?.compactionModel ?? provider;
+    const system = this.messages.filter((m) => m.role === "system");
+    const recent = this.messages.slice(-2);
+    const toSummarize = this.messages.filter((m) => m.role !== "system").slice(0, -2);
+    if (toSummarize.length === 0) return false;
+    const summary = await summarizer.generate({
+      messages: [
+        textMessage(
+          "system",
+          "Summarize the following conversation compactly, preserving facts, decisions, and open questions."
+        ),
+        textMessage("user", toSummarize.map((m) => `${m.role}: ${messageText(m)}`).join("\n"))
+      ]
+    });
+    this.messages = [
+      ...system,
+      textMessage("system", `Summary of earlier conversation: ${summary.text}`),
+      ...recent
+    ];
+    this.compacted = true;
+    return true;
+  }
+};
+function cryptoRandomId() {
+  const c = globalThis.crypto;
+  if (c?.randomUUID) return c.randomUUID();
+  return `thread-${Math.random().toString(36).slice(2)}-${Date.now()}`;
+}
+
+export { Thread, estimateTokens, hasImage, messageText, textMessage };
+//# sourceMappingURL=chunk-XPXTXOYQ.js.map
+//# sourceMappingURL=chunk-XPXTXOYQ.js.map

package/dist/chunk-XPXTXOYQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types.ts","../src/agents/thread.ts"],"names":[],"mappings":"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","file":"chunk-XPXTXOYQ.js","sourcesContent":["/**\n * Shared content, message, and model-capability types used across the framework.\n *\n * These are the lowest-level building blocks: every higher-level module (agents,\n * providers, tools, workflows) speaks in terms of {@link Message} and\n * {@link ContentPart}. Keeping them dependency-free keeps the core tree-shakeable.\n *\n * @packageDocumentation\n */\n\n/** A JSON Schema object (draft 2020-12 compatible), as popularized by MCP. */\nexport type JSONSchema = Record<string, unknown>;\n\n/** Role of a message in a conversation. */\nexport type Role = \"system\" | \"user\" | \"assistant\" | \"tool\";\n\n/** A single piece of message content. Images are only valid for vision-capable models. */\nexport type ContentPart =\n\t| { type: \"text\"; text: string }\n\t| { type: \"image\"; data: string; mimeType: string };\n\n/**\n * A conversation message.\n *\n * @example\n * ```ts\n * const msg: Message = { role: \"user\", parts: [{ type: \"text\", text: \"Hi\" }] };\n * ```\n */\nexport interface Message {\n\trole: Role;\n\tparts: ContentPart[];\n\t/** Optional tool-call linkage for assistant/tool messages. */\n\ttoolCallId?: string;\n\t/** Optional display name (e.g., the tool name for a tool message). */\n\tname?: string;\n}\n\n/**\n * Per-model capabilities supplied by the caller. The framework cannot reliably\n * discover these for arbitrary OpenAI-compatible/LM Studio models, so they are\n * provided explicitly. (FR-007a)\n */\nexport interface ModelCapabilities {\n\t/** Model id/name. */\n\tmodel: string;\n\t/** Maximum input/context tokens; drives compaction threshold. */\n\tmaxInputTokens: number;\n\t/** Maximum output tokens. */\n\tmaxOutputTokens: number;\n\t/** Whether the model accepts image input. Defaults to false. */\n\tsupportsVision?: boolean;\n\t/** Whether the model emits separate reasoning/thinking content. Defaults to false. */\n\tsupportsReasoning?: boolean;\n}\n\n/** Convenience: build a user message from a plain string. */\nexport function textMessage(role: Role, text: string): Message {\n\treturn { role, parts: [{ type: \"text\", text }] };\n}\n\n/** Returns true if a message contains any image content part. */\nexport function hasImage(message: Message): boolean {\n\treturn message.parts.some((p) => p.type === \"image\");\n}\n\n/** Extract the concatenated text from a message. */\nexport function messageText(message: Message): string {\n\treturn message.parts\n\t\t.filter((p): p is { type: \"text\"; text: string } => p.type === \"text\")\n\t\t.map((p) => p.text)\n\t\t.join(\"\");\n}\n","/**\n * Conversation thread with automatic compaction. When a thread approaches the\n * model's input-token budget it is summarized into a compact form so the\n * conversation can continue. (FR-004, FR-004a, FR-004b)\n *\n * @packageDocumentation\n */\n\nimport type { Message } from \"../core/types.js\";\nimport { messageText, textMessage } from \"../core/types.js\";\nimport type { Provider } from \"../providers/provider.js\";\n\n/** Options controlling a thread's compaction behavior. */\nexport interface ThreadOptions {\n\t/** Fraction of `maxInputTokens` at which compaction triggers. Default 0.9. */\n\tcompactionThreshold?: number;\n\t/** Provider used to summarize; defaults to the agent's own provider. (FR-004b) */\n\tcompactionModel?: Provider;\n}\n\n/** Rough token estimate (~4 chars/token) — avoids a tokenizer dependency. */\nexport function estimateTokens(messages: Message[]): number {\n\tconst chars = messages.reduce((sum, m) => sum + messageText(m).length, 0);\n\treturn Math.ceil(chars / 4);\n}\n\n/** A multi-turn conversation that preserves context and compacts when large. */\nexport class Thread {\n\treadonly id: string;\n\tmessages: Message[];\n\t/** Whether the thread has been compacted at least once. */\n\tcompacted = false;\n\n\tconstructor(id?: string, messages: Message[] = []) {\n\t\tthis.id = id ?? cryptoRandomId();\n\t\tthis.messages = messages;\n\t}\n\n\t/** Append a message. */\n\tadd(message: Message): void {\n\t\tthis.messages.push(message);\n\t}\n\n\t/** Serializable snapshot for persistence. */\n\ttoJSON(): { id: string; messages: Message[]; compacted: boolean } {\n\t\treturn { id: this.id, messages: this.messages, compacted: this.compacted };\n\t}\n\n\t/** Restore a thread from a snapshot. */\n\tstatic fromJSON(data: { id: string; messages: Message[]; compacted?: boolean }): Thread {\n\t\tconst t = new Thread(data.id, data.messages);\n\t\tt.compacted = data.compacted ?? false;\n\t\treturn t;\n\t}\n\n\t/**\n\t * Compact the thread if it exceeds the threshold. System messages and the most\n\t * recent turn are preserved; older turns are summarized via the model.\n\t *\n\t * @returns true if compaction occurred.\n\t */\n\tasync maybeCompact(provider: Provider, options?: ThreadOptions): Promise<boolean> {\n\t\tconst threshold = options?.compactionThreshold ?? 0.9;\n\t\tconst limit = provider.capabilities.maxInputTokens * threshold;\n\t\tif (estimateTokens(this.messages) < limit) return false;\n\n\t\tconst summarizer = options?.compactionModel ?? provider;\n\t\tconst system = this.messages.filter((m) => m.role === \"system\");\n\t\tconst recent = this.messages.slice(-2);\n\t\tconst toSummarize = this.messages.filter((m) => m.role !== \"system\").slice(0, -2);\n\t\tif (toSummarize.length === 0) return false;\n\n\t\tconst summary = await summarizer.generate({\n\t\t\tmessages: [\n\t\t\t\ttextMessage(\n\t\t\t\t\t\"system\",\n\t\t\t\t\t\"Summarize the following conversation compactly, preserving facts, decisions, and open questions.\",\n\t\t\t\t),\n\t\t\t\ttextMessage(\"user\", toSummarize.map((m) => `${m.role}: ${messageText(m)}`).join(\"\\n\")),\n\t\t\t],\n\t\t});\n\n\t\tthis.messages = [\n\t\t\t...system,\n\t\t\ttextMessage(\"system\", `Summary of earlier conversation: ${summary.text}`),\n\t\t\t...recent,\n\t\t];\n\t\tthis.compacted = true;\n\t\treturn true;\n\t}\n}\n\nfunction cryptoRandomId(): string {\n\tconst c = (globalThis as { crypto?: Crypto }).crypto;\n\tif (c?.randomUUID) return c.randomUUID();\n\treturn `thread-${Math.random().toString(36).slice(2)}-${Date.now()}`;\n}\n"]}

package/dist/chunk-YBFLWRO5.cjs

@@ -0,0 +1,194 @@
+'use strict';
+
+var chunkWSMYH2IN_cjs = require('./chunk-WSMYH2IN.cjs');
+var chunkTAMJ5HSR_cjs = require('./chunk-TAMJ5HSR.cjs');
+var chunkFSDMBWQV_cjs = require('./chunk-FSDMBWQV.cjs');
+var chunkLMN75W3W_cjs = require('./chunk-LMN75W3W.cjs');
+var chunkMQ2XTH3S_cjs = require('./chunk-MQ2XTH3S.cjs');
+
+// src/agents/loop.ts
+async function runLoop(generate, registry, messages, options) {
+  const maxIterations = options?.maxIterations ?? 10;
+  const working = [...messages];
+  let iteration = 0;
+  for (; ; ) {
+    if (maxIterations !== -1 && iteration >= maxIterations) {
+      return {
+        messages: working,
+        final: { text: "" },
+        status: "limit-exceeded"
+      };
+    }
+    iteration++;
+    const specs = registry.specs();
+    const response = await generate({
+      messages: working,
+      tools: specs.length > 0 ? specs : void 0,
+      signal: options?.signal
+    });
+    if (!response.toolCalls || response.toolCalls.length === 0) {
+      return { messages: working, final: response, status: "completed" };
+    }
+    working.push({
+      role: "assistant",
+      parts: response.text ? [{ type: "text", text: response.text }] : []
+    });
+    for (const call of response.toolCalls) {
+      const result = await registry.invoke(call.name, call.arguments, options?.toolTimeoutMs);
+      const payload = result.error ? `ERROR (${result.error.reason}): ${result.error.message}` : JSON.stringify(result.value ?? null);
+      working.push({
+        role: "tool",
+        name: call.name,
+        toolCallId: call.id,
+        parts: [{ type: "text", text: payload }]
+      });
+    }
+  }
+}
+function buildMessages(instructions, input) {
+  return [chunkLMN75W3W_cjs.textMessage("system", instructions), ...input];
+}
+
+// src/agents/agent.ts
+function normalizeInput(input) {
+  if (typeof input === "string") return [chunkLMN75W3W_cjs.textMessage("user", input)];
+  return Array.isArray(input) ? input : [input];
+}
+function promptText(messages) {
+  return messages.flatMap((m) => m.parts).filter((p) => p.type === "text").map((p) => p.text).join(" ");
+}
+function createAgent(config) {
+  const registry = new chunkTAMJ5HSR_cjs.ToolRegistry(config.tools ?? []);
+  const skillIndex = new chunkWSMYH2IN_cjs.SkillIndex(config.skills ?? []);
+  const middleware = config.middleware ?? [];
+  function gateVision(messages) {
+    if (!config.provider.capabilities.supportsVision && messages.some(chunkLMN75W3W_cjs.hasImage)) {
+      throw new chunkMQ2XTH3S_cjs.ProviderError(
+        "Image input was provided but the configured model does not support vision",
+        "client"
+      );
+    }
+  }
+  async function injectSkills(userMessages) {
+    if ((config.skills ?? []).length === 0) return userMessages;
+    const selected = skillIndex.select(promptText(userMessages));
+    if (selected.length === 0) return userMessages;
+    const contents = await Promise.all(selected.map((s) => skillIndex.load(s)));
+    const skillBlock = chunkLMN75W3W_cjs.textMessage(
+      "system",
+      `Relevant skill knowledge:
+${contents.join("\n\n")}`
+    );
+    return [skillBlock, ...userMessages];
+  }
+  async function callProvider(req) {
+    const ctx = {
+      agentName: config.name,
+      request: req
+    };
+    const pipeline = chunkFSDMBWQV_cjs.composeMiddleware(middleware, (c) => config.provider.generate(c.request));
+    return pipeline(ctx);
+  }
+  async function prepare(input, opts) {
+    const userMessages = normalizeInput(input);
+    gateVision(userMessages);
+    const thread = opts?.thread ?? new chunkLMN75W3W_cjs.Thread(void 0, [chunkLMN75W3W_cjs.textMessage("system", config.instructions)]);
+    const withSkills = await injectSkills(userMessages);
+    for (const m of withSkills) thread.add(m);
+    await thread.maybeCompact(config.provider, {
+      compactionThreshold: config.compactionThreshold,
+      compactionModel: config.compactionModel
+    });
+    return thread;
+  }
+  async function run(input, opts) {
+    let thread;
+    try {
+      thread = await prepare(input, opts);
+    } catch (e) {
+      if (e instanceof chunkMQ2XTH3S_cjs.ProviderError) {
+        return { output: "", status: "failed", partial: false, error: e, thread: opts?.thread ?? new chunkLMN75W3W_cjs.Thread() };
+      }
+      throw e;
+    }
+    try {
+      const loop = await runLoop(callProvider, registry, thread.messages, {
+        maxIterations: config.maxIterations,
+        toolTimeoutMs: config.toolTimeoutMs,
+        signal: opts?.signal
+      });
+      if (loop.final.text) {
+        thread.add({ role: "assistant", parts: [{ type: "text", text: loop.final.text }] });
+      }
+      return {
+        output: loop.final.text,
+        reasoning: config.provider.capabilities.supportsReasoning ? loop.final.reasoning : void 0,
+        status: loop.status,
+        partial: loop.status === "incomplete",
+        thread
+      };
+    } catch (e) {
+      if (e instanceof chunkMQ2XTH3S_cjs.ProviderError) {
+        return { output: "", status: "failed", partial: false, error: e, thread };
+      }
+      throw e;
+    }
+  }
+  async function* runStream(input, opts) {
+    let thread;
+    try {
+      thread = await prepare(input, opts);
+    } catch (e) {
+      if (e instanceof chunkMQ2XTH3S_cjs.ProviderError) {
+        yield { type: "done", result: { output: "", status: "failed", partial: false, error: e, thread: opts?.thread ?? new chunkLMN75W3W_cjs.Thread() } };
+        return;
+      }
+      throw e;
+    }
+    let text = "";
+    let reasoning = "";
+    try {
+      for await (const chunk of config.provider.generateStream({
+        messages: thread.messages,
+        tools: registry.specs(),
+        signal: opts?.signal
+      })) {
+        if (chunk.type === "text") {
+          text += chunk.text;
+          yield { type: "text", text: chunk.text };
+        } else if (chunk.type === "reasoning" && config.provider.capabilities.supportsReasoning) {
+          reasoning += chunk.text;
+          yield { type: "reasoning", text: chunk.text };
+        } else if (chunk.type === "done") {
+          text = chunk.response.text || text;
+          reasoning = chunk.response.reasoning || reasoning;
+        }
+      }
+    } catch (e) {
+      const error = e instanceof chunkMQ2XTH3S_cjs.ProviderError ? e : new chunkMQ2XTH3S_cjs.ProviderError(e.message, "transient");
+      yield {
+        type: "done",
+        result: { output: text, status: "incomplete", partial: true, error, thread }
+      };
+      return;
+    }
+    if (text) thread.add({ role: "assistant", parts: [{ type: "text", text }] });
+    yield {
+      type: "done",
+      result: {
+        output: text,
+        reasoning: config.provider.capabilities.supportsReasoning ? reasoning || void 0 : void 0,
+        status: "completed",
+        partial: false,
+        thread
+      }
+    };
+  }
+  return { name: config.name, run, runStream };
+}
+
+exports.buildMessages = buildMessages;
+exports.createAgent = createAgent;
+exports.runLoop = runLoop;
+//# sourceMappingURL=chunk-YBFLWRO5.cjs.map
+//# sourceMappingURL=chunk-YBFLWRO5.cjs.map