@copilotkit/intelligence-langgraph 1.71.2 → 1.72.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.
- package/README.md +33 -1
- package/dist/index.cjs +3 -4
- package/dist/index.d.cts +2 -4
- package/dist/index.d.mts +2 -5
- package/dist/index.mjs +1 -3
- package/dist/intelligence-delivery-core/dist/index.cjs +1 -7
- package/dist/intelligence-delivery-core/dist/index.d.cts +2 -0
- package/dist/intelligence-delivery-core/dist/index.d.mts +2 -5
- package/dist/intelligence-delivery-core/dist/index.mjs +2 -7
- package/dist/invocation.cjs +5 -5
- package/dist/invocation.cjs.map +1 -1
- package/dist/invocation.mjs +1 -2
- package/dist/invocation.mjs.map +1 -1
- package/dist/middleware.cjs +3 -4
- package/dist/middleware.cjs.map +1 -1
- package/dist/middleware.d.cts +1 -1
- package/dist/middleware.d.mts +1 -2
- package/dist/middleware.d.mts.map +1 -1
- package/dist/middleware.mjs +1 -3
- package/dist/middleware.mjs.map +1 -1
- package/dist/skill-tools.cjs +3 -3
- package/dist/skill-tools.cjs.map +1 -1
- package/dist/skill-tools.mjs +1 -2
- package/dist/skill-tools.mjs.map +1 -1
- package/package.json +2 -3
- package/dist/intelligence-delivery-core/dist/archive.cjs +0 -130
- package/dist/intelligence-delivery-core/dist/archive.cjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/archive.mjs +0 -127
- package/dist/intelligence-delivery-core/dist/archive.mjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/config.cjs +0 -47
- package/dist/intelligence-delivery-core/dist/config.cjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/config.d.cts +0 -17
- package/dist/intelligence-delivery-core/dist/config.d.cts.map +0 -1
- package/dist/intelligence-delivery-core/dist/config.d.mts +0 -17
- package/dist/intelligence-delivery-core/dist/config.d.mts.map +0 -1
- package/dist/intelligence-delivery-core/dist/config.mjs +0 -47
- package/dist/intelligence-delivery-core/dist/config.mjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/errors.cjs +0 -10
- package/dist/intelligence-delivery-core/dist/errors.cjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/errors.d.cts +0 -2
- package/dist/intelligence-delivery-core/dist/errors.d.mts +0 -2
- package/dist/intelligence-delivery-core/dist/errors.mjs +0 -10
- package/dist/intelligence-delivery-core/dist/errors.mjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/registry.cjs +0 -131
- package/dist/intelligence-delivery-core/dist/registry.cjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/registry.d.cts +0 -31
- package/dist/intelligence-delivery-core/dist/registry.d.cts.map +0 -1
- package/dist/intelligence-delivery-core/dist/registry.d.mts +0 -31
- package/dist/intelligence-delivery-core/dist/registry.d.mts.map +0 -1
- package/dist/intelligence-delivery-core/dist/registry.mjs +0 -130
- package/dist/intelligence-delivery-core/dist/registry.mjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/skill-content.cjs +0 -41
- package/dist/intelligence-delivery-core/dist/skill-content.cjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/skill-content.d.mts +0 -1
- package/dist/intelligence-delivery-core/dist/skill-content.mjs +0 -38
- package/dist/intelligence-delivery-core/dist/skill-content.mjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/snapshot.cjs +0 -91
- package/dist/intelligence-delivery-core/dist/snapshot.cjs.map +0 -1
- package/dist/intelligence-delivery-core/dist/snapshot.d.cts +0 -23
- package/dist/intelligence-delivery-core/dist/snapshot.d.cts.map +0 -1
- package/dist/intelligence-delivery-core/dist/snapshot.d.mts +0 -25
- package/dist/intelligence-delivery-core/dist/snapshot.d.mts.map +0 -1
- package/dist/intelligence-delivery-core/dist/snapshot.mjs +0 -90
- package/dist/intelligence-delivery-core/dist/snapshot.mjs.map +0 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# CopilotKit Intelligence skills for LangGraph
|
|
2
2
|
|
|
3
|
-
Keep one
|
|
3
|
+
Keep published skills from one or more Learning containers available to native TypeScript LangChain agents. The adapter adds an alphabetical catalog and two read tools; the model decides when to use a skill.
|
|
4
4
|
|
|
5
5
|
Requires Node.js 20.19+, LangChain 1.5.11+, LangGraph 1.4.14+, and LangChain core 1.2.10+ within major version 1. The Intelligence server must expose the learned-snapshot API, and the canonical Runtime client must include that operation.
|
|
6
6
|
|
|
@@ -46,3 +46,35 @@ Pass an existing `CopilotKitIntelligence` client from `@copilotkit/runtime/v2` a
|
|
|
46
46
|
Both `copilotkit_load_skill` and `copilotkit_read_skill_file` remain registered for an empty container. Developer instructions retain precedence over learned skills. Unsupported file content and unknown names or paths use native tool errors.
|
|
47
47
|
|
|
48
48
|
See the [learned skill delivery guide](https://docs.copilotkit.ai/intelligence/learned-skills) for managed/self-hosted setup, release prerequisites, and migration from CLI downloads.
|
|
49
|
+
|
|
50
|
+
## Multiple containers
|
|
51
|
+
|
|
52
|
+
Use the same registry with an explicit list:
|
|
53
|
+
|
|
54
|
+
```typescript
|
|
55
|
+
const registry = new SkillRegistry({
|
|
56
|
+
containers: [
|
|
57
|
+
{ id: "support", revision: "revision-123" },
|
|
58
|
+
{ id: "company-wide" },
|
|
59
|
+
],
|
|
60
|
+
});
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Each entry follows latest unless it has a revision pin. IDs must be unique and nonempty.
|
|
64
|
+
The SDK rejects an empty list or a list combined with `containerId` or top-level `revision`.
|
|
65
|
+
TypeScript rejects mixed forms at compile time too. The old interface remains supported.
|
|
66
|
+
An explicit list ignores legacy container and revision environment variables.
|
|
67
|
+
Credentials, freshness, and timeouts remain shared.
|
|
68
|
+
|
|
69
|
+
The new interface uses names such as `support/refund-policy` in the catalog and tool calls.
|
|
70
|
+
The prefix URI-encodes the container ID, so names cannot collide between containers.
|
|
71
|
+
The old interface keeps unprefixed Skill names.
|
|
72
|
+
|
|
73
|
+
Each container keeps its own cache and revision. Every invocation captures the full combined catalog.
|
|
74
|
+
A cold failure or confirmed denial from any container blocks the invocation.
|
|
75
|
+
Existing transient-error fallback applies separately to each warm container.
|
|
76
|
+
`registry.status.containers` lists per-container status and revision. Aggregate status has no revision pin.
|
|
77
|
+
|
|
78
|
+
Explicit `containers` accepts 1–50 unique container IDs and sends one batch request for all sources that need a refresh. This also applies to a list with one entry.
|
|
79
|
+
The server must support `POST /api/v1/learning/skills/batch` before you use this configuration. The SDK does not fall back to separate requests.
|
|
80
|
+
Legacy `containerId` configuration keeps its existing single-container request. Both interfaces use the same authentication configuration.
|
package/dist/index.cjs
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
-
const require_registry = require('./intelligence-delivery-core/dist/registry.cjs');
|
|
3
2
|
require('./intelligence-delivery-core/dist/index.cjs');
|
|
4
3
|
const require_middleware = require('./middleware.cjs');
|
|
5
|
-
let
|
|
4
|
+
let _copilotkit_runtime_internal_learned_skills = require("@copilotkit/runtime/internal/learned-skills");
|
|
6
5
|
|
|
7
|
-
exports.SkillDeliveryError =
|
|
8
|
-
exports.SkillRegistry =
|
|
6
|
+
exports.SkillDeliveryError = _copilotkit_runtime_internal_learned_skills.SkillDeliveryError;
|
|
7
|
+
exports.SkillRegistry = _copilotkit_runtime_internal_learned_skills.SkillRegistry;
|
|
9
8
|
exports.createSkillRegistryMiddleware = require_middleware.createSkillRegistryMiddleware;
|
package/dist/index.d.cts
CHANGED
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
import { SkillRegistryOptions } from "./intelligence-delivery-core/dist/
|
|
2
|
-
import { SkillDeliveryError, SkillDeliveryErrorCode } from "./intelligence-delivery-core/dist/errors.cjs";
|
|
3
|
-
import { SkillRegistry, SkillRegistryStatus } from "./intelligence-delivery-core/dist/registry.cjs";
|
|
1
|
+
import { SkillDeliveryError, SkillDeliveryErrorCode, SkillRegistry, SkillRegistryContainer, SkillRegistryOptions, SkillRegistryStatus } from "./intelligence-delivery-core/dist/index.cjs";
|
|
4
2
|
import { SkillRegistryMiddlewareOptions, createSkillRegistryMiddleware } from "./middleware.cjs";
|
|
5
|
-
export { SkillDeliveryError, type SkillDeliveryErrorCode, SkillRegistry, type SkillRegistryMiddlewareOptions, type SkillRegistryOptions, type SkillRegistryStatus, createSkillRegistryMiddleware };
|
|
3
|
+
export { SkillDeliveryError, type SkillDeliveryErrorCode, SkillRegistry, type SkillRegistryContainer, type SkillRegistryMiddlewareOptions, type SkillRegistryOptions, type SkillRegistryStatus, createSkillRegistryMiddleware };
|
package/dist/index.d.mts
CHANGED
|
@@ -1,6 +1,3 @@
|
|
|
1
|
-
import { SkillRegistryOptions } from "./intelligence-delivery-core/dist/
|
|
2
|
-
import { SkillDeliveryError, SkillDeliveryErrorCode } from "./intelligence-delivery-core/dist/errors.mjs";
|
|
3
|
-
import { SkillRegistry, SkillRegistryStatus } from "./intelligence-delivery-core/dist/registry.mjs";
|
|
4
|
-
import "./intelligence-delivery-core/dist/index.mjs";
|
|
1
|
+
import { SkillDeliveryError, SkillDeliveryErrorCode, SkillRegistry, SkillRegistryContainer, SkillRegistryOptions, SkillRegistryStatus } from "./intelligence-delivery-core/dist/index.mjs";
|
|
5
2
|
import { SkillRegistryMiddlewareOptions, createSkillRegistryMiddleware } from "./middleware.mjs";
|
|
6
|
-
export { SkillDeliveryError, type SkillDeliveryErrorCode, SkillRegistry, type SkillRegistryMiddlewareOptions, type SkillRegistryOptions, type SkillRegistryStatus, createSkillRegistryMiddleware };
|
|
3
|
+
export { SkillDeliveryError, type SkillDeliveryErrorCode, SkillRegistry, type SkillRegistryContainer, type SkillRegistryMiddlewareOptions, type SkillRegistryOptions, type SkillRegistryStatus, createSkillRegistryMiddleware };
|
package/dist/index.mjs
CHANGED
|
@@ -1,6 +1,4 @@
|
|
|
1
|
-
import { SkillDeliveryError } from "./intelligence-delivery-core/dist/
|
|
2
|
-
import { SkillRegistry } from "./intelligence-delivery-core/dist/registry.mjs";
|
|
3
|
-
import "./intelligence-delivery-core/dist/index.mjs";
|
|
1
|
+
import { SkillDeliveryError, SkillRegistry } from "./intelligence-delivery-core/dist/index.mjs";
|
|
4
2
|
import { createSkillRegistryMiddleware } from "./middleware.mjs";
|
|
5
3
|
|
|
6
4
|
export { SkillDeliveryError, SkillRegistry, createSkillRegistryMiddleware };
|
|
@@ -1,7 +1 @@
|
|
|
1
|
-
|
|
2
|
-
const require_archive = require('./archive.cjs');
|
|
3
|
-
const require_config = require('./config.cjs');
|
|
4
|
-
const require_snapshot = require('./snapshot.cjs');
|
|
5
|
-
const require_registry = require('./registry.cjs');
|
|
6
|
-
const require_skill_content = require('./skill-content.cjs');
|
|
7
|
-
let _copilotkit_runtime_v2 = require("@copilotkit/runtime/v2");
|
|
1
|
+
let _copilotkit_runtime_internal_learned_skills = require("@copilotkit/runtime/internal/learned-skills");
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
import { SkillDeliveryError, SkillDeliveryErrorCode, SkillRegistry, SkillRegistryContainer, SkillRegistryOptions, SkillRegistryStatus } from "@copilotkit/runtime/internal/learned-skills";
|
|
2
|
+
export { SkillDeliveryError, type SkillDeliveryErrorCode, SkillRegistry, type SkillRegistryContainer, type SkillRegistryOptions, type SkillRegistryStatus };
|
|
@@ -1,5 +1,2 @@
|
|
|
1
|
-
import { SkillRegistryOptions } from "
|
|
2
|
-
|
|
3
|
-
import { SnapshotFile, SnapshotSkill, VerifiedSnapshot } from "./snapshot.mjs";
|
|
4
|
-
import { SkillRegistry, SkillRegistryStatus } from "./registry.mjs";
|
|
5
|
-
import "./skill-content.mjs";
|
|
1
|
+
import { SkillDeliveryError, SkillDeliveryErrorCode, SkillRegistry, SkillRegistryContainer, SkillRegistryOptions, SkillRegistryStatus } from "@copilotkit/runtime/internal/learned-skills";
|
|
2
|
+
export { SkillDeliveryError, type SkillDeliveryErrorCode, SkillRegistry, type SkillRegistryContainer, type SkillRegistryOptions, type SkillRegistryStatus };
|
|
@@ -1,8 +1,3 @@
|
|
|
1
|
-
import { SkillDeliveryError,
|
|
2
|
-
import { MAX_ARCHIVE_ENTRIES, MAX_SNAPSHOT_BYTES, readArchive, safeRelativePath } from "./archive.mjs";
|
|
3
|
-
import { resolveRegistryConfig } from "./config.mjs";
|
|
4
|
-
import { validateSnapshot } from "./snapshot.mjs";
|
|
5
|
-
import { SkillRegistry } from "./registry.mjs";
|
|
6
|
-
import { formatSkillCatalog, loadSkill, readSkillFile } from "./skill-content.mjs";
|
|
1
|
+
import { SkillDeliveryError, SkillRegistry, formatSkillCatalog, loadSkill, readSkillFile } from "@copilotkit/runtime/internal/learned-skills";
|
|
7
2
|
|
|
8
|
-
export {
|
|
3
|
+
export { SkillDeliveryError, SkillRegistry, formatSkillCatalog, loadSkill, readSkillFile };
|
package/dist/invocation.cjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
require('./intelligence-delivery-core/dist/index.cjs');
|
|
2
2
|
let node_async_hooks = require("node:async_hooks");
|
|
3
3
|
let _langchain_core_utils_stream = require("@langchain/core/utils/stream");
|
|
4
|
-
let
|
|
4
|
+
let _copilotkit_runtime_internal_learned_skills = require("@copilotkit/runtime/internal/learned-skills");
|
|
5
5
|
|
|
6
6
|
//#region src/invocation.ts
|
|
7
7
|
const entries = new Set([
|
|
@@ -17,12 +17,12 @@ var SkillInvocationScope = class {
|
|
|
17
17
|
#wrapped = /* @__PURE__ */ new WeakMap();
|
|
18
18
|
#defaultSignals = /* @__PURE__ */ new WeakMap();
|
|
19
19
|
constructor(registry) {
|
|
20
|
-
if (!registry || typeof registry.acquireSnapshot !== "function") throw new
|
|
20
|
+
if (!registry || typeof registry.acquireSnapshot !== "function") throw new _copilotkit_runtime_internal_learned_skills.SkillDeliveryError("INVALID_CONFIG", false);
|
|
21
21
|
this.#registry = registry;
|
|
22
22
|
}
|
|
23
23
|
snapshot() {
|
|
24
24
|
const invocation = this.#storage.getStore();
|
|
25
|
-
if (!invocation) throw new
|
|
25
|
+
if (!invocation) throw new _copilotkit_runtime_internal_learned_skills.SkillDeliveryError("INVALID_CONFIG", false);
|
|
26
26
|
return invocation.snapshot ??= Promise.resolve().then(() => this.#registry.acquireSnapshot());
|
|
27
27
|
}
|
|
28
28
|
async #prepare(signal) {
|
|
@@ -110,7 +110,7 @@ var SkillInvocationScope = class {
|
|
|
110
110
|
return first && second && first !== second ? AbortSignal.any([first, second]) : first ?? second;
|
|
111
111
|
}
|
|
112
112
|
wrapAgent(agent) {
|
|
113
|
-
if (!agent || typeof agent !== "object" && typeof agent !== "function" || ![...entries].every((key) => typeof Reflect.get(agent, key, agent) === "function")) throw new
|
|
113
|
+
if (!agent || typeof agent !== "object" && typeof agent !== "function" || ![...entries].every((key) => typeof Reflect.get(agent, key, agent) === "function")) throw new _copilotkit_runtime_internal_learned_skills.SkillDeliveryError("INVALID_CONFIG", false);
|
|
114
114
|
const existing = this.#wrapped.get(agent);
|
|
115
115
|
if (existing) return existing;
|
|
116
116
|
const methods = /* @__PURE__ */ new Map();
|
|
@@ -142,7 +142,7 @@ var SkillInvocationScope = class {
|
|
|
142
142
|
return this.wrapAgent(configured);
|
|
143
143
|
};
|
|
144
144
|
else if (unsupportedEntries.has(key)) bound = () => {
|
|
145
|
-
throw new
|
|
145
|
+
throw new _copilotkit_runtime_internal_learned_skills.SkillDeliveryError("INVALID_CONFIG", false);
|
|
146
146
|
};
|
|
147
147
|
else bound = value.bind(target);
|
|
148
148
|
methods.set(key, {
|
package/dist/invocation.cjs.map
CHANGED
|
@@ -1 +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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"}
|
|
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":";;;;;;AAUA,MAAM,UAAU,IAAI,IAAiB;CAAC;CAAU;CAAU;CAAe,CAAC;AAC1E,MAAM,qBAAqB,IAAI,IAAiB,CAAC,SAAS,mBAAmB,CAAC;;AAG9E,IAAa,uBAAb,MAAkC;CAChC,CAASA;CACT,CAASC,UAAW,IAAIC,oCAA+B;CACvD,CAASC,0BAAW,IAAI,SAAyB;CACjD,CAASC,iCAAkB,IAAI,SAA8B;CAE7D,YAAY,UAAyB;AACnC,MAAI,CAAC,YAAY,OAAO,SAAS,oBAAoB,WACnD,OAAM,IAAIC,+DAAmB,kBAAkB,MAAM;AAEvD,QAAKL,WAAY;;CAGnB,WAAsC;EACpC,MAAM,aAAa,MAAKC,QAAS,UAAU;AAC3C,MAAI,CAAC,WAEH,OAAM,IAAII,+DAAmB,kBAAkB,MAAM;AAGvD,SAAQ,WAAW,aAAa,QAAQ,SAAS,CAAC,WAChD,MAAKL,SAAU,iBAAiB,CACjC;;CAGH,OAAMM,QAAS,QAAqC;AAClD,UAAQ,gBAAgB;EACxB,MAAM,WAAW,KAAK,UAAU;AAChC,MAAI,CAAC,QAAQ;AACX,SAAM;AACN;;EAEF,IAAI;AACJ,MAAI;AACF,SAAM,QAAQ,KAAK,CACjB,UACA,IAAI,SAAgB,GAAG,WAAW;AAChC,kBAAc,OAAO,OAAO,OAAO;AACnC,WAAO,iBAAiB,SAAS,OAAO,EAAE,MAAM,MAAM,CAAC;AACvD,QAAI,OAAO,QAAS,QAAO;KAC3B,CACH,CAAC;AACF,UAAO,gBAAgB;YACf;AACR,UAAO,oBAAoB,SAAS,MAAM;;;CAI9C,UACE,QACA,QACA,MACA,QACS;EACT,MAAM,SAAS,KAAK;AACpB,MAAI,CAAC,UAAU,WAAW,QAAQ,OAChC,QAAO,QAAQ,MAAM,QAAQ,QAAQ,KAAK;EAG5C,MAAM,YAAY,CAAC,GAAG,KAAK;AAC3B,YAAU,KAAK;GAAE,GAAG;GAAQ;GAAQ;AACpC,SAAO,QAAQ,MAAM,QAAQ,QAAQ,UAAU;;CAGjD,aACE,QACA,QACA,MACA,QACiC;EACjC,MAAM,eAAe,IAAI,iBAAiB;EAC1C,MAAM,qBAAqB,aAAa,MAAM,QAAQ,OAAO;AAC7D,UAAQ,iBAAiB,SAAS,cAAc,EAAE,MAAM,MAAM,CAAC;AAC/D,MAAI,QAAQ,QAAS,eAAc;EACnC,IAAI;EACJ,IAAI;EACJ,IAAI,YAAY;EAChB,MAAM,gBAAgB;AACpB,WAAQ,aAAa;AACrB,YAAS;;EAIX,MAAM,QAAQ,MAAKA,QAAS,aAAa,OAAO,CAC7C,WAAW;AACV,gBAAa,OAAO,gBAAgB;AACpC,YAAS,MAAKC,SACZ,QACA,QACA,MACA,OACD;AACD,YAAS,OAAQ,WAAW;IAC5B,CACD,cAAc,QAAQ,oBAAoB,SAAS,aAAa,CAAC;AAEpE,EAAK,MAAM,YAAY,OAAU;AACjC,SAAO,IAAIC,oDAAgC;GACzC,MAAM,OAAO,eAAe;AAC1B,QAAI;AACF,WAAM;AACN,SAAI,UAAW;KACf,MAAM,QAAQ,MAAM,OAAQ,MAAM;AAClC,SAAI,UAAW;AACf,SAAI,MAAM,MAAM;AACd,iBAAW,OAAO;AAClB,eAAS;WACJ,YAAW,QAAQ,MAAM,MAAM;aAC/B,OAAO;AACd,SAAI,CAAC,WAAW;AACd,iBAAW,MAAM,MAAM;AACvB,eAAS;;;;GAIf,QAAQ,OAAO,WAAW;AACxB,gBAAY;AACZ,iBAAa,MAAM,OAAO;AAC1B,UAAM,MAAM,YAAY,OAAU;AAClC,QAAI;AAEF,SAAI,UAAU,YAAY,OAAQ,OAAM,OAAO,OAAO,OAAO;AAC7D,WAAM,QAAQ,OAAO,OAAO;cACpB;AACR,cAAS;;;GAGd,CAAC;;CAGJ,eAAe,OAAwC;AACrD,SACE,MAAKJ,eAAgB,IAAI,MAAM,IAC/B,QAAQ,IAAI,OAAO,UAAU,MAAM,EAAE;;CAIzC,aACE,OACA,QACyB;AACzB,SAAO,SAAS,UAAU,UAAU,SAChC,YAAY,IAAI,CAAC,OAAO,OAAO,CAAC,GAC/B,SAAS;;CAGhB,UAA4B,OAAa;AACvC,MACE,CAAC,SACA,OAAO,UAAU,YAAY,OAAO,UAAU,cAC/C,CAAC,CAAC,GAAG,QAAQ,CAAC,OACX,QAAQ,OAAO,QAAQ,IAAI,OAAO,KAAK,MAAM,KAAK,WACpD,CAED,OAAM,IAAIC,+DAAmB,kBAAkB,MAAM;EAEvD,MAAM,WAAW,MAAKF,QAAS,IAAI,MAAM;AACzC,MAAI,SAAU,QAAO;EACrB,MAAM,0BAAU,IAAI,KAGjB;EACH,MAAM,QAAQ,IAAI,MAAM,OAAO;GAC7B,MAAM,QAAQ,QAAQ;IAEpB,MAAM,QAAQ,QAAQ,IAAI,QAAQ,KAAK,OAAO;AAC9C,QAAI,QAAQ,WAAW,SAAS,OAAO,UAAU,UAAU;KACzD,MAAM,SAAS,MAAKM,YAClB,MAAKC,cAAe,MAAM,EAC1B,MAAKA,cAAe,OAAO,CAC5B;AACD,SAAI,OAAQ,OAAKN,eAAgB,IAAI,OAAO,OAAO;AACnD,YAAO,KAAK,UAAU,MAAM;;AAE9B,QAAI,OAAO,UAAU,cAAc,QAAQ,cAAe,QAAO;IACjE,MAAM,SAAS,QAAQ,IAAI,IAAI;AAC/B,QAAI,QAAQ,WAAW,MAAO,QAAO,OAAO;IAC5C,IAAI;AACJ,QAAI,QAAQ,IAAI,IAAI,CAClB,UAAS,GAAG,SACV,MAAKH,QAAS,IAAI,EAAE,QAAQ;KAC1B,MAAM,SAAS,KAAK;KAGpB,MAAM,SAAS,MAAKQ,YAClB,MAAKC,cAAe,OAAO,EAC3B,QAAQ,OACT;AACD,SACE,QAAQ,mBACP,QAAQ,YAAY,QAAQ,KAAK,MAAM,MAExC,QAAO,MAAKC,YAAa,OAAO,QAAQ,MAAM,OAAO;AAEvD,YAAO,MAAKL,QAAS,OAAO,CAAC,WAAW;AACtC,cAAQ,gBAAgB;AACxB,aAAO,MAAKC,SAAU,OAAO,QAAQ,MAAM,OAAO;OAClD;MACF;aACK,QAAQ,aACjB,UAAS,GAAG,SAAoB;KAC9B,MAAM,aAAa,QAAQ,MAAM,OAAO,QAAQ,KAAK;KACrD,MAAM,SAAS,MAAKE,YAClB,MAAKC,cAAe,OAAO,EAC1B,KAAK,IAA6C,OACpD;AACD,SAAI,OAAQ,OAAKN,eAAgB,IAAI,YAAY,OAAO;AACxD,YAAO,KAAK,UAAU,WAAW;;aAE1B,mBAAmB,IAAI,IAAI,CAGpC,eAAc;AACZ,WAAM,IAAIC,+DAAmB,kBAAkB,MAAM;;QAGvD,SAAQ,MAAM,KAAK,OAAO;AAE5B,YAAQ,IAAI,KAAK;KAAE,QAAQ;KAAO;KAAO,CAAC;AAC1C,WAAO;;GAET,MAAM,QAAQ,KAAK,UAAU,QAAQ,IAAI,QAAQ,KAAK,OAAO,OAAO;GACrE,CAAC;AACF,QAAKF,QAAS,IAAI,OAAO,MAAM;AAC/B,QAAKA,QAAS,IAAI,OAAO,MAAM;AAC/B,SAAO"}
|
package/dist/invocation.mjs
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import { SkillDeliveryError } from "./intelligence-delivery-core/dist/
|
|
2
|
-
import "./intelligence-delivery-core/dist/index.mjs";
|
|
1
|
+
import { SkillDeliveryError } from "./intelligence-delivery-core/dist/index.mjs";
|
|
3
2
|
import { AsyncLocalStorage } from "node:async_hooks";
|
|
4
3
|
import { IterableReadableStream } from "@langchain/core/utils/stream";
|
|
5
4
|
|
package/dist/invocation.mjs.map
CHANGED
|
@@ -1 +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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"}
|
|
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":";;;;;AAUA,MAAM,UAAU,IAAI,IAAiB;CAAC;CAAU;CAAU;CAAe,CAAC;AAC1E,MAAM,qBAAqB,IAAI,IAAiB,CAAC,SAAS,mBAAmB,CAAC;;AAG9E,IAAa,uBAAb,MAAkC;CAChC,CAASA;CACT,CAASC,UAAW,IAAI,mBAA+B;CACvD,CAASC,0BAAW,IAAI,SAAyB;CACjD,CAASC,iCAAkB,IAAI,SAA8B;CAE7D,YAAY,UAAyB;AACnC,MAAI,CAAC,YAAY,OAAO,SAAS,oBAAoB,WACnD,OAAM,IAAI,mBAAmB,kBAAkB,MAAM;AAEvD,QAAKH,WAAY;;CAGnB,WAAsC;EACpC,MAAM,aAAa,MAAKC,QAAS,UAAU;AAC3C,MAAI,CAAC,WAEH,OAAM,IAAI,mBAAmB,kBAAkB,MAAM;AAGvD,SAAQ,WAAW,aAAa,QAAQ,SAAS,CAAC,WAChD,MAAKD,SAAU,iBAAiB,CACjC;;CAGH,OAAMI,QAAS,QAAqC;AAClD,UAAQ,gBAAgB;EACxB,MAAM,WAAW,KAAK,UAAU;AAChC,MAAI,CAAC,QAAQ;AACX,SAAM;AACN;;EAEF,IAAI;AACJ,MAAI;AACF,SAAM,QAAQ,KAAK,CACjB,UACA,IAAI,SAAgB,GAAG,WAAW;AAChC,kBAAc,OAAO,OAAO,OAAO;AACnC,WAAO,iBAAiB,SAAS,OAAO,EAAE,MAAM,MAAM,CAAC;AACvD,QAAI,OAAO,QAAS,QAAO;KAC3B,CACH,CAAC;AACF,UAAO,gBAAgB;YACf;AACR,UAAO,oBAAoB,SAAS,MAAM;;;CAI9C,UACE,QACA,QACA,MACA,QACS;EACT,MAAM,SAAS,KAAK;AACpB,MAAI,CAAC,UAAU,WAAW,QAAQ,OAChC,QAAO,QAAQ,MAAM,QAAQ,QAAQ,KAAK;EAG5C,MAAM,YAAY,CAAC,GAAG,KAAK;AAC3B,YAAU,KAAK;GAAE,GAAG;GAAQ;GAAQ;AACpC,SAAO,QAAQ,MAAM,QAAQ,QAAQ,UAAU;;CAGjD,aACE,QACA,QACA,MACA,QACiC;EACjC,MAAM,eAAe,IAAI,iBAAiB;EAC1C,MAAM,qBAAqB,aAAa,MAAM,QAAQ,OAAO;AAC7D,UAAQ,iBAAiB,SAAS,cAAc,EAAE,MAAM,MAAM,CAAC;AAC/D,MAAI,QAAQ,QAAS,eAAc;EACnC,IAAI;EACJ,IAAI;EACJ,IAAI,YAAY;EAChB,MAAM,gBAAgB;AACpB,WAAQ,aAAa;AACrB,YAAS;;EAIX,MAAM,QAAQ,MAAKA,QAAS,aAAa,OAAO,CAC7C,WAAW;AACV,gBAAa,OAAO,gBAAgB;AACpC,YAAS,MAAKC,SACZ,QACA,QACA,MACA,OACD;AACD,YAAS,OAAQ,WAAW;IAC5B,CACD,cAAc,QAAQ,oBAAoB,SAAS,aAAa,CAAC;AAEpE,EAAK,MAAM,YAAY,OAAU;AACjC,SAAO,IAAI,uBAAgC;GACzC,MAAM,OAAO,eAAe;AAC1B,QAAI;AACF,WAAM;AACN,SAAI,UAAW;KACf,MAAM,QAAQ,MAAM,OAAQ,MAAM;AAClC,SAAI,UAAW;AACf,SAAI,MAAM,MAAM;AACd,iBAAW,OAAO;AAClB,eAAS;WACJ,YAAW,QAAQ,MAAM,MAAM;aAC/B,OAAO;AACd,SAAI,CAAC,WAAW;AACd,iBAAW,MAAM,MAAM;AACvB,eAAS;;;;GAIf,QAAQ,OAAO,WAAW;AACxB,gBAAY;AACZ,iBAAa,MAAM,OAAO;AAC1B,UAAM,MAAM,YAAY,OAAU;AAClC,QAAI;AAEF,SAAI,UAAU,YAAY,OAAQ,OAAM,OAAO,OAAO,OAAO;AAC7D,WAAM,QAAQ,OAAO,OAAO;cACpB;AACR,cAAS;;;GAGd,CAAC;;CAGJ,eAAe,OAAwC;AACrD,SACE,MAAKF,eAAgB,IAAI,MAAM,IAC/B,QAAQ,IAAI,OAAO,UAAU,MAAM,EAAE;;CAIzC,aACE,OACA,QACyB;AACzB,SAAO,SAAS,UAAU,UAAU,SAChC,YAAY,IAAI,CAAC,OAAO,OAAO,CAAC,GAC/B,SAAS;;CAGhB,UAA4B,OAAa;AACvC,MACE,CAAC,SACA,OAAO,UAAU,YAAY,OAAO,UAAU,cAC/C,CAAC,CAAC,GAAG,QAAQ,CAAC,OACX,QAAQ,OAAO,QAAQ,IAAI,OAAO,KAAK,MAAM,KAAK,WACpD,CAED,OAAM,IAAI,mBAAmB,kBAAkB,MAAM;EAEvD,MAAM,WAAW,MAAKD,QAAS,IAAI,MAAM;AACzC,MAAI,SAAU,QAAO;EACrB,MAAM,0BAAU,IAAI,KAGjB;EACH,MAAM,QAAQ,IAAI,MAAM,OAAO;GAC7B,MAAM,QAAQ,QAAQ;IAEpB,MAAM,QAAQ,QAAQ,IAAI,QAAQ,KAAK,OAAO;AAC9C,QAAI,QAAQ,WAAW,SAAS,OAAO,UAAU,UAAU;KACzD,MAAM,SAAS,MAAKI,YAClB,MAAKC,cAAe,MAAM,EAC1B,MAAKA,cAAe,OAAO,CAC5B;AACD,SAAI,OAAQ,OAAKJ,eAAgB,IAAI,OAAO,OAAO;AACnD,YAAO,KAAK,UAAU,MAAM;;AAE9B,QAAI,OAAO,UAAU,cAAc,QAAQ,cAAe,QAAO;IACjE,MAAM,SAAS,QAAQ,IAAI,IAAI;AAC/B,QAAI,QAAQ,WAAW,MAAO,QAAO,OAAO;IAC5C,IAAI;AACJ,QAAI,QAAQ,IAAI,IAAI,CAClB,UAAS,GAAG,SACV,MAAKF,QAAS,IAAI,EAAE,QAAQ;KAC1B,MAAM,SAAS,KAAK;KAGpB,MAAM,SAAS,MAAKK,YAClB,MAAKC,cAAe,OAAO,EAC3B,QAAQ,OACT;AACD,SACE,QAAQ,mBACP,QAAQ,YAAY,QAAQ,KAAK,MAAM,MAExC,QAAO,MAAKC,YAAa,OAAO,QAAQ,MAAM,OAAO;AAEvD,YAAO,MAAKJ,QAAS,OAAO,CAAC,WAAW;AACtC,cAAQ,gBAAgB;AACxB,aAAO,MAAKC,SAAU,OAAO,QAAQ,MAAM,OAAO;OAClD;MACF;aACK,QAAQ,aACjB,UAAS,GAAG,SAAoB;KAC9B,MAAM,aAAa,QAAQ,MAAM,OAAO,QAAQ,KAAK;KACrD,MAAM,SAAS,MAAKC,YAClB,MAAKC,cAAe,OAAO,EAC1B,KAAK,IAA6C,OACpD;AACD,SAAI,OAAQ,OAAKJ,eAAgB,IAAI,YAAY,OAAO;AACxD,YAAO,KAAK,UAAU,WAAW;;aAE1B,mBAAmB,IAAI,IAAI,CAGpC,eAAc;AACZ,WAAM,IAAI,mBAAmB,kBAAkB,MAAM;;QAGvD,SAAQ,MAAM,KAAK,OAAO;AAE5B,YAAQ,IAAI,KAAK;KAAE,QAAQ;KAAO;KAAO,CAAC;AAC1C,WAAO;;GAET,MAAM,QAAQ,KAAK,UAAU,QAAQ,IAAI,QAAQ,KAAK,OAAO,OAAO;GACrE,CAAC;AACF,QAAKD,QAAS,IAAI,OAAO,MAAM;AAC/B,QAAKA,QAAS,IAAI,OAAO,MAAM;AAC/B,SAAO"}
|
package/dist/middleware.cjs
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
const require_skill_content = require('./intelligence-delivery-core/dist/skill-content.cjs');
|
|
2
1
|
require('./intelligence-delivery-core/dist/index.cjs');
|
|
3
2
|
const require_invocation = require('./invocation.cjs');
|
|
4
3
|
const require_skill_tools = require('./skill-tools.cjs');
|
|
5
4
|
let langchain = require("langchain");
|
|
6
|
-
let
|
|
5
|
+
let _copilotkit_runtime_internal_learned_skills = require("@copilotkit/runtime/internal/learned-skills");
|
|
7
6
|
|
|
8
7
|
//#region src/middleware.ts
|
|
9
8
|
/**
|
|
@@ -20,7 +19,7 @@ let _copilotkit_runtime_v2 = require("@copilotkit/runtime/v2");
|
|
|
20
19
|
* await agent.invoke({ messages: [{ role: "user", content: "Help me" }] });
|
|
21
20
|
*/
|
|
22
21
|
function createSkillRegistryMiddleware({ registry }) {
|
|
23
|
-
if (!registry || typeof registry.acquireSnapshot !== "function") throw new
|
|
22
|
+
if (!registry || typeof registry.acquireSnapshot !== "function") throw new _copilotkit_runtime_internal_learned_skills.SkillDeliveryError("INVALID_CONFIG", false);
|
|
24
23
|
const scope = new require_invocation.SkillInvocationScope(registry);
|
|
25
24
|
const middleware = (0, langchain.createMiddleware)({
|
|
26
25
|
name: "CopilotKitSkillRegistry",
|
|
@@ -29,7 +28,7 @@ function createSkillRegistryMiddleware({ registry }) {
|
|
|
29
28
|
await scope.snapshot();
|
|
30
29
|
},
|
|
31
30
|
wrapModelCall: async (request, handler) => {
|
|
32
|
-
const catalog =
|
|
31
|
+
const catalog = (0, _copilotkit_runtime_internal_learned_skills.formatSkillCatalog)(await scope.snapshot());
|
|
33
32
|
const systemMessage = request.systemMessage ?? new langchain.SystemMessage(request.systemPrompt ?? "");
|
|
34
33
|
return handler({
|
|
35
34
|
...request,
|
package/dist/middleware.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"middleware.cjs","names":["SkillDeliveryError","SkillInvocationScope","createSkillTools","
|
|
1
|
+
{"version":3,"file":"middleware.cjs","names":["SkillDeliveryError","SkillInvocationScope","createSkillTools","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,+DAAmB,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,8EAA6B,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"}
|
package/dist/middleware.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { SkillRegistry } from "./intelligence-delivery-core/dist/
|
|
1
|
+
import { SkillRegistry } from "./intelligence-delivery-core/dist/index.cjs";
|
|
2
2
|
import * as zod_v40 from "zod/v4";
|
|
3
3
|
import * as zod_v4_core0 from "zod/v4/core";
|
|
4
4
|
import * as langchain from "langchain";
|
package/dist/middleware.d.mts
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import { SkillRegistry } from "./intelligence-delivery-core/dist/
|
|
2
|
-
import "./intelligence-delivery-core/dist/index.mjs";
|
|
1
|
+
import { SkillRegistry } from "./intelligence-delivery-core/dist/index.mjs";
|
|
3
2
|
import * as langchain from "langchain";
|
|
4
3
|
import * as zod_v40 from "zod/v4";
|
|
5
4
|
import * as zod_v4_core0 from "zod/v4/core";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"middleware.d.mts","names":[],"sources":["../src/middleware.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"middleware.d.mts","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"}
|
package/dist/middleware.mjs
CHANGED
|
@@ -1,6 +1,4 @@
|
|
|
1
|
-
import { SkillDeliveryError } from "./intelligence-delivery-core/dist/
|
|
2
|
-
import { formatSkillCatalog } from "./intelligence-delivery-core/dist/skill-content.mjs";
|
|
3
|
-
import "./intelligence-delivery-core/dist/index.mjs";
|
|
1
|
+
import { SkillDeliveryError, formatSkillCatalog } from "./intelligence-delivery-core/dist/index.mjs";
|
|
4
2
|
import { SkillInvocationScope } from "./invocation.mjs";
|
|
5
3
|
import { createSkillTools } from "./skill-tools.mjs";
|
|
6
4
|
import { SystemMessage, createMiddleware } from "langchain";
|
package/dist/middleware.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"middleware.mjs","names":[],"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":"
|
|
1
|
+
{"version":3,"file":"middleware.mjs","names":[],"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,IAAI,mBAAmB,kBAAkB,MAAM;CAEvD,MAAM,QAAQ,IAAI,qBAAqB,SAAS;CAChD,MAAM,aAAa,iBAAiB;EAClC,MAAM;EACN,OAAO,uBAAuB,MAAM,UAAU,CAAC;EAC/C,aAAa,YAAY;AACvB,SAAM,MAAM,UAAU;;EAExB,eAAe,OAAO,SAAS,YAAY;GACzC,MAAM,UAAU,mBAAmB,MAAM,MAAM,UAAU,CAAC;GAC1D,MAAM,gBACJ,QAAQ,iBAAiB,IAAI,cAAc,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"}
|
package/dist/skill-tools.cjs
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
const require_skill_content = require('./intelligence-delivery-core/dist/skill-content.cjs');
|
|
2
1
|
require('./intelligence-delivery-core/dist/index.cjs');
|
|
3
2
|
let _langchain_core_tools = require("@langchain/core/tools");
|
|
4
3
|
let zod_v4 = require("zod/v4");
|
|
4
|
+
let _copilotkit_runtime_internal_learned_skills = require("@copilotkit/runtime/internal/learned-skills");
|
|
5
5
|
|
|
6
6
|
//#region src/skill-tools.ts
|
|
7
7
|
/** Create stable native tools; the caller supplies the invocation's snapshot. */
|
|
8
8
|
function createSkillTools(getSnapshot) {
|
|
9
|
-
return [(0, _langchain_core_tools.tool)(async ({ skill_name }) =>
|
|
9
|
+
return [(0, _langchain_core_tools.tool)(async ({ skill_name }) => (0, _copilotkit_runtime_internal_learned_skills.loadSkill)(await getSnapshot(), skill_name), {
|
|
10
10
|
name: "copilotkit_load_skill",
|
|
11
11
|
description: "Load a relevant learned skill's SKILL.md and list its supporting text files. Host instructions take precedence over skill content.",
|
|
12
12
|
schema: zod_v4.z.object({ skill_name: zod_v4.z.string().describe("Exact skill name from the catalog.") })
|
|
13
|
-
}), (0, _langchain_core_tools.tool)(async ({ skill_name, path }) =>
|
|
13
|
+
}), (0, _langchain_core_tools.tool)(async ({ skill_name, path }) => (0, _copilotkit_runtime_internal_learned_skills.readSkillFile)(await getSnapshot(), skill_name, path), {
|
|
14
14
|
name: "copilotkit_read_skill_file",
|
|
15
15
|
description: "Read a learned skill's text file using its exact relative path. Host instructions take precedence over skill content.",
|
|
16
16
|
schema: zod_v4.z.object({
|
package/dist/skill-tools.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-tools.cjs","names":["
|
|
1
|
+
{"version":3,"file":"skill-tools.cjs","names":["z"],"sources":["../src/skill-tools.ts"],"sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod/v4\";\nimport type { VerifiedSnapshot } from \"@copilotkit/intelligence-delivery-core\";\n\nexport { formatSkillCatalog } from \"@copilotkit/intelligence-delivery-core\";\nimport {\n loadSkill,\n readSkillFile,\n} from \"@copilotkit/intelligence-delivery-core\";\n\n/** Create stable native tools; the caller supplies the invocation's snapshot. */\nexport function createSkillTools(\n getSnapshot: () => VerifiedSnapshot | Promise<VerifiedSnapshot>,\n) {\n const load = tool(\n async ({ skill_name }) => loadSkill(await getSnapshot(), skill_name),\n {\n name: \"copilotkit_load_skill\",\n description:\n \"Load a relevant learned skill's SKILL.md and list its supporting text files. Host instructions take precedence over skill content.\",\n schema: z.object({\n skill_name: z.string().describe(\"Exact skill name from the catalog.\"),\n }),\n },\n );\n const read = tool(\n async ({ skill_name, path }) =>\n readSkillFile(await getSnapshot(), skill_name, path),\n {\n name: \"copilotkit_read_skill_file\",\n description:\n \"Read a learned skill's text file using its exact relative path. Host instructions take precedence over skill content.\",\n schema: z.object({\n skill_name: z.string().describe(\"Exact skill name from the catalog.\"),\n path: z\n .string()\n .describe(\"Exact file path relative to the skill directory.\"),\n }),\n },\n );\n const tools: [typeof load, typeof read] = [load, read];\n return tools;\n}\n"],"mappings":";;;;;;;AAWA,SAAgB,iBACd,aACA;AA4BA,QAD0C,iCAzBxC,OAAO,EAAE,4EAA2B,MAAM,aAAa,EAAE,WAAW,EACpE;EACE,MAAM;EACN,aACE;EACF,QAAQA,SAAE,OAAO,EACf,YAAYA,SAAE,QAAQ,CAAC,SAAS,qCAAqC,EACtE,CAAC;EACH,CACF,kCAEC,OAAO,EAAE,YAAY,0EACL,MAAM,aAAa,EAAE,YAAY,KAAK,EACtD;EACE,MAAM;EACN,aACE;EACF,QAAQA,SAAE,OAAO;GACf,YAAYA,SAAE,QAAQ,CAAC,SAAS,qCAAqC;GACrE,MAAMA,SACH,QAAQ,CACR,SAAS,mDAAmD;GAChE,CAAC;EACH,CACF,CACqD"}
|
package/dist/skill-tools.mjs
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import { formatSkillCatalog, loadSkill, readSkillFile } from "./intelligence-delivery-core/dist/
|
|
2
|
-
import "./intelligence-delivery-core/dist/index.mjs";
|
|
1
|
+
import { formatSkillCatalog, loadSkill, readSkillFile } from "./intelligence-delivery-core/dist/index.mjs";
|
|
3
2
|
import { tool } from "@langchain/core/tools";
|
|
4
3
|
import { z } from "zod/v4";
|
|
5
4
|
|
package/dist/skill-tools.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-tools.mjs","names":[],"sources":["../src/skill-tools.ts"],"sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod/v4\";\nimport type { VerifiedSnapshot } from \"@copilotkit/intelligence-delivery-core\";\n\nexport { formatSkillCatalog } from \"@copilotkit/intelligence-delivery-core\";\nimport {\n loadSkill,\n readSkillFile,\n} from \"@copilotkit/intelligence-delivery-core\";\n\n/** Create stable native tools; the caller supplies the invocation's snapshot. */\nexport function createSkillTools(\n getSnapshot: () => VerifiedSnapshot | Promise<VerifiedSnapshot>,\n) {\n const load = tool(\n async ({ skill_name }) => loadSkill(await getSnapshot(), skill_name),\n {\n name: \"copilotkit_load_skill\",\n description:\n \"Load a relevant learned skill's SKILL.md and list its supporting text files. Host instructions take precedence over skill content.\",\n schema: z.object({\n skill_name: z.string().describe(\"Exact skill name from the catalog.\"),\n }),\n },\n );\n const read = tool(\n async ({ skill_name, path }) =>\n readSkillFile(await getSnapshot(), skill_name, path),\n {\n name: \"copilotkit_read_skill_file\",\n description:\n \"Read a learned skill's text file using its exact relative path. Host instructions take precedence over skill content.\",\n schema: z.object({\n skill_name: z.string().describe(\"Exact skill name from the catalog.\"),\n path: z\n .string()\n .describe(\"Exact file path relative to the skill directory.\"),\n }),\n },\n );\n const tools: [typeof load, typeof read] = [load, read];\n return tools;\n}\n"],"mappings":"
|
|
1
|
+
{"version":3,"file":"skill-tools.mjs","names":[],"sources":["../src/skill-tools.ts"],"sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod/v4\";\nimport type { VerifiedSnapshot } from \"@copilotkit/intelligence-delivery-core\";\n\nexport { formatSkillCatalog } from \"@copilotkit/intelligence-delivery-core\";\nimport {\n loadSkill,\n readSkillFile,\n} from \"@copilotkit/intelligence-delivery-core\";\n\n/** Create stable native tools; the caller supplies the invocation's snapshot. */\nexport function createSkillTools(\n getSnapshot: () => VerifiedSnapshot | Promise<VerifiedSnapshot>,\n) {\n const load = tool(\n async ({ skill_name }) => loadSkill(await getSnapshot(), skill_name),\n {\n name: \"copilotkit_load_skill\",\n description:\n \"Load a relevant learned skill's SKILL.md and list its supporting text files. Host instructions take precedence over skill content.\",\n schema: z.object({\n skill_name: z.string().describe(\"Exact skill name from the catalog.\"),\n }),\n },\n );\n const read = tool(\n async ({ skill_name, path }) =>\n readSkillFile(await getSnapshot(), skill_name, path),\n {\n name: \"copilotkit_read_skill_file\",\n description:\n \"Read a learned skill's text file using its exact relative path. Host instructions take precedence over skill content.\",\n schema: z.object({\n skill_name: z.string().describe(\"Exact skill name from the catalog.\"),\n path: z\n .string()\n .describe(\"Exact file path relative to the skill directory.\"),\n }),\n },\n );\n const tools: [typeof load, typeof read] = [load, read];\n return tools;\n}\n"],"mappings":";;;;;;AAWA,SAAgB,iBACd,aACA;AA4BA,QAD0C,CA1B7B,KACX,OAAO,EAAE,iBAAiB,UAAU,MAAM,aAAa,EAAE,WAAW,EACpE;EACE,MAAM;EACN,aACE;EACF,QAAQ,EAAE,OAAO,EACf,YAAY,EAAE,QAAQ,CAAC,SAAS,qCAAqC,EACtE,CAAC;EACH,CACF,EACY,KACX,OAAO,EAAE,YAAY,WACnB,cAAc,MAAM,aAAa,EAAE,YAAY,KAAK,EACtD;EACE,MAAM;EACN,aACE;EACF,QAAQ,EAAE,OAAO;GACf,YAAY,EAAE,QAAQ,CAAC,SAAS,qCAAqC;GACrE,MAAM,EACH,QAAQ,CACR,SAAS,mDAAmD;GAChE,CAAC;EACH,CACF,CACqD"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@copilotkit/intelligence-langgraph",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.72.0",
|
|
4
4
|
"description": "Learned skill delivery for LangGraph agents through CopilotKit Intelligence",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -25,8 +25,7 @@
|
|
|
25
25
|
"access": "public"
|
|
26
26
|
},
|
|
27
27
|
"dependencies": {
|
|
28
|
-
"
|
|
29
|
-
"@copilotkit/runtime": "1.71.2"
|
|
28
|
+
"@copilotkit/runtime": "^1.79.1"
|
|
30
29
|
},
|
|
31
30
|
"devDependencies": {
|
|
32
31
|
"@types/node": "^22.15.3",
|
|
@@ -1,130 +0,0 @@
|
|
|
1
|
-
const require_errors = require('./errors.cjs');
|
|
2
|
-
let yauzl = require("yauzl");
|
|
3
|
-
|
|
4
|
-
//#region ../intelligence-delivery-core/dist/archive.mjs
|
|
5
|
-
/** Internal corruption bounds, including manifest and directory entries. */
|
|
6
|
-
const MAX_ARCHIVE_ENTRIES = 1e3;
|
|
7
|
-
const MAX_SNAPSHOT_BYTES = 32 * 1024 * 1024;
|
|
8
|
-
function safeRelativePath(path) {
|
|
9
|
-
return path.length > 0 && !/[\\\x00-\x1f\x7f]/.test(path) && !/^[a-z]:/i.test(path) && path.split("/").every((part) => part !== "" && part !== "." && part !== "..");
|
|
10
|
-
}
|
|
11
|
-
/** Decode only the listed ZIP namespace. No filesystem is involved. */
|
|
12
|
-
function readArchive(bytes, signal) {
|
|
13
|
-
return new Promise((resolve, reject) => {
|
|
14
|
-
let archive;
|
|
15
|
-
let stream;
|
|
16
|
-
let settled = false;
|
|
17
|
-
const finish = (error) => {
|
|
18
|
-
if (settled) return;
|
|
19
|
-
settled = true;
|
|
20
|
-
signal?.removeEventListener("abort", abort);
|
|
21
|
-
stream?.destroy();
|
|
22
|
-
archive?.close();
|
|
23
|
-
if (error !== void 0) reject(error);
|
|
24
|
-
else resolve(files);
|
|
25
|
-
};
|
|
26
|
-
const abort = () => finish(signal?.reason ?? require_errors.invalidSnapshot());
|
|
27
|
-
const files = /* @__PURE__ */ new Map();
|
|
28
|
-
const names = /* @__PURE__ */ new Set();
|
|
29
|
-
let decodedBytes = 0;
|
|
30
|
-
signal?.addEventListener("abort", abort, { once: true });
|
|
31
|
-
if (signal?.aborted) {
|
|
32
|
-
abort();
|
|
33
|
-
return;
|
|
34
|
-
}
|
|
35
|
-
(0, yauzl.fromBuffer)(bytes, {
|
|
36
|
-
lazyEntries: true,
|
|
37
|
-
decodeStrings: false,
|
|
38
|
-
validateEntrySizes: true,
|
|
39
|
-
autoClose: false
|
|
40
|
-
}, (error, zip) => {
|
|
41
|
-
if (error) {
|
|
42
|
-
finish(require_errors.invalidSnapshot(error));
|
|
43
|
-
return;
|
|
44
|
-
}
|
|
45
|
-
archive = zip;
|
|
46
|
-
if (settled) {
|
|
47
|
-
zip.close();
|
|
48
|
-
return;
|
|
49
|
-
}
|
|
50
|
-
zip.on("error", (cause) => finish(require_errors.invalidSnapshot(cause)));
|
|
51
|
-
zip.on("end", () => finish());
|
|
52
|
-
if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {
|
|
53
|
-
finish(require_errors.invalidSnapshot());
|
|
54
|
-
return;
|
|
55
|
-
}
|
|
56
|
-
zip.on("entry", (entry) => {
|
|
57
|
-
try {
|
|
58
|
-
const rawName = entry.fileName;
|
|
59
|
-
if (!Buffer.isBuffer(rawName)) throw require_errors.invalidSnapshot();
|
|
60
|
-
const name = new TextDecoder("utf-8", {
|
|
61
|
-
fatal: true,
|
|
62
|
-
ignoreBOM: true
|
|
63
|
-
}).decode(rawName);
|
|
64
|
-
const directory = name.endsWith("/");
|
|
65
|
-
if (!safeRelativePath(directory ? name.slice(0, -1) : name) || names.has(name)) throw require_errors.invalidSnapshot();
|
|
66
|
-
names.add(name);
|
|
67
|
-
const fileType = entry.externalFileAttributes >>> 16 & 61440;
|
|
68
|
-
if (fileType !== 0 && fileType !== (directory ? 16384 : 32768)) throw require_errors.invalidSnapshot();
|
|
69
|
-
if (entry.isEncrypted() || ![0, 8].includes(entry.compressionMethod)) throw require_errors.invalidSnapshot();
|
|
70
|
-
if (!Number.isSafeInteger(entry.uncompressedSize) || entry.uncompressedSize < 0) throw require_errors.invalidSnapshot();
|
|
71
|
-
decodedBytes += entry.uncompressedSize;
|
|
72
|
-
if (decodedBytes > MAX_SNAPSHOT_BYTES || directory && entry.uncompressedSize !== 0) throw require_errors.invalidSnapshot();
|
|
73
|
-
const local = entry.relativeOffsetOfLocalHeader;
|
|
74
|
-
if (local < 0 || local + 30 > bytes.length || bytes.readUInt32LE(local) !== 67324752) throw require_errors.invalidSnapshot();
|
|
75
|
-
if (bytes.readUInt16LE(local + 6) !== entry.generalPurposeBitFlag || bytes.readUInt16LE(local + 8) !== entry.compressionMethod) throw require_errors.invalidSnapshot();
|
|
76
|
-
const localNameLength = bytes.readUInt16LE(local + 26);
|
|
77
|
-
const localExtraLength = bytes.readUInt16LE(local + 28);
|
|
78
|
-
if (local + 30 + localNameLength + localExtraLength + entry.compressedSize > bytes.length || !bytes.subarray(local + 30, local + 30 + localNameLength).equals(rawName)) throw require_errors.invalidSnapshot();
|
|
79
|
-
if (!(entry.generalPurposeBitFlag & 8) && (bytes.readUInt32LE(local + 18) !== entry.compressedSize || bytes.readUInt32LE(local + 22) !== entry.uncompressedSize)) throw require_errors.invalidSnapshot();
|
|
80
|
-
if (directory) {
|
|
81
|
-
zip.readEntry();
|
|
82
|
-
return;
|
|
83
|
-
}
|
|
84
|
-
zip.openReadStream(entry, (readError, readStream) => {
|
|
85
|
-
if (readError) {
|
|
86
|
-
finish(require_errors.invalidSnapshot(readError));
|
|
87
|
-
return;
|
|
88
|
-
}
|
|
89
|
-
stream = readStream;
|
|
90
|
-
if (settled) {
|
|
91
|
-
readStream.destroy();
|
|
92
|
-
return;
|
|
93
|
-
}
|
|
94
|
-
const chunks = [];
|
|
95
|
-
let size = 0;
|
|
96
|
-
readStream.on("error", (cause) => finish(require_errors.invalidSnapshot(cause)));
|
|
97
|
-
readStream.on("data", (chunk) => {
|
|
98
|
-
size += chunk.length;
|
|
99
|
-
if (size > entry.uncompressedSize || size > MAX_SNAPSHOT_BYTES) {
|
|
100
|
-
finish(require_errors.invalidSnapshot());
|
|
101
|
-
return;
|
|
102
|
-
}
|
|
103
|
-
chunks.push(chunk);
|
|
104
|
-
});
|
|
105
|
-
readStream.on("end", () => {
|
|
106
|
-
if (settled) return;
|
|
107
|
-
if (size !== entry.uncompressedSize) {
|
|
108
|
-
finish(require_errors.invalidSnapshot());
|
|
109
|
-
return;
|
|
110
|
-
}
|
|
111
|
-
files.set(name, Buffer.concat(chunks, size));
|
|
112
|
-
stream = void 0;
|
|
113
|
-
zip.readEntry();
|
|
114
|
-
});
|
|
115
|
-
});
|
|
116
|
-
} catch (cause) {
|
|
117
|
-
finish(require_errors.invalidSnapshot(cause));
|
|
118
|
-
}
|
|
119
|
-
});
|
|
120
|
-
zip.readEntry();
|
|
121
|
-
});
|
|
122
|
-
});
|
|
123
|
-
}
|
|
124
|
-
|
|
125
|
-
//#endregion
|
|
126
|
-
exports.MAX_ARCHIVE_ENTRIES = MAX_ARCHIVE_ENTRIES;
|
|
127
|
-
exports.MAX_SNAPSHOT_BYTES = MAX_SNAPSHOT_BYTES;
|
|
128
|
-
exports.readArchive = readArchive;
|
|
129
|
-
exports.safeRelativePath = safeRelativePath;
|
|
130
|
-
//# sourceMappingURL=archive.cjs.map
|