@toolgrain/mcp 0.0.0-stage → 0.1.0-rc.0

package/dist/context/access.js

@@ -0,0 +1,22 @@
+const key = Symbol.for("@toolgrain/mcp/context-access/v1");
+/** Keep own auth properties and shared request data on dependency-aware views. */
+export function withContextAccess(ctx, access) {
+    return Object.freeze(Object.create(Object.getPrototypeOf(ctx), {
+        ...Object.getOwnPropertyDescriptors(ctx),
+        [key]: { value: access },
+    }));
+}
+export function readContext(ctx, identity, name) {
+    try {
+        const access = Object.getOwnPropertyDescriptor(ctx, key)?.value;
+        if (!access)
+            throw new Error("Context access requires a Toolgrain-created context");
+        ctx.signal.throwIfAborted();
+        return access(identity, name);
+    }
+    catch (error) {
+        // Accessors always return promises, including invalid contexts and aborts.
+        return Promise.reject(error);
+    }
+}
+//# sourceMappingURL=access.js.map

package/dist/context/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../../src/context/access.ts"],"names":[],"mappings":"AAEA,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;AAG3D,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAC/B,GAAgB,EAChB,MAAc;IAEd,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE;QACxC,GAAG,MAAM,CAAC,yBAAyB,CAAC,GAAG,CAAC;QACxC,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;KACzB,CAAgB,CAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAgB,EAChB,QAAgB,EAChB,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,KAE7C,CAAC;QACd,IAAI,CAAC,MAAM;YACT,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAmB,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2EAA2E;QAC3E,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/context/definition.d.ts

@@ -0,0 +1,24 @@
+import type { ToolContext } from "../tools/context.js";
+export interface ContextBinding {
+    readonly identity: symbol;
+    readonly name: string;
+    readonly resolve: (ctx: ToolContext) => unknown;
+}
+/** Erase values for heterogeneous registrations without exposing unsafe overrides. */
+export declare abstract class RegisteredContextProvider {
+    abstract readonly name: string;
+    abstract readonly use: (ctx: ToolContext) => Promise<unknown>;
+    "~toolgrain"(): "context@1";
+}
+/** An opaque, invariant value contract; use createContext() and provide() for bindings. */
+export declare abstract class ContextProvider<Value> extends RegisteredContextProvider {
+    abstract readonly use: (ctx: ToolContext) => Promise<Value>;
+    abstract readonly provide: (resolve: (ctx: ToolContext) => Value | PromiseLike<Value>) => ContextProvider<Value>;
+}
+/** Infer the resolved value type, including asynchronous factories. */
+export declare function createContext<Value>(options: {
+    name: string;
+    resolve: (ctx: ToolContext) => Value;
+}): ContextProvider<Awaited<Value>>;
+export declare function contextBinding(provider: unknown): ContextBinding;
+//# sourceMappingURL=definition.d.ts.map

package/dist/context/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/context/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;CACjD;AAED,sFAAsF;AACtF,8BAAsB,yBAAyB;IAC7C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAG9D,YAAY,IAAI,WAAW,CAE1B;CACF;AAKD,2FAA2F;AAC3F,8BAAsB,eAAe,CAAC,KAAK,CAAE,SAAQ,yBAAyB;IAC5E,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAE5D,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CACzB,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KACtD,eAAe,CAAC,KAAK,CAAC,CAAC;CAC7B;AA6BD,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,KAAK,CAAC;CACtC,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAelC;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CAgBhE"}

package/dist/context/definition.js

@@ -0,0 +1,57 @@
+import { readContext } from "./access.js";
+const brand = Symbol.for("@toolgrain/mcp/context-provider/v1");
+const bindingKey = Symbol.for("@toolgrain/mcp/context-binding/v1");
+/** Erase values for heterogeneous registrations without exposing unsafe overrides. */
+export class RegisteredContextProvider {
+    // Structural branding keeps compatible package copies interoperable.
+    "~toolgrain"() {
+        return "context@1";
+    }
+}
+Object.defineProperty(RegisteredContextProvider.prototype, brand, {
+    value: true,
+});
+/** An opaque, invariant value contract; use createContext() and provide() for bindings. */
+export class ContextProvider extends RegisteredContextProvider {
+}
+class Provider extends ContextProvider {
+    name;
+    use;
+    constructor(binding, use = (ctx) => readContext(ctx, binding.identity, binding.name)) {
+        super();
+        this.name = binding.name;
+        this.use = use;
+        Object.defineProperty(this, bindingKey, { value: Object.freeze(binding) });
+        Object.freeze(this);
+    }
+    provide = (resolve) => {
+        if (typeof resolve !== "function")
+            throw new TypeError("Context provider overrides require a resolver function");
+        return new Provider({ ...contextBinding(this), resolve }, this.use);
+    };
+}
+/** Infer the resolved value type, including asynchronous factories. */
+export function createContext(options) {
+    if (!options ||
+        typeof options.name !== "string" ||
+        !options.name.trim() ||
+        typeof options.resolve !== "function")
+        throw new TypeError("Context providers require a nonempty name and a resolver function");
+    return new Provider({
+        identity: Symbol(options.name),
+        name: options.name,
+        resolve: options.resolve,
+    });
+}
+export function contextBinding(provider) {
+    if (typeof provider !== "object" ||
+        provider === null ||
+        provider[brand] !== true)
+        throw new TypeError("Context providers must be created with createContext()");
+    const binding = Object.getOwnPropertyDescriptor(provider, bindingKey)
+        ?.value;
+    if (!binding)
+        throw new TypeError("Context providers must be created with createContext()");
+    return binding;
+}
+//# sourceMappingURL=definition.js.map

package/dist/context/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/context/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAQnE,sFAAsF;AACtF,MAAM,OAAgB,yBAAyB;IAI7C,qEAAqE;IACrE,YAAY;QACV,OAAO,WAAW,CAAC;IACrB,CAAC;CACF;AACD,MAAM,CAAC,cAAc,CAAC,yBAAyB,CAAC,SAAS,EAAE,KAAK,EAAE;IAChE,KAAK,EAAE,IAAI;CACZ,CAAC,CAAC;AAEH,2FAA2F;AAC3F,MAAM,OAAgB,eAAuB,SAAQ,yBAAyB;CAM7E;AAED,MAAM,QAAgB,SAAQ,eAAsB;IACzC,IAAI,CAAS;IACb,GAAG,CAAuC;IAEnD,YACE,OAAuB,EACvB,GAAG,GAAG,CAAC,GAAgB,EAAE,EAAE,CACzB,WAAW,CAAQ,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC;QAEzD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAEQ,OAAO,GAAG,CACjB,OAAyD,EACjC,EAAE;QAC1B,IAAI,OAAO,OAAO,KAAK,UAAU;YAC/B,MAAM,IAAI,SAAS,CACjB,wDAAwD,CACzD,CAAC;QACJ,OAAO,IAAI,QAAQ,CAAQ,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,CAAC,CAAC;CACH;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAQ,OAGpC;IACC,IACE,CAAC,OAAO;QACR,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAChC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU;QAErC,MAAM,IAAI,SAAS,CACjB,mEAAmE,CACpE,CAAC;IACJ,OAAO,IAAI,QAAQ,CAAiB;QAClC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,IACE,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,IAAI;QAChB,QAAkC,CAAC,KAAK,CAAC,KAAK,IAAI;QAEnD,MAAM,IAAI,SAAS,CACjB,wDAAwD,CACzD,CAAC;IACJ,MAAM,OAAO,GAAG,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,UAAU,CAAC;QACnE,EAAE,KAAmC,CAAC;IACxC,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,SAAS,CACjB,wDAAwD,CACzD,CAAC;IACJ,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/context/registry.d.ts

@@ -0,0 +1,5 @@
+import { type ContextBinding, type RegisteredContextProvider } from "./definition.js";
+export type ContextRegistry = ReadonlyMap<symbol, ContextBinding>;
+/** Snapshot definitions once; provider names are labels, not registration keys. */
+export declare function createContextRegistry(providers?: readonly RegisteredContextProvider[]): ContextRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/context/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,yBAAyB,EAC/B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAElE,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,SAAS,yBAAyB,EAAO,GACnD,eAAe,CAajB"}

package/dist/context/registry.js

@@ -0,0 +1,15 @@
+import { contextBinding, } from "./definition.js";
+/** Snapshot definitions once; provider names are labels, not registration keys. */
+export function createContextRegistry(providers = []) {
+    if (!Array.isArray(providers))
+        throw new TypeError("Context registration must be an array of providers");
+    const registry = new Map();
+    for (const provider of providers) {
+        const binding = contextBinding(provider);
+        if (registry.has(binding.identity))
+            throw new TypeError(`Context provider ${JSON.stringify(binding.name)} is registered more than once`);
+        registry.set(binding.identity, binding);
+    }
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/context/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/context/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,GAEf,MAAM,iBAAiB,CAAC;AAIzB,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CACnC,SAAS,GAAyC,EAAE;IAEpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAC3B,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IACnD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC;YAChC,MAAM,IAAI,SAAS,CACjB,oBAAoB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAChF,CAAC;QACJ,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/context/scope.d.ts

@@ -0,0 +1,5 @@
+import type { ToolContext } from "../tools/context.js";
+import type { ContextRegistry } from "./registry.js";
+/** One cache and pending dependency graph per tool context, independent of request IDs. */
+export declare function createContextScope(ctx: ToolContext, registry: ContextRegistry): ToolContext;
+//# sourceMappingURL=scope.d.ts.map

package/dist/context/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/context/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AASrD,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,eAAe,GACxB,WAAW,CAmDb"}

package/dist/context/scope.js

@@ -0,0 +1,56 @@
+import { withContextAccess } from "./access.js";
+/** One cache and pending dependency graph per tool context, independent of request IDs. */
+export function createContextScope(ctx, registry) {
+    const resolutions = new Map();
+    const resolve = (identity, name, caller) => {
+        const binding = registry.get(identity);
+        if (!binding)
+            throw new Error(`Context provider ${JSON.stringify(name)} is not registered`);
+        let resolution = resolutions.get(identity);
+        if (!resolution) {
+            const current = {
+                name: binding.name,
+                pending: true,
+                dependencies: new Set(),
+                // Publish the promise before running user code, including synchronous factories.
+                promise: Promise.resolve()
+                    .then(() => {
+                    ctx.signal.throwIfAborted();
+                    return binding.resolve(withContextAccess(ctx, (key, label) => resolve(key, label, current)));
+                })
+                    .then((value) => {
+                    ctx.signal.throwIfAborted();
+                    return value;
+                })
+                    .finally(() => {
+                    current.pending = false;
+                    current.dependencies.clear();
+                }),
+            };
+            resolutions.set(identity, current);
+            resolution = current;
+        }
+        if (caller?.pending && resolution.pending) {
+            const path = dependencyPath(resolution, caller, new Set());
+            if (path)
+                throw new Error(`Context dependency cycle: ${[caller, ...path].map((item) => item.name).join(" -> ")}`);
+            caller.dependencies.add(resolution);
+        }
+        return resolution.promise;
+    };
+    return withContextAccess(ctx, (identity, name) => resolve(identity, name));
+}
+/** Follow only unfinished resolutions; shared pending dependencies are not cycles. */
+function dependencyPath(from, target, visited) {
+    if (from === target)
+        return [from];
+    if (!from.pending || visited.has(from))
+        return;
+    visited.add(from);
+    for (const dependency of from.dependencies) {
+        const path = dependencyPath(dependency, target, visited);
+        if (path)
+            return [from, ...path];
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/context/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/context/scope.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUhD,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAChC,GAAgB,EAChB,QAAyB;IAEzB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAClD,MAAM,OAAO,GAAG,CACd,QAAgB,EAChB,IAAY,EACZ,MAAmB,EACD,EAAE;QACpB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YACV,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAC7D,CAAC;QACJ,IAAI,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,OAAO,GAAe;gBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,IAAI,GAAG,EAAE;gBACvB,iFAAiF;gBACjF,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;qBACvB,IAAI,CAAC,GAAG,EAAE;oBACT,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;oBAC5B,OAAO,OAAO,CAAC,OAAO,CACpB,iBAAiB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CACpC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAC7B,CACF,CAAC;gBACJ,CAAC,CAAC;qBACD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;oBACd,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;oBAC5B,OAAO,KAAK,CAAC;gBACf,CAAC,CAAC;qBACD,OAAO,CAAC,GAAG,EAAE;oBACZ,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;oBACxB,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;gBAC/B,CAAC,CAAC;aACL,CAAC;YACF,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnC,UAAU,GAAG,OAAO,CAAC;QACvB,CAAC;QACD,IAAI,MAAM,EAAE,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAC3D,IAAI,IAAI;gBACN,MAAM,IAAI,KAAK,CACb,6BAA6B,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CACvF,CAAC;YACJ,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,UAAU,CAAC,OAAO,CAAC;IAC5B,CAAC,CAAC;IACF,OAAO,iBAAiB,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,sFAAsF;AACtF,SAAS,cAAc,CACrB,IAAgB,EAChB,MAAkB,EAClB,OAAwB;IAExB,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,IAAI;YAAE,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,10 @@
+import type { ToolRequest } from "./tools/context.js";
+/** Private diagnostics for an unexpected tool failure; no arguments or auth data are added. */
+export interface ToolErrorDetails {
+    readonly toolName: string;
+    readonly request: ToolRequest;
+}
+export type ErrorHandler = (error: unknown, details?: ToolErrorDetails) => void;
+/** Diagnostics cannot interrupt a response or cleanup, including rejected async callbacks. */
+export declare function reportError(onError: ErrorHandler | undefined, error: unknown, details?: ToolErrorDetails): void;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEhF,8FAA8F;AAC9F,wBAAgB,WAAW,CACzB,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CASN"}

package/dist/diagnostics.js

@@ -0,0 +1,13 @@
+/** Diagnostics cannot interrupt a response or cleanup, including rejected async callbacks. */
+export function reportError(onError, error, details) {
+    if (!onError)
+        return;
+    try {
+        const result = details === undefined ? onError(error) : onError(error, details);
+        void Promise.resolve(result).catch(() => { });
+    }
+    catch {
+        /* Diagnostics must not replace the original failure. */
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAUA,8FAA8F;AAC9F,MAAM,UAAU,WAAW,CACzB,OAAiC,EACjC,KAAc,EACd,OAA0B;IAE1B,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GACV,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnE,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;AACH,CAAC"}

package/dist/dispatcher.d.ts

@@ -0,0 +1,19 @@
+import { type Implementation, type JSONRPCErrorResponse, type ProtocolResponse, type SupportedProtocolVersion } from "@toolgrain/protocol";
+import type { AuthIdentity } from "./auth/types.js";
+import type { ContextRegistry } from "./context/registry.js";
+import type { Request } from "./protocol/messages.js";
+import type { ToolAdapter } from "./tools/adapter.js";
+import type { ToolClient } from "./tools/context.js";
+/** Per-request execution state supplied by the connection or independent caller. */
+export interface RequestScope {
+    signal: AbortSignal;
+    /** Client details negotiated by legacy initialization, when the connection has them. */
+    client?: ToolClient | undefined;
+    auth?: AuthIdentity;
+}
+export type Dispatcher = (request: Request, scope: RequestScope, protocolVersion?: SupportedProtocolVersion) => Promise<ProtocolResponse | undefined>;
+/** Compose the two protocol adapters around one execution registry. */
+export declare function createDispatcher(tools: ToolAdapter, identity: Implementation, instructions?: string, providers?: ContextRegistry): Dispatcher;
+/** Envelope errors have no negotiated connection when processing independent calls. */
+export declare function formatErrorResponse(response: JSONRPCErrorResponse, protocolVersion?: SupportedProtocolVersion): ProtocolResponse;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAEzB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,wFAAwF;IACxF,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,YAAY,EACnB,eAAe,CAAC,EAAE,wBAAwB,KACvC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAE3C,uEAAuE;AACvE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,eAAe,GAC1B,UAAU,CAmBZ;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,oBAAoB,EAC9B,eAAe,CAAC,EAAE,wBAAwB,GACzC,gBAAgB,CAIlB"}

package/dist/dispatcher.js

@@ -0,0 +1,23 @@
+import { LEGACY_PROTOCOL_VERSION, } from "@toolgrain/protocol";
+import { createLegacyDispatcher, usesLegacyProtocol, } from "./legacy/dispatcher.js";
+import { errorResponse as legacyErrorResponse } from "./legacy/responses.js";
+import { createModernDispatcher } from "./modern/dispatcher.js";
+import { validateVersionContext } from "./protocol/version-metadata.js";
+/** Compose the two protocol adapters around one execution registry. */
+export function createDispatcher(tools, identity, instructions, providers) {
+    const legacy = createLegacyDispatcher(tools, identity, instructions, providers);
+    const modern = createModernDispatcher(tools, identity, instructions, providers);
+    return (request, scope, protocolVersion) => {
+        validateVersionContext(request, protocolVersion);
+        return usesLegacyProtocol(request, protocolVersion)
+            ? legacy(request, scope)
+            : modern(request, scope);
+    };
+}
+/** Envelope errors have no negotiated connection when processing independent calls. */
+export function formatErrorResponse(response, protocolVersion) {
+    return protocolVersion === LEGACY_PROTOCOL_VERSION
+        ? legacyErrorResponse(response)
+        : response;
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,uBAAuB,GAGxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAkBxE,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAC9B,KAAkB,EAClB,QAAwB,EACxB,YAAqB,EACrB,SAA2B;IAE3B,MAAM,MAAM,GAAG,sBAAsB,CACnC,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,SAAS,CACV,CAAC;IACF,MAAM,MAAM,GAAG,sBAAsB,CACnC,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,SAAS,CACV,CAAC;IACF,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE;QACzC,sBAAsB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACjD,OAAO,kBAAkB,CAAC,OAAO,EAAE,eAAe,CAAC;YACjD,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;YACxB,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CACjC,QAA8B,EAC9B,eAA0C;IAE1C,OAAO,eAAe,KAAK,uBAAuB;QAChD,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC;QAC/B,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC"}

package/dist/execute-request.d.ts

@@ -0,0 +1,7 @@
+import { type ProtocolResponse, type SupportedProtocolVersion } from "@toolgrain/protocol";
+import { type ErrorHandler } from "./diagnostics.js";
+import type { Dispatcher, RequestScope } from "./dispatcher.js";
+import type { Request } from "./protocol/messages.js";
+/** Shared dispatch boundary for connection-scoped and independent requests. */
+export declare function executeRequest(dispatch: Dispatcher, request: Request, scope: RequestScope, onError?: ErrorHandler, protocolVersion?: SupportedProtocolVersion): Promise<ProtocolResponse | undefined>;
+//# sourceMappingURL=execute-request.d.ts.map

package/dist/execute-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-request.d.ts","sourceRoot":"","sources":["../src/execute-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,+EAA+E;AAC/E,wBAAsB,cAAc,CAClC,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,YAAY,EACtB,eAAe,CAAC,EAAE,wBAAwB,GACzC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAiBvC"}

package/dist/execute-request.js

@@ -0,0 +1,20 @@
+import { INTERNAL_ERROR, } from "@toolgrain/protocol";
+import { reportError } from "./diagnostics.js";
+import { ProtocolError, protocolError } from "./protocol/responses.js";
+/** Shared dispatch boundary for connection-scoped and independent requests. */
+export async function executeRequest(dispatch, request, scope, onError, protocolVersion) {
+    const isActive = () => !scope.signal.aborted;
+    try {
+        const response = await dispatch(request, scope, protocolVersion);
+        return isActive() ? response : undefined;
+    }
+    catch (error) {
+        if (!isActive())
+            return;
+        if (error instanceof ProtocolError)
+            return protocolError(error.code, error.message, request.id, error.data);
+        reportError(onError, error);
+        return protocolError(INTERNAL_ERROR, "Internal error", request.id, undefined);
+    }
+}
+//# sourceMappingURL=execute-request.js.map

package/dist/execute-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-request.js","sourceRoot":"","sources":["../src/execute-request.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAqB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEvE,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAoB,EACpB,OAAgB,EAChB,KAAmB,EACnB,OAAsB,EACtB,eAA0C;IAE1C,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QACjE,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QACxB,IAAI,KAAK,YAAY,aAAa;YAChC,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1E,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,aAAa,CAClB,cAAc,EACd,gBAAgB,EAChB,OAAO,CAAC,EAAE,EACV,SAAS,CACV,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { validateTokenAudience } from "./auth/audience.js";
+export { createAuthAccessor } from "./auth/context.js";
+export type { AuthErrorCode } from "./auth/errors.js";
+export { AuthError, isAuthError } from "./auth/errors.js";
+export type { AuthMetadata, AuthProvider, AuthReadonly, AuthScope, AuthVerifyOptions, } from "./auth/types.js";
+export { authUrl as validateAuthUrl } from "./auth/url.js";
+export type { ContextProvider } from "./context/definition.js";
+export { createContext } from "./context/definition.js";
+export type { ToolErrorDetails } from "./diagnostics.js";
+export type { HandleOptions, Server, ServerOptions } from "./server.js";
+export { createServer } from "./server.js";
+export type { ToolClient, ToolContext, ToolContextOptions, ToolRequest, } from "./tools/context.js";
+export { toolContext } from "./tools/context.js";
+export type { Tool, ToolDefinition, ToolMetadata } from "./tools/definition.js";
+export { tool } from "./tools/definition.js";
+export { ToolNameError } from "./tools/name.js";
+export type { ToolMap } from "./tools/registry.js";
+export type { McpErrorResult, McpResult, McpResultOptions, McpStructuredResult, } from "./tools/rich-result.js";
+export { mcpResult } from "./tools/rich-result.js";
+export { ToolSchemaError } from "./tools/schema.js";
+export type { RequestTransport, Transport, TransportCallbacks, } from "./transport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { validateTokenAudience } from "./auth/audience.js";
+export { createAuthAccessor } from "./auth/context.js";
+export { AuthError, isAuthError } from "./auth/errors.js";
+export { authUrl as validateAuthUrl } from "./auth/url.js";
+export { createContext } from "./context/definition.js";
+export { createServer } from "./server.js";
+export { toolContext } from "./tools/context.js";
+export { tool } from "./tools/definition.js";
+export { ToolNameError } from "./tools/name.js";
+export { mcpResult } from "./tools/rich-result.js";
+export { ToolSchemaError } from "./tools/schema.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQ1D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQhD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/legacy/connection.d.ts

@@ -0,0 +1,26 @@
+import { type JSONRPCErrorResponse, type ProtocolResponse, type RequestId, type SupportedProtocolVersion } from "@toolgrain/protocol";
+import type { Notification, Request } from "../protocol/messages.js";
+import { type ToolClient } from "../tools/context.js";
+/** Owns the initialization lifecycle for one attached transport. */
+export declare function createLegacyConnection(): {
+    prepare(request: Request): {
+        error?: never;
+        readonly protocolVersion?: never;
+    } | {
+        error: JSONRPCErrorResponse;
+        readonly protocolVersion?: never;
+    } | {
+        error?: never;
+        readonly protocolVersion: "2025-06-18";
+    };
+    begin(request: Request, protocolVersion?: SupportedProtocolVersion): {
+        respond(response: ProtocolResponse | undefined): void;
+        finish(): void;
+    } | undefined;
+    notification(notification: Notification): void;
+    /** Details from a completed legacy initialization on this connection. */
+    client(): ToolClient | undefined;
+    canCancel(id: RequestId): boolean;
+    errorResponse(response: JSONRPCErrorResponse): JSONRPCErrorResponse | import("@toolgrain/protocol").LegacyJSONRPCErrorResponse;
+};
+//# sourceMappingURL=connection.d.ts.map

package/dist/legacy/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/legacy/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAMrE,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,qBAAqB,CAAC;AAIlE,oEAAoE;AACpE,wBAAgB,sBAAsB;IAKlC,OAAO,UAAU,OAAO;;;;;;;;;;IA0BxB,KAAK,UAAU,OAAO,oBAAoB,wBAAwB;0BAS5C,gBAAgB,GAAG,SAAS;;;IAkBlD,YAAY,eAAe,YAAY;IAQvC,yEAAyE;IACzE,MAAM;IAGN,SAAS,KAAK,SAAS;IAGvB,aAAa,WAAW,oBAAoB;EAI/C"}

package/dist/legacy/connection.js

@@ -0,0 +1,73 @@
+import { INVALID_REQUEST, LEGACY_PROTOCOL_VERSION, } from "@toolgrain/protocol";
+import { protocolError } from "../protocol/responses.js";
+import { hasProtocolVersionMetadata, metadataMatchesVersion, } from "../protocol/version-metadata.js";
+import { toolClient } from "../tools/context.js";
+import { commonParams, initializeParams } from "./messages.js";
+import { errorResponse } from "./responses.js";
+/** Owns the initialization lifecycle for one attached transport. */
+export function createLegacyConnection() {
+    let state;
+    let initializeId;
+    let client;
+    return {
+        prepare(request) {
+            const legacy = (state !== undefined &&
+                metadataMatchesVersion(request, LEGACY_PROTOCOL_VERSION)) ||
+                (!hasProtocolVersionMetadata(request) &&
+                    (state !== undefined ||
+                        request.method === "initialize" ||
+                        request.method === "ping"));
+            if (!legacy)
+                return {};
+            const initialize = request.method === "initialize";
+            if (initialize
+                ? state !== undefined
+                : state !== "ready" && request.method !== "ping")
+                return {
+                    error: protocolError(INVALID_REQUEST, initialize
+                        ? "Server is already initialized"
+                        : "Server is not initialized", request.id),
+                };
+            return { protocolVersion: LEGACY_PROTOCOL_VERSION };
+        },
+        begin(request, protocolVersion) {
+            if (protocolVersion !== LEGACY_PROTOCOL_VERSION ||
+                request.method !== "initialize")
+                return;
+            state = "initializing";
+            initializeId = request.id;
+            return {
+                respond(response) {
+                    state =
+                        response && "result" in response
+                            ? "awaiting-initialized"
+                            : undefined;
+                    // The response succeeded only if these parameters already validated.
+                    const params = initializeParams.safeParse(request.params);
+                    if (state && params.success)
+                        client = toolClient(params.data.clientInfo, params.data.capabilities);
+                },
+                finish() {
+                    initializeId = undefined;
+                },
+            };
+        },
+        notification(notification) {
+            if (notification.method === "notifications/initialized" &&
+                commonParams.safeParse(notification.params ?? {}).success &&
+                state === "awaiting-initialized")
+                state = "ready";
+        },
+        /** Details from a completed legacy initialization on this connection. */
+        client() {
+            return client;
+        },
+        canCancel(id) {
+            return id !== initializeId;
+        },
+        errorResponse(response) {
+            return state === undefined ? response : errorResponse(response);
+        },
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/legacy/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/legacy/connection.ts"],"names":[],"mappings":"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"}

package/dist/legacy/dispatcher.d.ts

@@ -0,0 +1,10 @@
+import { type Implementation, type SupportedProtocolVersion } from "@toolgrain/protocol";
+import type { JSONRPCResponse } from "@toolgrain/protocol/2025-06-18";
+import type { ContextRegistry } from "../context/registry.js";
+import type { RequestScope } from "../dispatcher.js";
+import type { Request } from "../protocol/messages.js";
+import type { ToolAdapter } from "../tools/adapter.js";
+/** Initialization selects this adapter only without an explicit modern context. */
+export declare function usesLegacyProtocol(request: Request, protocolVersion?: SupportedProtocolVersion): boolean;
+export declare function createLegacyDispatcher(tools: ToolAdapter, identity: Implementation, instructions?: string, providers?: ContextRegistry): (request: Request, scope: RequestScope) => Promise<JSONRPCResponse | undefined>;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/legacy/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/legacy/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAU,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,mFAAmF;AACnF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,eAAe,CAAC,EAAE,wBAAwB,GACzC,OAAO,CAOT;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,eAAe,aAGhB,OAAO,SACT,YAAY,KAClB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAgCxC"}

package/dist/legacy/dispatcher.js

@@ -0,0 +1,41 @@
+import { LEGACY_PROTOCOL_VERSION, METHOD_NOT_FOUND, } from "@toolgrain/protocol";
+import { ProtocolError } from "../protocol/responses.js";
+import { hasProtocolVersionMetadata } from "../protocol/version-metadata.js";
+import { createToolContext } from "../tools/context.js";
+import { callTool, initialize, listTools, ping } from "./handlers.js";
+import { successResponse } from "./responses.js";
+/** Initialization selects this adapter only without an explicit modern context. */
+export function usesLegacyProtocol(request, protocolVersion) {
+    return (protocolVersion === LEGACY_PROTOCOL_VERSION ||
+        (protocolVersion === undefined &&
+            !hasProtocolVersionMetadata(request) &&
+            request.method === "initialize"));
+}
+export function createLegacyDispatcher(tools, identity, instructions, providers) {
+    return async (request, scope) => {
+        let result;
+        switch (request.method) {
+            case "initialize":
+                result = initialize(request.params, identity, instructions);
+                break;
+            case "ping":
+                result = ping(request.params);
+                break;
+            case "tools/list":
+                result = listTools(request.params, tools);
+                break;
+            case "tools/call":
+                result = await callTool(request.params, tools, (params) => createToolContext(scope.signal, {
+                    id: request.id,
+                    protocolVersion: LEGACY_PROTOCOL_VERSION,
+                    ...(scope.client === undefined ? {} : { client: scope.client }),
+                    meta: params._meta ?? {},
+                }, scope.auth, providers));
+                break;
+            default:
+                throw new ProtocolError(METHOD_NOT_FOUND, "Method not found");
+        }
+        return result ? successResponse(request.id, result) : undefined;
+    };
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/legacy/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/legacy/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,uBAAuB,EACvB,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAChC,OAAgB,EAChB,eAA0C;IAE1C,OAAO,CACL,eAAe,KAAK,uBAAuB;QAC3C,CAAC,eAAe,KAAK,SAAS;YAC5B,CAAC,0BAA0B,CAAC,OAAO,CAAC;YACpC,OAAO,CAAC,MAAM,KAAK,YAAY,CAAC,CACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAkB,EAClB,QAAwB,EACxB,YAAqB,EACrB,SAA2B;IAE3B,OAAO,KAAK,EACV,OAAgB,EAChB,KAAmB,EACmB,EAAE;QACxC,IAAI,MAA0B,CAAC;QAC/B,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,KAAK,YAAY;gBACf,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAC5D,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,YAAY;gBACf,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,YAAY;gBACf,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CACxD,iBAAiB,CACf,KAAK,CAAC,MAAM,EACZ;oBACE,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,eAAe,EAAE,uBAAuB;oBACxC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;oBAC/D,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;iBACzB,EACD,KAAK,CAAC,IAAI,EACV,SAAS,CACV,CACF,CAAC;gBACF,MAAM;YACR;gBACE,MAAM,IAAI,aAAa,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,CAAC,CAAC;AACJ,CAAC"}

package/dist/legacy/handlers.d.ts

@@ -0,0 +1,12 @@
+import { type Implementation } from "@toolgrain/protocol";
+import type { InitializeResult, ListToolsResult } from "@toolgrain/protocol/2025-06-18";
+import type { ToolAdapter } from "../tools/adapter.js";
+import type { ToolContext } from "../tools/context.js";
+/** Initialization can only negotiate the initialization-based revision. */
+export declare function initialize(params: unknown, identity: Implementation, instructions?: string): InitializeResult;
+export declare function ping(params: unknown): Record<string, never>;
+export declare function listTools(params: unknown, tools: ToolAdapter): ListToolsResult;
+export declare function callTool(params: unknown, tools: ToolAdapter, ctx: (params: {
+    _meta?: Record<string, unknown> | undefined;
+}) => ToolContext): Promise<import("@toolgrain/protocol/2025-06-18").CallToolResult | undefined>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/legacy/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/legacy/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASvD,2EAA2E;AAC3E,wBAAgB,UAAU,CACxB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAYlB;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAI3D;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,WAAW,GACjB,eAAe,CAcjB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAAE,KAAK,WAAW,gFAO9E"}