@copilotkit/intelligence-langgraph 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +48 -0
  3. package/dist/index.cjs +9 -0
  4. package/dist/index.d.cts +5 -0
  5. package/dist/index.d.mts +6 -0
  6. package/dist/index.mjs +6 -0
  7. package/dist/intelligence-delivery-core/dist/archive.cjs +130 -0
  8. package/dist/intelligence-delivery-core/dist/archive.cjs.map +1 -0
  9. package/dist/intelligence-delivery-core/dist/archive.mjs +127 -0
  10. package/dist/intelligence-delivery-core/dist/archive.mjs.map +1 -0
  11. package/dist/intelligence-delivery-core/dist/config.cjs +47 -0
  12. package/dist/intelligence-delivery-core/dist/config.cjs.map +1 -0
  13. package/dist/intelligence-delivery-core/dist/config.d.cts +17 -0
  14. package/dist/intelligence-delivery-core/dist/config.d.cts.map +1 -0
  15. package/dist/intelligence-delivery-core/dist/config.d.mts +17 -0
  16. package/dist/intelligence-delivery-core/dist/config.d.mts.map +1 -0
  17. package/dist/intelligence-delivery-core/dist/config.mjs +47 -0
  18. package/dist/intelligence-delivery-core/dist/config.mjs.map +1 -0
  19. package/dist/intelligence-delivery-core/dist/errors.cjs +10 -0
  20. package/dist/intelligence-delivery-core/dist/errors.cjs.map +1 -0
  21. package/dist/intelligence-delivery-core/dist/errors.d.cts +2 -0
  22. package/dist/intelligence-delivery-core/dist/errors.d.mts +2 -0
  23. package/dist/intelligence-delivery-core/dist/errors.mjs +10 -0
  24. package/dist/intelligence-delivery-core/dist/errors.mjs.map +1 -0
  25. package/dist/intelligence-delivery-core/dist/index.cjs +7 -0
  26. package/dist/intelligence-delivery-core/dist/index.d.mts +5 -0
  27. package/dist/intelligence-delivery-core/dist/index.mjs +8 -0
  28. package/dist/intelligence-delivery-core/dist/registry.cjs +131 -0
  29. package/dist/intelligence-delivery-core/dist/registry.cjs.map +1 -0
  30. package/dist/intelligence-delivery-core/dist/registry.d.cts +31 -0
  31. package/dist/intelligence-delivery-core/dist/registry.d.cts.map +1 -0
  32. package/dist/intelligence-delivery-core/dist/registry.d.mts +31 -0
  33. package/dist/intelligence-delivery-core/dist/registry.d.mts.map +1 -0
  34. package/dist/intelligence-delivery-core/dist/registry.mjs +130 -0
  35. package/dist/intelligence-delivery-core/dist/registry.mjs.map +1 -0
  36. package/dist/intelligence-delivery-core/dist/skill-content.cjs +41 -0
  37. package/dist/intelligence-delivery-core/dist/skill-content.cjs.map +1 -0
  38. package/dist/intelligence-delivery-core/dist/skill-content.d.mts +1 -0
  39. package/dist/intelligence-delivery-core/dist/skill-content.mjs +38 -0
  40. package/dist/intelligence-delivery-core/dist/skill-content.mjs.map +1 -0
  41. package/dist/intelligence-delivery-core/dist/snapshot.cjs +91 -0
  42. package/dist/intelligence-delivery-core/dist/snapshot.cjs.map +1 -0
  43. package/dist/intelligence-delivery-core/dist/snapshot.d.cts +23 -0
  44. package/dist/intelligence-delivery-core/dist/snapshot.d.cts.map +1 -0
  45. package/dist/intelligence-delivery-core/dist/snapshot.d.mts +25 -0
  46. package/dist/intelligence-delivery-core/dist/snapshot.d.mts.map +1 -0
  47. package/dist/intelligence-delivery-core/dist/snapshot.mjs +90 -0
  48. package/dist/intelligence-delivery-core/dist/snapshot.mjs.map +1 -0
  49. package/dist/invocation.cjs +164 -0
  50. package/dist/invocation.cjs.map +1 -0
  51. package/dist/invocation.mjs +164 -0
  52. package/dist/invocation.mjs.map +1 -0
  53. package/dist/middleware.cjs +49 -0
  54. package/dist/middleware.cjs.map +1 -0
  55. package/dist/middleware.d.cts +45 -0
  56. package/dist/middleware.d.cts.map +1 -0
  57. package/dist/middleware.d.mts +46 -0
  58. package/dist/middleware.d.mts.map +1 -0
  59. package/dist/middleware.mjs +49 -0
  60. package/dist/middleware.mjs.map +1 -0
  61. package/dist/skill-tools.cjs +25 -0
  62. package/dist/skill-tools.cjs.map +1 -0
  63. package/dist/skill-tools.mjs +25 -0
  64. package/dist/skill-tools.mjs.map +1 -0
  65. package/package.json +85 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"snapshot.d.mts","names":["LearnedSkillsSnapshotResult","SnapshotFile","path","size","sha256","text","SnapshotSkill","name","description","files","VerifiedSnapshot","revision","etag","skills","validateSnapshot","Extract","AbortSignal","Promise","status","response","signal"],"sources":["../../../../intelligence-delivery-core/dist/snapshot.d.mts"],"mappings":";;;;UAGUC,YAAAA;EAAAA,SACCC,IAAAA;EAAAA,SACAC,IAAAA;EAAAA,SACAC,MAAAA;EAFAF;EAAAA,SAIAG,IAAAA;AAAAA;AAAAA,UAEDC,aAAAA;EAAAA,SACCC,IAAAA;EAAAA,SACAC,WAAAA;EAAAA,SACAC,KAAAA,WAAgBR,YAAAA;AAAAA;AAAAA,UAEjBS,gBAAAA;EAAAA,SACCC,QAAAA;EAAAA,SACAC,IAAAA;EAAAA,SACAC,MAAAA,WAAiBP,aAAAA;AAAAA"}
@@ -0,0 +1,90 @@
1
+ import { SkillDeliveryError, invalidSnapshot } from "./errors.mjs";
2
+ import { MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "./archive.mjs";
3
+ import { createHash } from "node:crypto";
4
+
5
+ //#region ../intelligence-delivery-core/dist/snapshot.mjs
6
+ function object(value) {
7
+ return value !== null && typeof value === "object" && !Array.isArray(value);
8
+ }
9
+ function sha256(bytes) {
10
+ return createHash("sha256").update(bytes).digest("hex");
11
+ }
12
+ function utf8(bytes) {
13
+ try {
14
+ return new TextDecoder("utf-8", {
15
+ fatal: true,
16
+ ignoreBOM: true
17
+ }).decode(bytes);
18
+ } catch {
19
+ return;
20
+ }
21
+ }
22
+ /** Validate a replacement fully before it can become an invocation snapshot. */
23
+ async function validateSnapshot(response, signal) {
24
+ try {
25
+ if (!object(response) || !(response.bytes instanceof Uint8Array) || typeof response.revision !== "string" || typeof response.etag !== "string" || typeof response.contentType !== "string") throw invalidSnapshot();
26
+ const { revision, etag, contentType } = response;
27
+ if (response.status !== "snapshot" || response.bytes.byteLength > MAX_SNAPSHOT_BYTES || contentType.split(";", 1)[0]?.trim().toLowerCase() !== "application/zip" || !revision || !/^"[a-f0-9]{64}"$/.test(etag)) throw invalidSnapshot();
28
+ const bytes = Buffer.from(response.bytes);
29
+ if (`"${sha256(bytes)}"` !== etag) throw invalidSnapshot();
30
+ const archive = await readArchive(bytes, signal);
31
+ const manifestBytes = archive.get("manifest.json");
32
+ if (!manifestBytes) throw invalidSnapshot();
33
+ const decoded = utf8(manifestBytes);
34
+ if (decoded === void 0) throw invalidSnapshot();
35
+ const manifest = JSON.parse(decoded);
36
+ if (!object(manifest)) throw invalidSnapshot();
37
+ if (typeof manifest.schemaVersion === "number" && manifest.schemaVersion !== 1) throw new SkillDeliveryError("UNSUPPORTED_SERVER", false);
38
+ if (manifest.schemaVersion !== 1 || manifest.revision !== revision || !Array.isArray(manifest.skills)) throw invalidSnapshot();
39
+ const expected = new Set(["manifest.json"]);
40
+ let previousName;
41
+ const skills = [];
42
+ for (const skill of manifest.skills) {
43
+ if (!object(skill) || typeof skill.name !== "string" || !safeRelativePath(skill.name) || skill.name.includes("/") || previousName !== void 0 && Buffer.compare(Buffer.from(previousName), Buffer.from(skill.name)) >= 0 || typeof skill.description !== "string" || !Array.isArray(skill.files)) throw invalidSnapshot();
44
+ previousName = skill.name;
45
+ let previousPath;
46
+ let hasSkill = false;
47
+ const files = [];
48
+ for (const file of skill.files) {
49
+ if (!object(file) || typeof file.path !== "string" || !safeRelativePath(file.path) || previousPath !== void 0 && Buffer.compare(Buffer.from(previousPath), Buffer.from(file.path)) >= 0 || typeof file.size !== "number" || !Number.isSafeInteger(file.size) || file.size < 0 || typeof file.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(file.sha256)) throw invalidSnapshot();
50
+ previousPath = file.path;
51
+ const path = `${skill.name}/${file.path}`;
52
+ if (expected.has(path)) throw invalidSnapshot();
53
+ expected.add(path);
54
+ const content = archive.get(path);
55
+ if (!content || content.length !== file.size || sha256(content) !== file.sha256) throw invalidSnapshot();
56
+ const text = utf8(content);
57
+ if (file.path === "SKILL.md") {
58
+ if (text === void 0) throw invalidSnapshot();
59
+ hasSkill = true;
60
+ }
61
+ files.push(Object.freeze({
62
+ path: file.path,
63
+ size: file.size,
64
+ sha256: file.sha256,
65
+ ...text !== void 0 ? { text } : {}
66
+ }));
67
+ }
68
+ if (!hasSkill) throw invalidSnapshot();
69
+ skills.push(Object.freeze({
70
+ name: skill.name,
71
+ description: skill.description,
72
+ files: Object.freeze(files)
73
+ }));
74
+ }
75
+ if (expected.size !== archive.size || [...archive.keys()].some((path) => !expected.has(path))) throw invalidSnapshot();
76
+ return Object.freeze({
77
+ revision,
78
+ etag,
79
+ skills: Object.freeze(skills)
80
+ });
81
+ } catch (error) {
82
+ if (signal?.aborted) throw signal.reason;
83
+ if (error instanceof SkillDeliveryError) throw error;
84
+ throw invalidSnapshot(error);
85
+ }
86
+ }
87
+
88
+ //#endregion
89
+ export { validateSnapshot };
90
+ //# sourceMappingURL=snapshot.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"snapshot.mjs","names":[],"sources":["../../../../intelligence-delivery-core/dist/snapshot.mjs"],"sourcesContent":["import { SkillDeliveryError, invalidSnapshot } from \"./errors.mjs\";\nimport { MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from \"./archive.mjs\";\nimport { createHash } from \"node:crypto\";\n\n//#region src/snapshot.ts\nfunction object(value) {\n\treturn value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\nfunction sha256(bytes) {\n\treturn createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\nfunction utf8(bytes) {\n\ttry {\n\t\treturn new TextDecoder(\"utf-8\", {\n\t\t\tfatal: true,\n\t\t\tignoreBOM: true\n\t\t}).decode(bytes);\n\t} catch {\n\t\treturn;\n\t}\n}\n/** Validate a replacement fully before it can become an invocation snapshot. */\nasync function validateSnapshot(response, signal) {\n\ttry {\n\t\tif (!object(response) || !(response.bytes instanceof Uint8Array) || typeof response.revision !== \"string\" || typeof response.etag !== \"string\" || typeof response.contentType !== \"string\") throw invalidSnapshot();\n\t\tconst { revision, etag, contentType } = response;\n\t\tif (response.status !== \"snapshot\" || response.bytes.byteLength > MAX_SNAPSHOT_BYTES || contentType.split(\";\", 1)[0]?.trim().toLowerCase() !== \"application/zip\" || !revision || !/^\"[a-f0-9]{64}\"$/.test(etag)) throw invalidSnapshot();\n\t\tconst bytes = Buffer.from(response.bytes);\n\t\tif (`\"${sha256(bytes)}\"` !== etag) throw invalidSnapshot();\n\t\tconst archive = await readArchive(bytes, signal);\n\t\tconst manifestBytes = archive.get(\"manifest.json\");\n\t\tif (!manifestBytes) throw invalidSnapshot();\n\t\tconst decoded = utf8(manifestBytes);\n\t\tif (decoded === void 0) throw invalidSnapshot();\n\t\tconst manifest = JSON.parse(decoded);\n\t\tif (!object(manifest)) throw invalidSnapshot();\n\t\tif (typeof manifest.schemaVersion === \"number\" && manifest.schemaVersion !== 1) throw new SkillDeliveryError(\"UNSUPPORTED_SERVER\", false);\n\t\tif (manifest.schemaVersion !== 1 || manifest.revision !== revision || !Array.isArray(manifest.skills)) throw invalidSnapshot();\n\t\tconst expected = new Set([\"manifest.json\"]);\n\t\tlet previousName;\n\t\tconst skills = [];\n\t\tfor (const skill of manifest.skills) {\n\t\t\tif (!object(skill) || typeof skill.name !== \"string\" || !safeRelativePath(skill.name) || skill.name.includes(\"/\") || previousName !== void 0 && Buffer.compare(Buffer.from(previousName), Buffer.from(skill.name)) >= 0 || typeof skill.description !== \"string\" || !Array.isArray(skill.files)) throw invalidSnapshot();\n\t\t\tpreviousName = skill.name;\n\t\t\tlet previousPath;\n\t\t\tlet hasSkill = false;\n\t\t\tconst files = [];\n\t\t\tfor (const file of skill.files) {\n\t\t\t\tif (!object(file) || typeof file.path !== \"string\" || !safeRelativePath(file.path) || previousPath !== void 0 && Buffer.compare(Buffer.from(previousPath), Buffer.from(file.path)) >= 0 || typeof file.size !== \"number\" || !Number.isSafeInteger(file.size) || file.size < 0 || typeof file.sha256 !== \"string\" || !/^[a-f0-9]{64}$/.test(file.sha256)) throw invalidSnapshot();\n\t\t\t\tpreviousPath = file.path;\n\t\t\t\tconst path = `${skill.name}/${file.path}`;\n\t\t\t\tif (expected.has(path)) throw invalidSnapshot();\n\t\t\t\texpected.add(path);\n\t\t\t\tconst content = archive.get(path);\n\t\t\t\tif (!content || content.length !== file.size || sha256(content) !== file.sha256) throw invalidSnapshot();\n\t\t\t\tconst text = utf8(content);\n\t\t\t\tif (file.path === \"SKILL.md\") {\n\t\t\t\t\tif (text === void 0) throw invalidSnapshot();\n\t\t\t\t\thasSkill = true;\n\t\t\t\t}\n\t\t\t\tfiles.push(Object.freeze({\n\t\t\t\t\tpath: file.path,\n\t\t\t\t\tsize: file.size,\n\t\t\t\t\tsha256: file.sha256,\n\t\t\t\t\t...text !== void 0 ? { text } : {}\n\t\t\t\t}));\n\t\t\t}\n\t\t\tif (!hasSkill) throw invalidSnapshot();\n\t\t\tskills.push(Object.freeze({\n\t\t\t\tname: skill.name,\n\t\t\t\tdescription: skill.description,\n\t\t\t\tfiles: Object.freeze(files)\n\t\t\t}));\n\t\t}\n\t\tif (expected.size !== archive.size || [...archive.keys()].some((path) => !expected.has(path))) throw invalidSnapshot();\n\t\treturn Object.freeze({\n\t\t\trevision,\n\t\t\tetag,\n\t\t\tskills: Object.freeze(skills)\n\t\t});\n\t} catch (error) {\n\t\tif (signal?.aborted) throw signal.reason;\n\t\tif (error instanceof SkillDeliveryError) throw error;\n\t\tthrow invalidSnapshot(error);\n\t}\n}\n\n//#endregion\nexport { validateSnapshot };\n//# sourceMappingURL=snapshot.mjs.map"],"mappings":"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"}
@@ -0,0 +1,164 @@
1
+ require('./intelligence-delivery-core/dist/index.cjs');
2
+ let node_async_hooks = require("node:async_hooks");
3
+ let _langchain_core_utils_stream = require("@langchain/core/utils/stream");
4
+ let _copilotkit_runtime_v2 = require("@copilotkit/runtime/v2");
5
+
6
+ //#region src/invocation.ts
7
+ const entries = new Set([
8
+ "invoke",
9
+ "stream",
10
+ "streamEvents"
11
+ ]);
12
+ const unsupportedEntries = new Set(["batch", "batchAsCompleted"]);
13
+ /** Private run lifetime; nothing is added to graph state or runnable config. */
14
+ var SkillInvocationScope = class {
15
+ #registry;
16
+ #storage = new node_async_hooks.AsyncLocalStorage();
17
+ #wrapped = /* @__PURE__ */ new WeakMap();
18
+ #defaultSignals = /* @__PURE__ */ new WeakMap();
19
+ constructor(registry) {
20
+ if (!registry || typeof registry.acquireSnapshot !== "function") throw new _copilotkit_runtime_v2.LearnedSkillsError("INVALID_CONFIG", false);
21
+ this.#registry = registry;
22
+ }
23
+ snapshot() {
24
+ const invocation = this.#storage.getStore();
25
+ if (!invocation) throw new _copilotkit_runtime_v2.LearnedSkillsError("INVALID_CONFIG", false);
26
+ return invocation.snapshot ??= Promise.resolve().then(() => this.#registry.acquireSnapshot());
27
+ }
28
+ async #prepare(signal) {
29
+ signal?.throwIfAborted();
30
+ const snapshot = this.snapshot();
31
+ if (!signal) {
32
+ await snapshot;
33
+ return;
34
+ }
35
+ let abort;
36
+ try {
37
+ await Promise.race([snapshot, new Promise((_, reject) => {
38
+ abort = () => reject(signal.reason);
39
+ signal.addEventListener("abort", abort, { once: true });
40
+ if (signal.aborted) abort();
41
+ })]);
42
+ signal.throwIfAborted();
43
+ } finally {
44
+ signal.removeEventListener("abort", abort);
45
+ }
46
+ }
47
+ #delegate(method, target, args, signal) {
48
+ const config = args[1];
49
+ if (!signal || signal === config?.signal) return Reflect.apply(method, target, args);
50
+ const forwarded = [...args];
51
+ forwarded[1] = {
52
+ ...config,
53
+ signal
54
+ };
55
+ return Reflect.apply(method, target, forwarded);
56
+ }
57
+ #eventStream(method, target, args, signal) {
58
+ const cancellation = new AbortController();
59
+ const forwardAbort = () => cancellation.abort(signal?.reason);
60
+ signal?.addEventListener("abort", forwardAbort, { once: true });
61
+ if (signal?.aborted) forwardAbort();
62
+ let stream;
63
+ let reader;
64
+ let cancelled = false;
65
+ const release = () => {
66
+ reader?.releaseLock();
67
+ reader = void 0;
68
+ };
69
+ const ready = this.#prepare(cancellation.signal).then(() => {
70
+ cancellation.signal.throwIfAborted();
71
+ stream = this.#delegate(method, target, args, signal);
72
+ reader = stream.getReader();
73
+ }).finally(() => signal?.removeEventListener("abort", forwardAbort));
74
+ ready.catch(() => void 0);
75
+ return new _langchain_core_utils_stream.IterableReadableStream({
76
+ pull: async (controller) => {
77
+ try {
78
+ await ready;
79
+ if (cancelled) return;
80
+ const chunk = await reader.read();
81
+ if (cancelled) return;
82
+ if (chunk.done) {
83
+ controller.close();
84
+ release();
85
+ } else controller.enqueue(chunk.value);
86
+ } catch (error) {
87
+ if (!cancelled) {
88
+ controller.error(error);
89
+ release();
90
+ }
91
+ }
92
+ },
93
+ cancel: async (reason) => {
94
+ cancelled = true;
95
+ cancellation.abort(reason);
96
+ await ready.catch(() => void 0);
97
+ try {
98
+ if (stream && "signal" in stream) await stream.cancel(reason);
99
+ await reader?.cancel(reason);
100
+ } finally {
101
+ release();
102
+ }
103
+ }
104
+ });
105
+ }
106
+ #defaultSignal(agent) {
107
+ return this.#defaultSignals.get(agent) ?? Reflect.get(agent, "config", agent)?.signal;
108
+ }
109
+ #mergeSignal(first, second) {
110
+ return first && second && first !== second ? AbortSignal.any([first, second]) : first ?? second;
111
+ }
112
+ wrapAgent(agent) {
113
+ if (!agent || typeof agent !== "object" && typeof agent !== "function" || ![...entries].every((key) => typeof Reflect.get(agent, key, agent) === "function")) throw new _copilotkit_runtime_v2.LearnedSkillsError("INVALID_CONFIG", false);
114
+ const existing = this.#wrapped.get(agent);
115
+ if (existing) return existing;
116
+ const methods = /* @__PURE__ */ new Map();
117
+ const proxy = new Proxy(agent, {
118
+ get: (target, key) => {
119
+ const value = Reflect.get(target, key, target);
120
+ if (key === "graph" && value && typeof value === "object") {
121
+ const signal = this.#mergeSignal(this.#defaultSignal(value), this.#defaultSignal(target));
122
+ if (signal) this.#defaultSignals.set(value, signal);
123
+ return this.wrapAgent(value);
124
+ }
125
+ if (typeof value !== "function" || key === "constructor") return value;
126
+ const cached = methods.get(key);
127
+ if (cached?.source === value) return cached.bound;
128
+ let bound;
129
+ if (entries.has(key)) bound = (...args) => this.#storage.run({}, () => {
130
+ const config = args[1];
131
+ const signal = this.#mergeSignal(this.#defaultSignal(target), config?.signal);
132
+ if (key === "streamEvents" && (config?.version !== "v3" || args[2] != null)) return this.#eventStream(value, target, args, signal);
133
+ return this.#prepare(signal).then(() => {
134
+ signal?.throwIfAborted();
135
+ return this.#delegate(value, target, args, signal);
136
+ });
137
+ });
138
+ else if (key === "withConfig") bound = (...args) => {
139
+ const configured = Reflect.apply(value, target, args);
140
+ const signal = this.#mergeSignal(this.#defaultSignal(target), args[0]?.signal);
141
+ if (signal) this.#defaultSignals.set(configured, signal);
142
+ return this.wrapAgent(configured);
143
+ };
144
+ else if (unsupportedEntries.has(key)) bound = () => {
145
+ throw new _copilotkit_runtime_v2.LearnedSkillsError("INVALID_CONFIG", false);
146
+ };
147
+ else bound = value.bind(target);
148
+ methods.set(key, {
149
+ source: value,
150
+ bound
151
+ });
152
+ return bound;
153
+ },
154
+ set: (target, key, value) => Reflect.set(target, key, value, target)
155
+ });
156
+ this.#wrapped.set(agent, proxy);
157
+ this.#wrapped.set(proxy, proxy);
158
+ return proxy;
159
+ }
160
+ };
161
+
162
+ //#endregion
163
+ exports.SkillInvocationScope = SkillInvocationScope;
164
+ //# sourceMappingURL=invocation.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invocation.cjs","names":["#registry","#storage","AsyncLocalStorage","#wrapped","#defaultSignals","SkillDeliveryError","#prepare","#delegate","IterableReadableStream","#mergeSignal","#defaultSignal","#eventStream"],"sources":["../src/invocation.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { IterableReadableStream } from \"@langchain/core/utils/stream\";\nimport { SkillDeliveryError } from \"@copilotkit/intelligence-delivery-core\";\nimport type { SkillRegistry } from \"@copilotkit/intelligence-delivery-core\";\nimport type { VerifiedSnapshot } from \"@copilotkit/intelligence-delivery-core\";\n\ninterface Invocation {\n snapshot?: Promise<VerifiedSnapshot>;\n}\n\nconst entries = new Set<PropertyKey>([\"invoke\", \"stream\", \"streamEvents\"]);\nconst unsupportedEntries = new Set<PropertyKey>([\"batch\", \"batchAsCompleted\"]);\n\n/** Private run lifetime; nothing is added to graph state or runnable config. */\nexport class SkillInvocationScope {\n readonly #registry: SkillRegistry;\n readonly #storage = new AsyncLocalStorage<Invocation>();\n readonly #wrapped = new WeakMap<object, object>();\n readonly #defaultSignals = new WeakMap<object, AbortSignal>();\n\n constructor(registry: SkillRegistry) {\n if (!registry || typeof registry.acquireSnapshot !== \"function\") {\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n }\n this.#registry = registry;\n }\n\n snapshot(): Promise<VerifiedSnapshot> {\n const invocation = this.#storage.getStore();\n if (!invocation) {\n // Register the middleware and use its wrapAgent result to execute the run.\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n }\n // Assign before invoking the registry, retaining both success and denial.\n return (invocation.snapshot ??= Promise.resolve().then(() =>\n this.#registry.acquireSnapshot(),\n ));\n }\n\n async #prepare(signal?: AbortSignal): Promise<void> {\n signal?.throwIfAborted();\n const snapshot = this.snapshot();\n if (!signal) {\n await snapshot;\n return;\n }\n let abort!: () => void;\n try {\n await Promise.race([\n snapshot,\n new Promise<never>((_, reject) => {\n abort = () => reject(signal.reason);\n signal.addEventListener(\"abort\", abort, { once: true });\n if (signal.aborted) abort();\n }),\n ]);\n signal.throwIfAborted();\n } finally {\n signal.removeEventListener(\"abort\", abort);\n }\n }\n\n #delegate(\n method: Function,\n target: object,\n args: unknown[],\n signal?: AbortSignal,\n ): unknown {\n const config = args[1] as { signal?: AbortSignal } | undefined;\n if (!signal || signal === config?.signal)\n return Reflect.apply(method, target, args);\n // ReactAgent omits signal when exposing its compiled graph. Forward the\n // wrapper's effective signal so cancellation still reaches native execution.\n const forwarded = [...args];\n forwarded[1] = { ...config, signal };\n return Reflect.apply(method, target, forwarded);\n }\n\n #eventStream(\n method: Function,\n target: object,\n args: unknown[],\n signal?: AbortSignal,\n ): IterableReadableStream<unknown> {\n const cancellation = new AbortController();\n const forwardAbort = () => cancellation.abort(signal?.reason);\n signal?.addEventListener(\"abort\", forwardAbort, { once: true });\n if (signal?.aborted) forwardAbort();\n let stream: IterableReadableStream<unknown> | undefined;\n let reader: ReadableStreamDefaultReader<unknown> | undefined;\n let cancelled = false;\n const release = () => {\n reader?.releaseLock();\n reader = undefined;\n };\n // Establish the native producer in the invocation's async context. Readiness\n // covers only snapshot acquisition, not the lifetime of the event stream.\n const ready = this.#prepare(cancellation.signal)\n .then(() => {\n cancellation.signal.throwIfAborted();\n stream = this.#delegate(\n method,\n target,\n args,\n signal,\n ) as IterableReadableStream<unknown>;\n reader = stream!.getReader();\n })\n .finally(() => signal?.removeEventListener(\"abort\", forwardAbort));\n // A caller may cancel without ever reading; observe the rejected readiness.\n void ready.catch(() => undefined);\n return new IterableReadableStream<unknown>({\n pull: async (controller) => {\n try {\n await ready;\n if (cancelled) return;\n const chunk = await reader!.read();\n if (cancelled) return;\n if (chunk.done) {\n controller.close();\n release();\n } else controller.enqueue(chunk.value);\n } catch (error) {\n if (!cancelled) {\n controller.error(error);\n release();\n }\n }\n },\n cancel: async (reason) => {\n cancelled = true;\n cancellation.abort(reason);\n await ready.catch(() => undefined);\n try {\n // Native LangGraph cancel aborts its producer even with a locked reader.\n if (stream && \"signal\" in stream) await stream.cancel(reason);\n await reader?.cancel(reason);\n } finally {\n release();\n }\n },\n });\n }\n\n #defaultSignal(agent: object): AbortSignal | undefined {\n return (\n this.#defaultSignals.get(agent) ??\n Reflect.get(agent, \"config\", agent)?.signal\n );\n }\n\n #mergeSignal(\n first?: AbortSignal,\n second?: AbortSignal,\n ): AbortSignal | undefined {\n return first && second && first !== second\n ? AbortSignal.any([first, second])\n : (first ?? second);\n }\n\n wrapAgent<T extends object>(agent: T): T {\n if (\n !agent ||\n (typeof agent !== \"object\" && typeof agent !== \"function\") ||\n ![...entries].every(\n (key) => typeof Reflect.get(agent, key, agent) === \"function\",\n )\n ) {\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n }\n const existing = this.#wrapped.get(agent);\n if (existing) return existing as T;\n const methods = new Map<\n PropertyKey,\n { source: Function; bound: Function }\n >();\n const proxy = new Proxy(agent, {\n get: (target, key) => {\n // Native ReactAgent and compiled graph getters use private receivers.\n const value = Reflect.get(target, key, target);\n if (key === \"graph\" && value && typeof value === \"object\") {\n const signal = this.#mergeSignal(\n this.#defaultSignal(value),\n this.#defaultSignal(target),\n );\n if (signal) this.#defaultSignals.set(value, signal);\n return this.wrapAgent(value);\n }\n if (typeof value !== \"function\" || key === \"constructor\") return value;\n const cached = methods.get(key);\n if (cached?.source === value) return cached.bound;\n let bound: Function;\n if (entries.has(key)) {\n bound = (...args: unknown[]) =>\n this.#storage.run({}, () => {\n const config = args[1] as\n | { signal?: AbortSignal; version?: string }\n | undefined;\n const signal = this.#mergeSignal(\n this.#defaultSignal(target),\n config?.signal,\n );\n if (\n key === \"streamEvents\" &&\n (config?.version !== \"v3\" || args[2] != null)\n ) {\n return this.#eventStream(value, target, args, signal);\n }\n return this.#prepare(signal).then(() => {\n signal?.throwIfAborted();\n return this.#delegate(value, target, args, signal);\n });\n });\n } else if (key === \"withConfig\") {\n bound = (...args: unknown[]) => {\n const configured = Reflect.apply(value, target, args);\n const signal = this.#mergeSignal(\n this.#defaultSignal(target),\n (args[0] as { signal?: AbortSignal } | undefined)?.signal,\n );\n if (signal) this.#defaultSignals.set(configured, signal);\n return this.wrapAgent(configured);\n };\n } else if (unsupportedEntries.has(key)) {\n // Only the three native invocation entries above are supported. A\n // raw bound batch would invoke the target outside the private scope.\n bound = () => {\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n };\n } else {\n bound = value.bind(target);\n }\n methods.set(key, { source: value, bound });\n return bound;\n },\n set: (target, key, value) => Reflect.set(target, key, value, target),\n });\n this.#wrapped.set(agent, proxy);\n this.#wrapped.set(proxy, proxy);\n return proxy;\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,164 @@
1
+ import { SkillDeliveryError } from "./intelligence-delivery-core/dist/errors.mjs";
2
+ import "./intelligence-delivery-core/dist/index.mjs";
3
+ import { AsyncLocalStorage } from "node:async_hooks";
4
+ import { IterableReadableStream } from "@langchain/core/utils/stream";
5
+
6
+ //#region src/invocation.ts
7
+ const entries = new Set([
8
+ "invoke",
9
+ "stream",
10
+ "streamEvents"
11
+ ]);
12
+ const unsupportedEntries = new Set(["batch", "batchAsCompleted"]);
13
+ /** Private run lifetime; nothing is added to graph state or runnable config. */
14
+ var SkillInvocationScope = class {
15
+ #registry;
16
+ #storage = new AsyncLocalStorage();
17
+ #wrapped = /* @__PURE__ */ new WeakMap();
18
+ #defaultSignals = /* @__PURE__ */ new WeakMap();
19
+ constructor(registry) {
20
+ if (!registry || typeof registry.acquireSnapshot !== "function") throw new SkillDeliveryError("INVALID_CONFIG", false);
21
+ this.#registry = registry;
22
+ }
23
+ snapshot() {
24
+ const invocation = this.#storage.getStore();
25
+ if (!invocation) throw new SkillDeliveryError("INVALID_CONFIG", false);
26
+ return invocation.snapshot ??= Promise.resolve().then(() => this.#registry.acquireSnapshot());
27
+ }
28
+ async #prepare(signal) {
29
+ signal?.throwIfAborted();
30
+ const snapshot = this.snapshot();
31
+ if (!signal) {
32
+ await snapshot;
33
+ return;
34
+ }
35
+ let abort;
36
+ try {
37
+ await Promise.race([snapshot, new Promise((_, reject) => {
38
+ abort = () => reject(signal.reason);
39
+ signal.addEventListener("abort", abort, { once: true });
40
+ if (signal.aborted) abort();
41
+ })]);
42
+ signal.throwIfAborted();
43
+ } finally {
44
+ signal.removeEventListener("abort", abort);
45
+ }
46
+ }
47
+ #delegate(method, target, args, signal) {
48
+ const config = args[1];
49
+ if (!signal || signal === config?.signal) return Reflect.apply(method, target, args);
50
+ const forwarded = [...args];
51
+ forwarded[1] = {
52
+ ...config,
53
+ signal
54
+ };
55
+ return Reflect.apply(method, target, forwarded);
56
+ }
57
+ #eventStream(method, target, args, signal) {
58
+ const cancellation = new AbortController();
59
+ const forwardAbort = () => cancellation.abort(signal?.reason);
60
+ signal?.addEventListener("abort", forwardAbort, { once: true });
61
+ if (signal?.aborted) forwardAbort();
62
+ let stream;
63
+ let reader;
64
+ let cancelled = false;
65
+ const release = () => {
66
+ reader?.releaseLock();
67
+ reader = void 0;
68
+ };
69
+ const ready = this.#prepare(cancellation.signal).then(() => {
70
+ cancellation.signal.throwIfAborted();
71
+ stream = this.#delegate(method, target, args, signal);
72
+ reader = stream.getReader();
73
+ }).finally(() => signal?.removeEventListener("abort", forwardAbort));
74
+ ready.catch(() => void 0);
75
+ return new IterableReadableStream({
76
+ pull: async (controller) => {
77
+ try {
78
+ await ready;
79
+ if (cancelled) return;
80
+ const chunk = await reader.read();
81
+ if (cancelled) return;
82
+ if (chunk.done) {
83
+ controller.close();
84
+ release();
85
+ } else controller.enqueue(chunk.value);
86
+ } catch (error) {
87
+ if (!cancelled) {
88
+ controller.error(error);
89
+ release();
90
+ }
91
+ }
92
+ },
93
+ cancel: async (reason) => {
94
+ cancelled = true;
95
+ cancellation.abort(reason);
96
+ await ready.catch(() => void 0);
97
+ try {
98
+ if (stream && "signal" in stream) await stream.cancel(reason);
99
+ await reader?.cancel(reason);
100
+ } finally {
101
+ release();
102
+ }
103
+ }
104
+ });
105
+ }
106
+ #defaultSignal(agent) {
107
+ return this.#defaultSignals.get(agent) ?? Reflect.get(agent, "config", agent)?.signal;
108
+ }
109
+ #mergeSignal(first, second) {
110
+ return first && second && first !== second ? AbortSignal.any([first, second]) : first ?? second;
111
+ }
112
+ wrapAgent(agent) {
113
+ if (!agent || typeof agent !== "object" && typeof agent !== "function" || ![...entries].every((key) => typeof Reflect.get(agent, key, agent) === "function")) throw new SkillDeliveryError("INVALID_CONFIG", false);
114
+ const existing = this.#wrapped.get(agent);
115
+ if (existing) return existing;
116
+ const methods = /* @__PURE__ */ new Map();
117
+ const proxy = new Proxy(agent, {
118
+ get: (target, key) => {
119
+ const value = Reflect.get(target, key, target);
120
+ if (key === "graph" && value && typeof value === "object") {
121
+ const signal = this.#mergeSignal(this.#defaultSignal(value), this.#defaultSignal(target));
122
+ if (signal) this.#defaultSignals.set(value, signal);
123
+ return this.wrapAgent(value);
124
+ }
125
+ if (typeof value !== "function" || key === "constructor") return value;
126
+ const cached = methods.get(key);
127
+ if (cached?.source === value) return cached.bound;
128
+ let bound;
129
+ if (entries.has(key)) bound = (...args) => this.#storage.run({}, () => {
130
+ const config = args[1];
131
+ const signal = this.#mergeSignal(this.#defaultSignal(target), config?.signal);
132
+ if (key === "streamEvents" && (config?.version !== "v3" || args[2] != null)) return this.#eventStream(value, target, args, signal);
133
+ return this.#prepare(signal).then(() => {
134
+ signal?.throwIfAborted();
135
+ return this.#delegate(value, target, args, signal);
136
+ });
137
+ });
138
+ else if (key === "withConfig") bound = (...args) => {
139
+ const configured = Reflect.apply(value, target, args);
140
+ const signal = this.#mergeSignal(this.#defaultSignal(target), args[0]?.signal);
141
+ if (signal) this.#defaultSignals.set(configured, signal);
142
+ return this.wrapAgent(configured);
143
+ };
144
+ else if (unsupportedEntries.has(key)) bound = () => {
145
+ throw new SkillDeliveryError("INVALID_CONFIG", false);
146
+ };
147
+ else bound = value.bind(target);
148
+ methods.set(key, {
149
+ source: value,
150
+ bound
151
+ });
152
+ return bound;
153
+ },
154
+ set: (target, key, value) => Reflect.set(target, key, value, target)
155
+ });
156
+ this.#wrapped.set(agent, proxy);
157
+ this.#wrapped.set(proxy, proxy);
158
+ return proxy;
159
+ }
160
+ };
161
+
162
+ //#endregion
163
+ export { SkillInvocationScope };
164
+ //# sourceMappingURL=invocation.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invocation.mjs","names":["#registry","#storage","#wrapped","#defaultSignals","#prepare","#delegate","#mergeSignal","#defaultSignal","#eventStream"],"sources":["../src/invocation.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { IterableReadableStream } from \"@langchain/core/utils/stream\";\nimport { SkillDeliveryError } from \"@copilotkit/intelligence-delivery-core\";\nimport type { SkillRegistry } from \"@copilotkit/intelligence-delivery-core\";\nimport type { VerifiedSnapshot } from \"@copilotkit/intelligence-delivery-core\";\n\ninterface Invocation {\n snapshot?: Promise<VerifiedSnapshot>;\n}\n\nconst entries = new Set<PropertyKey>([\"invoke\", \"stream\", \"streamEvents\"]);\nconst unsupportedEntries = new Set<PropertyKey>([\"batch\", \"batchAsCompleted\"]);\n\n/** Private run lifetime; nothing is added to graph state or runnable config. */\nexport class SkillInvocationScope {\n readonly #registry: SkillRegistry;\n readonly #storage = new AsyncLocalStorage<Invocation>();\n readonly #wrapped = new WeakMap<object, object>();\n readonly #defaultSignals = new WeakMap<object, AbortSignal>();\n\n constructor(registry: SkillRegistry) {\n if (!registry || typeof registry.acquireSnapshot !== \"function\") {\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n }\n this.#registry = registry;\n }\n\n snapshot(): Promise<VerifiedSnapshot> {\n const invocation = this.#storage.getStore();\n if (!invocation) {\n // Register the middleware and use its wrapAgent result to execute the run.\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n }\n // Assign before invoking the registry, retaining both success and denial.\n return (invocation.snapshot ??= Promise.resolve().then(() =>\n this.#registry.acquireSnapshot(),\n ));\n }\n\n async #prepare(signal?: AbortSignal): Promise<void> {\n signal?.throwIfAborted();\n const snapshot = this.snapshot();\n if (!signal) {\n await snapshot;\n return;\n }\n let abort!: () => void;\n try {\n await Promise.race([\n snapshot,\n new Promise<never>((_, reject) => {\n abort = () => reject(signal.reason);\n signal.addEventListener(\"abort\", abort, { once: true });\n if (signal.aborted) abort();\n }),\n ]);\n signal.throwIfAborted();\n } finally {\n signal.removeEventListener(\"abort\", abort);\n }\n }\n\n #delegate(\n method: Function,\n target: object,\n args: unknown[],\n signal?: AbortSignal,\n ): unknown {\n const config = args[1] as { signal?: AbortSignal } | undefined;\n if (!signal || signal === config?.signal)\n return Reflect.apply(method, target, args);\n // ReactAgent omits signal when exposing its compiled graph. Forward the\n // wrapper's effective signal so cancellation still reaches native execution.\n const forwarded = [...args];\n forwarded[1] = { ...config, signal };\n return Reflect.apply(method, target, forwarded);\n }\n\n #eventStream(\n method: Function,\n target: object,\n args: unknown[],\n signal?: AbortSignal,\n ): IterableReadableStream<unknown> {\n const cancellation = new AbortController();\n const forwardAbort = () => cancellation.abort(signal?.reason);\n signal?.addEventListener(\"abort\", forwardAbort, { once: true });\n if (signal?.aborted) forwardAbort();\n let stream: IterableReadableStream<unknown> | undefined;\n let reader: ReadableStreamDefaultReader<unknown> | undefined;\n let cancelled = false;\n const release = () => {\n reader?.releaseLock();\n reader = undefined;\n };\n // Establish the native producer in the invocation's async context. Readiness\n // covers only snapshot acquisition, not the lifetime of the event stream.\n const ready = this.#prepare(cancellation.signal)\n .then(() => {\n cancellation.signal.throwIfAborted();\n stream = this.#delegate(\n method,\n target,\n args,\n signal,\n ) as IterableReadableStream<unknown>;\n reader = stream!.getReader();\n })\n .finally(() => signal?.removeEventListener(\"abort\", forwardAbort));\n // A caller may cancel without ever reading; observe the rejected readiness.\n void ready.catch(() => undefined);\n return new IterableReadableStream<unknown>({\n pull: async (controller) => {\n try {\n await ready;\n if (cancelled) return;\n const chunk = await reader!.read();\n if (cancelled) return;\n if (chunk.done) {\n controller.close();\n release();\n } else controller.enqueue(chunk.value);\n } catch (error) {\n if (!cancelled) {\n controller.error(error);\n release();\n }\n }\n },\n cancel: async (reason) => {\n cancelled = true;\n cancellation.abort(reason);\n await ready.catch(() => undefined);\n try {\n // Native LangGraph cancel aborts its producer even with a locked reader.\n if (stream && \"signal\" in stream) await stream.cancel(reason);\n await reader?.cancel(reason);\n } finally {\n release();\n }\n },\n });\n }\n\n #defaultSignal(agent: object): AbortSignal | undefined {\n return (\n this.#defaultSignals.get(agent) ??\n Reflect.get(agent, \"config\", agent)?.signal\n );\n }\n\n #mergeSignal(\n first?: AbortSignal,\n second?: AbortSignal,\n ): AbortSignal | undefined {\n return first && second && first !== second\n ? AbortSignal.any([first, second])\n : (first ?? second);\n }\n\n wrapAgent<T extends object>(agent: T): T {\n if (\n !agent ||\n (typeof agent !== \"object\" && typeof agent !== \"function\") ||\n ![...entries].every(\n (key) => typeof Reflect.get(agent, key, agent) === \"function\",\n )\n ) {\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n }\n const existing = this.#wrapped.get(agent);\n if (existing) return existing as T;\n const methods = new Map<\n PropertyKey,\n { source: Function; bound: Function }\n >();\n const proxy = new Proxy(agent, {\n get: (target, key) => {\n // Native ReactAgent and compiled graph getters use private receivers.\n const value = Reflect.get(target, key, target);\n if (key === \"graph\" && value && typeof value === \"object\") {\n const signal = this.#mergeSignal(\n this.#defaultSignal(value),\n this.#defaultSignal(target),\n );\n if (signal) this.#defaultSignals.set(value, signal);\n return this.wrapAgent(value);\n }\n if (typeof value !== \"function\" || key === \"constructor\") return value;\n const cached = methods.get(key);\n if (cached?.source === value) return cached.bound;\n let bound: Function;\n if (entries.has(key)) {\n bound = (...args: unknown[]) =>\n this.#storage.run({}, () => {\n const config = args[1] as\n | { signal?: AbortSignal; version?: string }\n | undefined;\n const signal = this.#mergeSignal(\n this.#defaultSignal(target),\n config?.signal,\n );\n if (\n key === \"streamEvents\" &&\n (config?.version !== \"v3\" || args[2] != null)\n ) {\n return this.#eventStream(value, target, args, signal);\n }\n return this.#prepare(signal).then(() => {\n signal?.throwIfAborted();\n return this.#delegate(value, target, args, signal);\n });\n });\n } else if (key === \"withConfig\") {\n bound = (...args: unknown[]) => {\n const configured = Reflect.apply(value, target, args);\n const signal = this.#mergeSignal(\n this.#defaultSignal(target),\n (args[0] as { signal?: AbortSignal } | undefined)?.signal,\n );\n if (signal) this.#defaultSignals.set(configured, signal);\n return this.wrapAgent(configured);\n };\n } else if (unsupportedEntries.has(key)) {\n // Only the three native invocation entries above are supported. A\n // raw bound batch would invoke the target outside the private scope.\n bound = () => {\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n };\n } else {\n bound = value.bind(target);\n }\n methods.set(key, { source: value, bound });\n return bound;\n },\n set: (target, key, value) => Reflect.set(target, key, value, target),\n });\n this.#wrapped.set(agent, proxy);\n this.#wrapped.set(proxy, proxy);\n return proxy;\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ const require_skill_content = require('./intelligence-delivery-core/dist/skill-content.cjs');
2
+ require('./intelligence-delivery-core/dist/index.cjs');
3
+ const require_invocation = require('./invocation.cjs');
4
+ const require_skill_tools = require('./skill-tools.cjs');
5
+ let langchain = require("langchain");
6
+ let _copilotkit_runtime_v2 = require("@copilotkit/runtime/v2");
7
+
8
+ //#region src/middleware.ts
9
+ /**
10
+ * Add learned skills through native middleware and wrap the agent once.
11
+ *
12
+ * The wrapper owns invocation state outside LangGraph checkpoints. Always call
13
+ * the returned agent, including for streams and interrupted-run resumes.
14
+ * Set default cancellation signals on the wrapped agent with withConfig, or
15
+ * pass them per invocation, so they also cancel the initial delivery wait.
16
+ *
17
+ * @example
18
+ * const skills = createSkillRegistryMiddleware({ registry });
19
+ * const agent = skills.wrapAgent(createAgent({ model, middleware: [skills] }));
20
+ * await agent.invoke({ messages: [{ role: "user", content: "Help me" }] });
21
+ */
22
+ function createSkillRegistryMiddleware({ registry }) {
23
+ if (!registry || typeof registry.acquireSnapshot !== "function") throw new _copilotkit_runtime_v2.LearnedSkillsError("INVALID_CONFIG", false);
24
+ const scope = new require_invocation.SkillInvocationScope(registry);
25
+ const middleware = (0, langchain.createMiddleware)({
26
+ name: "CopilotKitSkillRegistry",
27
+ tools: require_skill_tools.createSkillTools(() => scope.snapshot()),
28
+ beforeAgent: async () => {
29
+ await scope.snapshot();
30
+ },
31
+ wrapModelCall: async (request, handler) => {
32
+ const catalog = require_skill_content.formatSkillCatalog(await scope.snapshot());
33
+ const systemMessage = request.systemMessage ?? new langchain.SystemMessage(request.systemPrompt ?? "");
34
+ return handler({
35
+ ...request,
36
+ systemMessage: systemMessage.concat(`\n\n${catalog}`)
37
+ });
38
+ },
39
+ wrapToolCall: async (request, handler) => {
40
+ await scope.snapshot();
41
+ return handler(request);
42
+ }
43
+ });
44
+ return Object.assign(middleware, { wrapAgent: (agent) => scope.wrapAgent(agent) });
45
+ }
46
+
47
+ //#endregion
48
+ exports.createSkillRegistryMiddleware = createSkillRegistryMiddleware;
49
+ //# sourceMappingURL=middleware.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"middleware.cjs","names":["SkillDeliveryError","SkillInvocationScope","createSkillTools","formatSkillCatalog","SystemMessage"],"sources":["../src/middleware.ts"],"sourcesContent":["import { createMiddleware, SystemMessage } from \"langchain\";\nimport { SkillDeliveryError } from \"@copilotkit/intelligence-delivery-core\";\nimport { SkillInvocationScope } from \"./invocation.js\";\nimport type { SkillRegistry } from \"@copilotkit/intelligence-delivery-core\";\nimport { createSkillTools, formatSkillCatalog } from \"./skill-tools.js\";\n\nexport interface SkillRegistryMiddlewareOptions {\n registry: SkillRegistry;\n}\n\n/**\n * Add learned skills through native middleware and wrap the agent once.\n *\n * The wrapper owns invocation state outside LangGraph checkpoints. Always call\n * the returned agent, including for streams and interrupted-run resumes.\n * Set default cancellation signals on the wrapped agent with withConfig, or\n * pass them per invocation, so they also cancel the initial delivery wait.\n *\n * @example\n * const skills = createSkillRegistryMiddleware({ registry });\n * const agent = skills.wrapAgent(createAgent({ model, middleware: [skills] }));\n * await agent.invoke({ messages: [{ role: \"user\", content: \"Help me\" }] });\n */\nexport function createSkillRegistryMiddleware({\n registry,\n}: SkillRegistryMiddlewareOptions) {\n if (!registry || typeof registry.acquireSnapshot !== \"function\") {\n throw new SkillDeliveryError(\"INVALID_CONFIG\", false);\n }\n const scope = new SkillInvocationScope(registry);\n const middleware = createMiddleware({\n name: \"CopilotKitSkillRegistry\",\n tools: createSkillTools(() => scope.snapshot()),\n beforeAgent: async () => {\n await scope.snapshot();\n },\n wrapModelCall: async (request, handler) => {\n const catalog = formatSkillCatalog(await scope.snapshot());\n const systemMessage =\n request.systemMessage ?? new SystemMessage(request.systemPrompt ?? \"\");\n return handler({\n ...request,\n systemMessage: systemMessage.concat(`\\n\\n${catalog}`),\n });\n },\n // A resume can start at a normal tool and skip beforeAgent. Gate that path\n // too, so confirmed denial stops all new adapter-backed invocations.\n wrapToolCall: async (request, handler) => {\n await scope.snapshot();\n return handler(request);\n },\n });\n return Object.assign(middleware, {\n wrapAgent: <T extends object>(agent: T): T => scope.wrapAgent(agent),\n });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,8BAA8B,EAC5C,YACiC;AACjC,KAAI,CAAC,YAAY,OAAO,SAAS,oBAAoB,WACnD,OAAM,IAAIA,0CAAmB,kBAAkB,MAAM;CAEvD,MAAM,QAAQ,IAAIC,wCAAqB,SAAS;CAChD,MAAM,6CAA8B;EAClC,MAAM;EACN,OAAOC,2CAAuB,MAAM,UAAU,CAAC;EAC/C,aAAa,YAAY;AACvB,SAAM,MAAM,UAAU;;EAExB,eAAe,OAAO,SAAS,YAAY;GACzC,MAAM,UAAUC,yCAAmB,MAAM,MAAM,UAAU,CAAC;GAC1D,MAAM,gBACJ,QAAQ,iBAAiB,IAAIC,wBAAc,QAAQ,gBAAgB,GAAG;AACxE,UAAO,QAAQ;IACb,GAAG;IACH,eAAe,cAAc,OAAO,OAAO,UAAU;IACtD,CAAC;;EAIJ,cAAc,OAAO,SAAS,YAAY;AACxC,SAAM,MAAM,UAAU;AACtB,UAAO,QAAQ,QAAQ;;EAE1B,CAAC;AACF,QAAO,OAAO,OAAO,YAAY,EAC/B,YAA8B,UAAgB,MAAM,UAAU,MAAM,EACrE,CAAC"}
@@ -0,0 +1,45 @@
1
+ import { SkillRegistry } from "./intelligence-delivery-core/dist/registry.cjs";
2
+ import * as zod_v40 from "zod/v4";
3
+ import * as zod_v4_core0 from "zod/v4/core";
4
+ import * as langchain from "langchain";
5
+
6
+ //#region src/middleware.d.ts
7
+ interface SkillRegistryMiddlewareOptions {
8
+ registry: SkillRegistry;
9
+ }
10
+ /**
11
+ * Add learned skills through native middleware and wrap the agent once.
12
+ *
13
+ * The wrapper owns invocation state outside LangGraph checkpoints. Always call
14
+ * the returned agent, including for streams and interrupted-run resumes.
15
+ * Set default cancellation signals on the wrapped agent with withConfig, or
16
+ * pass them per invocation, so they also cancel the initial delivery wait.
17
+ *
18
+ * @example
19
+ * const skills = createSkillRegistryMiddleware({ registry });
20
+ * const agent = skills.wrapAgent(createAgent({ model, middleware: [skills] }));
21
+ * await agent.invoke({ messages: [{ role: "user", content: "Help me" }] });
22
+ */
23
+ declare function createSkillRegistryMiddleware({
24
+ registry
25
+ }: SkillRegistryMiddlewareOptions): langchain.AgentMiddleware<undefined, undefined, unknown, [langchain.DynamicStructuredTool<zod_v40.ZodObject<{
26
+ skill_name: zod_v40.ZodString;
27
+ }, zod_v4_core0.$strip>, {
28
+ skill_name: string;
29
+ }, {
30
+ skill_name: string;
31
+ }, string, unknown, "copilotkit_load_skill">, langchain.DynamicStructuredTool<zod_v40.ZodObject<{
32
+ skill_name: zod_v40.ZodString;
33
+ path: zod_v40.ZodString;
34
+ }, zod_v4_core0.$strip>, {
35
+ skill_name: string;
36
+ path: string;
37
+ }, {
38
+ skill_name: string;
39
+ path: string;
40
+ }, string, unknown, "copilotkit_read_skill_file">], readonly []> & {
41
+ wrapAgent: <T extends object>(agent: T) => T;
42
+ };
43
+ //#endregion
44
+ export { SkillRegistryMiddlewareOptions, createSkillRegistryMiddleware };
45
+ //# sourceMappingURL=middleware.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"middleware.d.cts","names":[],"sources":["../src/middleware.ts"],"mappings":";;;;;;UAMiB,8BAAA;EACf,QAAA,EAAU,aAAA;AAAA;;;AADZ;;;;;AAiBA;;;;;;iBAAgB,6BAAA,CAAA;EACd;AAAA,GACC,8BAAA,aAA8B,eAAA,iCAAA,SAAA,CAAA,qBAAA,SAAA,SAAA;cAAA,OAAA,CAAA,SAAA;AAAA;;;;;cAAA,OAAA,CAAA,SAAA;;;;;;;;;gCA4BD,KAAA,EAAS,CAAA,KAAI,CAAA;AAAA"}
@@ -0,0 +1,46 @@
1
+ import { SkillRegistry } from "./intelligence-delivery-core/dist/registry.mjs";
2
+ import "./intelligence-delivery-core/dist/index.mjs";
3
+ import * as langchain from "langchain";
4
+ import * as zod_v40 from "zod/v4";
5
+ import * as zod_v4_core0 from "zod/v4/core";
6
+
7
+ //#region src/middleware.d.ts
8
+ interface SkillRegistryMiddlewareOptions {
9
+ registry: SkillRegistry;
10
+ }
11
+ /**
12
+ * Add learned skills through native middleware and wrap the agent once.
13
+ *
14
+ * The wrapper owns invocation state outside LangGraph checkpoints. Always call
15
+ * the returned agent, including for streams and interrupted-run resumes.
16
+ * Set default cancellation signals on the wrapped agent with withConfig, or
17
+ * pass them per invocation, so they also cancel the initial delivery wait.
18
+ *
19
+ * @example
20
+ * const skills = createSkillRegistryMiddleware({ registry });
21
+ * const agent = skills.wrapAgent(createAgent({ model, middleware: [skills] }));
22
+ * await agent.invoke({ messages: [{ role: "user", content: "Help me" }] });
23
+ */
24
+ declare function createSkillRegistryMiddleware({
25
+ registry
26
+ }: SkillRegistryMiddlewareOptions): langchain.AgentMiddleware<undefined, undefined, unknown, [langchain.DynamicStructuredTool<zod_v40.ZodObject<{
27
+ skill_name: zod_v40.ZodString;
28
+ }, zod_v4_core0.$strip>, {
29
+ skill_name: string;
30
+ }, {
31
+ skill_name: string;
32
+ }, string, unknown, "copilotkit_load_skill">, langchain.DynamicStructuredTool<zod_v40.ZodObject<{
33
+ skill_name: zod_v40.ZodString;
34
+ path: zod_v40.ZodString;
35
+ }, zod_v4_core0.$strip>, {
36
+ skill_name: string;
37
+ path: string;
38
+ }, {
39
+ skill_name: string;
40
+ path: string;
41
+ }, string, unknown, "copilotkit_read_skill_file">], readonly []> & {
42
+ wrapAgent: <T extends object>(agent: T) => T;
43
+ };
44
+ //#endregion
45
+ export { SkillRegistryMiddlewareOptions, createSkillRegistryMiddleware };
46
+ //# sourceMappingURL=middleware.d.mts.map