@procedures/client 0.0.0-stage → 0.2.0

package/dist/procedures/define-procedure.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Procedure Definition Procedure
+ *
+ * Meta-procedure that creates procedures at runtime from JSON aggregations.
+ * Enables fully declarative procedure definition without native TypeScript code.
+ *
+ * @example
+ * ```typescript
+ * // Define a procedure that chains multiple steps
+ * await client.call(["procedure", "define"], {
+ *   path: ["my", "workflow"],
+ *   aggregation: {
+ *     $proc: ["client", "chain"],
+ *     input: {
+ *       steps: [
+ *         { $proc: ["fs", "mkdir"], input: { path: { $ref: "input.dir" } } },
+ *         { $proc: ["git", "init"], input: { cwd: { $ref: "input.dir" } } },
+ *       ],
+ *     },
+ *   },
+ * });
+ *
+ * // Now use the defined procedure
+ * await client.call(["my", "workflow"], { dir: "/path/to/project" });
+ * ```
+ */
+import type { Procedure, ProcedurePath, ProcedureMetadata, AnyProcedure, ProcedureRegistryLike } from "./types.js";
+/**
+ * JSON-serializable aggregation definition.
+ * Represents a procedure call tree that will be executed when the procedure runs.
+ */
+export interface AggregationDefinition {
+    /** Procedure to call */
+    $proc: ProcedurePath;
+    /** Input for the procedure (may contain $ref and nested $proc) */
+    input: unknown;
+    /** Optional name for output referencing */
+    $name?: string;
+}
+/**
+ * Input for defining a new procedure.
+ */
+export interface DefineProcedureInput {
+    /** Path for the new procedure */
+    path: ProcedurePath;
+    /**
+     * Aggregation definition - the procedure body as a JSON tree.
+     * This gets executed when the procedure is called.
+     */
+    aggregation: AggregationDefinition;
+    /**
+     * Optional metadata for the procedure.
+     */
+    metadata?: ProcedureMetadata;
+    /**
+     * Whether to replace an existing procedure with this path.
+     * Default: false (throws if procedure exists)
+     */
+    replace?: boolean;
+}
+/**
+ * Output from defining a procedure.
+ */
+export interface DefineProcedureOutput {
+    /** The path of the defined procedure */
+    path: ProcedurePath;
+    /** Whether an existing procedure was replaced */
+    replaced: boolean;
+}
+/** True for a procedure that `procedure.define` made. */
+export declare function isRuntimeDefined(procedure: {
+    handler?: unknown;
+}): boolean;
+/**
+ * The program (the aggregation) of a procedure that `procedure.define` made, or undefined for a
+ * code procedure. A program store saves it and defines it again after a restart (roadmap 3.2).
+ */
+export declare function runtimeProgramOf(procedure: {
+    handler?: unknown;
+}): AggregationDefinition | undefined;
+type RegistryOf = Pick<ProcedureRegistryLike, "get" | "getAll" | "unregister">;
+/**
+ * Get a runtime-defined procedure by path.
+ */
+export declare function getRuntimeProcedure(path: ProcedurePath, registry?: RegistryOf): AnyProcedure | undefined;
+/**
+ * Check if a runtime procedure exists.
+ */
+export declare function hasRuntimeProcedure(path: ProcedurePath, registry?: RegistryOf): boolean;
+/**
+ * Get all runtime-defined procedures.
+ */
+export declare function getAllRuntimeProcedures(registry?: RegistryOf): AnyProcedure[];
+/**
+ * Clear all runtime-defined procedures.
+ * Useful for testing.
+ */
+export declare function clearRuntimeProcedures(registry?: RegistryOf): void;
+/**
+ * Metadata for the procedure.define procedure.
+ */
+interface DefineMetadata extends ProcedureMetadata {
+    description: string;
+    tags: string[];
+    /** This is a meta-procedure that creates other procedures */
+    metaProcedure: true;
+}
+/**
+ * The procedure.define procedure.
+ *
+ * This is a meta-procedure that creates other procedures at runtime
+ * from JSON aggregation definitions.
+ *
+ * The rules (deep dive CORE-3, MCP-4):
+ * - The procedure goes into the caller's registry (`ctx.registry`).
+ * - `replace: true` replaces only a procedure that `procedure.define` made. A code procedure
+ *   stays: an MCP client cannot replace a tool or an internal procedure.
+ * - The registry gets the procedure first. A define that fails leaves nothing.
+ * - The new procedure is data-driven: with a server's `expose` rule, it calls only exposed paths.
+ * - Its input is raw (the `runs-refs` tag): `exec()` does not run the body at definition time.
+ */
+export declare const defineProcedureProcedure: Procedure<DefineProcedureInput, DefineProcedureOutput, DefineMetadata>;
+/** The description of one procedure, for `procedure.list` and `procedure.get`. */
+export interface ProcedureDescription {
+    /** The path of the procedure */
+    path: ProcedurePath;
+    /** The path as a dotted key */
+    key: string;
+    /** The description of the metadata */
+    description: string | undefined;
+    /** The tags of the metadata */
+    tags: string[] | undefined;
+    /** True when the procedure has a handler (it can run) */
+    hasHandler: boolean;
+    /** True for a procedure that `procedure.define` made */
+    runtime: boolean;
+    /** The whole metadata (`procedure.list` gives it with `includeMetadata`) */
+    metadata?: ProcedureMetadata | undefined;
+}
+/** The input of `procedure.list` */
+export interface ProcedureListInput {
+    namespace?: string | undefined;
+    includeMetadata?: boolean | undefined;
+    runtime?: boolean | undefined;
+}
+/** The input of `procedure.get` */
+export interface ProcedureGetInput {
+    path: string[] | string;
+}
+/**
+ * Describe one procedure of the caller's registry.
+ *
+ * Docs review DOC-6: the core version gave only runtime-defined procedures, and client-procedure
+ * replaced it with a version for the whole registry, so the result depended on the imports of
+ * the host. This is the one implementation: any procedure, with `runtime` for a defined one (its
+ * metadata holds the aggregation).
+ */
+export declare const getProcedureProcedure: Procedure<ProcedureGetInput, {
+    found: false;
+} | (ProcedureDescription & {
+    found: true;
+    hasInputSchema: boolean;
+    hasOutputSchema: boolean;
+}), ProcedureMetadata>;
+/**
+ * List the procedures of the caller's registry: all of them, the procedures under a namespace,
+ * or (`runtime: true`) only the procedures that `procedure.define` made. See `getProcedureProcedure`
+ * for DOC-6.
+ */
+export declare const listProceduresProcedure: Procedure<ProcedureListInput, {
+    procedures: ProcedureDescription[];
+    count: number;
+}, ProcedureMetadata>;
+/**
+ * Delete a runtime-defined procedure.
+ */
+export declare const deleteProcedureProcedure: Procedure<{
+    path: ProcedurePath;
+}, {
+    deleted: boolean;
+}, ProcedureMetadata>;
+/**
+ * All meta-procedures for procedure management.
+ */
+export declare const metaProcedures: AnyProcedure[];
+export {};
+//# sourceMappingURL=define-procedure.d.ts.map

package/dist/procedures/define-procedure.d.ts.map

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

package/dist/procedures/define-procedure.js

@@ -0,0 +1,357 @@
+/**
+ * Procedure Definition Procedure
+ *
+ * Meta-procedure that creates procedures at runtime from JSON aggregations.
+ * Enables fully declarative procedure definition without native TypeScript code.
+ *
+ * @example
+ * ```typescript
+ * // Define a procedure that chains multiple steps
+ * await client.call(["procedure", "define"], {
+ *   path: ["my", "workflow"],
+ *   aggregation: {
+ *     $proc: ["client", "chain"],
+ *     input: {
+ *       steps: [
+ *         { $proc: ["fs", "mkdir"], input: { path: { $ref: "input.dir" } } },
+ *         { $proc: ["git", "init"], input: { cwd: { $ref: "input.dir" } } },
+ *       ],
+ *     },
+ *   },
+ * });
+ *
+ * // Now use the defined procedure
+ * await client.call(["my", "workflow"], { dir: "/path/to/project" });
+ * ```
+ */
+import { defineProcedure, validateProcedure } from "./define.js";
+import { PROCEDURE_REGISTRY, assertValidPath } from "./registry.js";
+import { z } from "zod";
+import { anySchema, zodAdapter } from "./core/schemas.js";
+import { keyToPath, pathToKey } from "./types.js";
+import { createRefScope, hydrateInput, isAnyProcedureRef, markDataDriven, prepareRootCall, rawInputRule, RUNS_REFS_TAG, } from "./ref.js";
+import { REGISTRY_READ_EFFECTS, withEffects } from "./effects.js";
+// Input schemas of procedure.define and procedure.delete (roadmap 2.1)
+const procedurePathField = z.array(z.string().min(1)).min(1);
+const defineInputSchema = z.object({
+    path: procedurePathField.describe('The path of the new procedure, for example ["tools", "double"]'),
+    aggregation: z
+        .looseObject({
+        $proc: z.array(z.string().min(1)).min(1).describe("The path of the procedure that the body calls"),
+        input: z.unknown().optional().describe("The input of that call. It reads the input of the new procedure as { $ref: \"input.<field>\" }."),
+        $name: z.string().optional().describe("A name that a $ref can read"),
+    })
+        .describe("The body of the procedure: a call ({ $proc, input }) that runs, as client.exec runs it, each time the procedure is called"),
+    metadata: z.record(z.string(), z.unknown()).optional().describe("The metadata of the procedure, for example { description, tags }"),
+    replace: z.boolean().optional().describe("Replace a procedure that procedure.define made at the same path (never a procedure of code)"),
+});
+const deleteInputSchema = z.object({
+    path: procedurePathField.describe("The path of the procedure to delete (only a procedure that procedure.define made)"),
+});
+/** The JSON form of a `ProcedureDescription`, for the output schemas of `procedure.get`/`list`. */
+const descriptionFields = {
+    path: z.array(z.string()).describe("The path of the procedure"),
+    key: z.string().describe("The path as a dotted key"),
+    description: z.string().optional().describe("The description of the metadata"),
+    tags: z.array(z.string()).optional().describe("The tags of the metadata"),
+    hasHandler: z.boolean().describe("True when the procedure has a handler (it can run)"),
+    runtime: z.boolean().describe("True for a procedure that procedure.define made"),
+    metadata: z.unknown().optional().describe("The whole metadata"),
+};
+/** The output of `procedure.define` */
+const DefineOutputSchema = z.looseObject({
+    path: z.array(z.string()).describe("The path of the defined procedure"),
+    replaced: z.boolean().describe("True when the call replaced a runtime-defined procedure"),
+});
+/**
+ * The output of `procedure.get`: one object, so MCP clients get an object output schema. With
+ * `found: false`, the other fields are absent.
+ */
+const GetOutputSchema = z.looseObject({
+    found: z.boolean().describe("True when the registry has the procedure"),
+    path: descriptionFields.path.optional(),
+    key: descriptionFields.key.optional(),
+    description: descriptionFields.description,
+    tags: descriptionFields.tags,
+    hasHandler: descriptionFields.hasHandler.optional(),
+    runtime: descriptionFields.runtime.optional(),
+    metadata: descriptionFields.metadata,
+    hasInputSchema: z.boolean().optional().describe("True when the procedure has an input schema"),
+    hasOutputSchema: z.boolean().optional().describe("True when the procedure has an output schema"),
+});
+/** The output of `procedure.list` */
+const ListOutputSchema = z.looseObject({
+    procedures: z.array(z.looseObject(descriptionFields)).describe("The procedures, in the order of the registry"),
+    count: z.number().describe("The number of procedures"),
+});
+/** The output of `procedure.delete` */
+const DeleteOutputSchema = z.looseObject({
+    deleted: z.boolean().describe("True when the registry removed the procedure"),
+});
+// =============================================================================
+// Aggregation Handler Factory
+// =============================================================================
+/**
+ * Create a handler that executes an aggregation definition.
+ *
+ * The body runs exactly as `exec()` runs the same program: `prepareRootCall()` gives the path
+ * and the input of the root call (a `$when` on the root call does not apply, a list of calls in
+ * the root input is an implicit chain), then the body starts the root call. The scope of the
+ * body has one name, `input`: the input of the procedure. So `{ $ref: "input.dir" }` reads a
+ * field of the input, and `$last`, the step names, `item`, `acc` and `index` keep their meaning
+ * inside the body. (Deep dive CORE-4: before, a first pass replaced every `$ref` with a field of
+ * the input. Docs review DOC-3: before, the body hydrated its root call as a nested ref, so a
+ * root `$when` applied and a list in the root input stayed a list.)
+ */
+function createAggregationHandler(aggregation) {
+    return async (input, ctx) => {
+        if (!ctx?.client) {
+            throw new Error("procedure.define requires a client context to execute aggregations");
+        }
+        const scope = createRefScope();
+        scope.outputs.set("input", input);
+        const executor = (path, value) => ctx.client.call(path, value);
+        const options = { scope, rawInput: rawInputRule(ctx.registry ?? PROCEDURE_REGISTRY), onRef: ctx.onRef };
+        if (isAnyProcedureRef(aggregation)) {
+            const root = await prepareRootCall(aggregation, executor, options);
+            return ctx.client.call(root.path, root.input);
+        }
+        // A body that is not one call (an older stored program): hydrate it as a root value
+        return hydrateInput(aggregation, executor, options);
+    };
+}
+// =============================================================================
+// Runtime-Defined Procedures
+// =============================================================================
+/**
+ * The handlers that `procedure.define` made, with the program (the aggregation) of each. The
+ * registry is the only store of the procedures: a procedure is runtime-defined when its handler
+ * is a key here. (Before, a separate map kept them, and `procedure.delete` removed only the map
+ * entry: deep dive CORE-3.) The program is kept here, not only in the metadata: a caller that
+ * gives its own metadata to `procedure.define` replaces the metadata.
+ */
+const RUNTIME_PROGRAMS = new WeakMap();
+/** True for a procedure that `procedure.define` made. */
+export function isRuntimeDefined(procedure) {
+    return typeof procedure.handler === "function" && RUNTIME_PROGRAMS.has(procedure.handler);
+}
+/**
+ * The program (the aggregation) of a procedure that `procedure.define` made, or undefined for a
+ * code procedure. A program store saves it and defines it again after a restart (roadmap 3.2).
+ */
+export function runtimeProgramOf(procedure) {
+    return typeof procedure.handler === "function" ? RUNTIME_PROGRAMS.get(procedure.handler) : undefined;
+}
+/**
+ * Get a runtime-defined procedure by path.
+ */
+export function getRuntimeProcedure(path, registry = PROCEDURE_REGISTRY) {
+    const procedure = registry.get(path);
+    return procedure && isRuntimeDefined(procedure) ? procedure : undefined;
+}
+/**
+ * Check if a runtime procedure exists.
+ */
+export function hasRuntimeProcedure(path, registry = PROCEDURE_REGISTRY) {
+    return getRuntimeProcedure(path, registry) !== undefined;
+}
+/**
+ * Get all runtime-defined procedures.
+ */
+export function getAllRuntimeProcedures(registry = PROCEDURE_REGISTRY) {
+    return registry.getAll().filter(isRuntimeDefined);
+}
+/**
+ * Clear all runtime-defined procedures.
+ * Useful for testing.
+ */
+export function clearRuntimeProcedures(registry = PROCEDURE_REGISTRY) {
+    for (const proc of getAllRuntimeProcedures(registry)) {
+        registry.unregister(proc.path);
+    }
+}
+/**
+ * The procedure.define procedure.
+ *
+ * This is a meta-procedure that creates other procedures at runtime
+ * from JSON aggregation definitions.
+ *
+ * The rules (deep dive CORE-3, MCP-4):
+ * - The procedure goes into the caller's registry (`ctx.registry`).
+ * - `replace: true` replaces only a procedure that `procedure.define` made. A code procedure
+ *   stays: an MCP client cannot replace a tool or an internal procedure.
+ * - The registry gets the procedure first. A define that fails leaves nothing.
+ * - The new procedure is data-driven: with a server's `expose` rule, it calls only exposed paths.
+ * - Its input is raw (the `runs-refs` tag): `exec()` does not run the body at definition time.
+ */
+export const defineProcedureProcedure = defineProcedure({
+    path: ["procedure", "define"],
+    input: defineInputSchema,
+    output: DefineOutputSchema,
+    metadata: {
+        description: "Define a new procedure from an aggregation",
+        tags: ["core", "meta", RUNS_REFS_TAG],
+        metaProcedure: true,
+    },
+    handler: async (input, ctx) => {
+        const { path, aggregation, metadata, replace } = input;
+        const registry = ctx?.registry ?? PROCEDURE_REGISTRY;
+        assertValidPath(path);
+        if (!isAnyProcedureRef(aggregation)) {
+            throw new Error('procedure.define: the aggregation must be a procedure ref: { "$proc": [...], "input": {...} }');
+        }
+        const pathKey = path.join(".");
+        const existing = registry.get(path);
+        if (existing && !isRuntimeDefined(existing)) {
+            throw new Error(`A code procedure exists at path: ${pathKey}. procedure.define can replace only a procedure that procedure.define made.`);
+        }
+        if (existing && !replace) {
+            throw new Error(`Procedure already exists at path: ${pathKey}`);
+        }
+        // Create the procedure
+        const procedure = defineProcedure({
+            path,
+            input: anySchema,
+            output: anySchema,
+            metadata: metadata ?? {
+                description: `Runtime-defined aggregation procedure`,
+                generatedFrom: "procedure.define",
+                aggregation,
+            },
+            handler: createAggregationHandler(aggregation),
+        });
+        // Its behavior comes from data: a server with an expose rule lets it call only exposed procedures
+        markDataDriven(procedure);
+        RUNTIME_PROGRAMS.set(procedure.handler, aggregation);
+        // Validate the procedure
+        validateProcedure(procedure);
+        // The registry is the store: exec()/call()/transports find the procedure there. See
+        // documentation/BUGS-2026-07.md (H4).
+        registry.register(procedure, { override: existing !== undefined });
+        return {
+            path,
+            replaced: existing !== undefined,
+        };
+    },
+});
+function describeProcedure(procedure, withMetadata) {
+    const meta = procedure.metadata;
+    const description = {
+        path: procedure.path,
+        key: pathToKey(procedure.path),
+        description: meta?.description,
+        tags: meta?.tags,
+        hasHandler: !!procedure.handler,
+        runtime: isRuntimeDefined(procedure),
+    };
+    if (withMetadata)
+        description.metadata = meta;
+    return description;
+}
+const listInputSchema = z.object({
+    /** Only the procedures under this first path segment */
+    namespace: z.string().optional().describe("Only the procedures under this first path segment"),
+    /** The whole metadata of each procedure */
+    includeMetadata: z.boolean().optional().describe("Give the whole metadata of each procedure"),
+    /** Only the procedures that procedure.define made */
+    runtime: z.boolean().optional().describe("Only the procedures that procedure.define made"),
+});
+const getInputSchema = z.object({
+    /** The path, as an array or a dotted key */
+    path: z.union([z.array(z.string()), z.string()]).describe("The path, as an array or a dotted key"),
+});
+/**
+ * Describe one procedure of the caller's registry.
+ *
+ * Docs review DOC-6: the core version gave only runtime-defined procedures, and client-procedure
+ * replaced it with a version for the whole registry, so the result depended on the imports of
+ * the host. This is the one implementation: any procedure, with `runtime` for a defined one (its
+ * metadata holds the aggregation).
+ */
+export const getProcedureProcedure = defineProcedure({
+    path: ["procedure", "get"],
+    input: zodAdapter(getInputSchema),
+    output: GetOutputSchema,
+    metadata: {
+        description: "Describe a procedure by path or key",
+        tags: ["core", "meta"],
+        args: ["path"],
+        output: "json",
+    },
+    handler: async (input, ctx) => {
+        const path = typeof input.path === "string" ? keyToPath(input.path) : input.path;
+        const procedure = (ctx?.registry ?? PROCEDURE_REGISTRY).get(path);
+        if (!procedure) {
+            return { found: false };
+        }
+        return {
+            found: true,
+            ...describeProcedure(procedure, true),
+            hasInputSchema: !!procedure.input,
+            hasOutputSchema: !!procedure.output,
+        };
+    },
+});
+/**
+ * List the procedures of the caller's registry: all of them, the procedures under a namespace,
+ * or (`runtime: true`) only the procedures that `procedure.define` made. See `getProcedureProcedure`
+ * for DOC-6.
+ */
+export const listProceduresProcedure = defineProcedure({
+    path: ["procedure", "list"],
+    input: zodAdapter(listInputSchema),
+    output: ListOutputSchema,
+    metadata: {
+        description: "List the registered procedures",
+        tags: ["core", "meta"],
+        args: [],
+        shorts: { namespace: "n", includeMetadata: "m" },
+        output: "json",
+    },
+    handler: async (input, ctx) => {
+        let all = (ctx?.registry ?? PROCEDURE_REGISTRY).getAll();
+        if (input.runtime)
+            all = all.filter(isRuntimeDefined);
+        if (input.namespace)
+            all = all.filter((procedure) => procedure.path[0] === input.namespace);
+        const procedures = all.map((procedure) => describeProcedure(procedure, input.includeMetadata ?? false));
+        return { procedures, count: procedures.length };
+    },
+});
+/**
+ * Delete a runtime-defined procedure.
+ */
+export const deleteProcedureProcedure = defineProcedure({
+    path: ["procedure", "delete"],
+    input: deleteInputSchema,
+    output: DeleteOutputSchema,
+    metadata: {
+        description: "Delete a runtime-defined procedure",
+        tags: ["core", "meta"],
+    },
+    handler: async (input, ctx) => {
+        const registry = ctx?.registry ?? PROCEDURE_REGISTRY;
+        const existing = registry.get(input.path);
+        if (!existing) {
+            return { deleted: false };
+        }
+        // A code procedure stays (deep dive CORE-3: before, delete only forgot the runtime record)
+        if (!isRuntimeDefined(existing)) {
+            throw new Error(`procedure.delete removes only a procedure that procedure.define made: ${input.path.join(".")} is a code procedure.`);
+        }
+        return { deleted: registry.unregister(input.path) };
+    },
+});
+// =============================================================================
+// Export All Meta-Procedures
+// =============================================================================
+/**
+ * All meta-procedures for procedure management.
+ */
+export const metaProcedures = [
+    // They read the registry. define and delete change it (CAPABILITIES-2026-10).
+    ...withEffects({ reads: ["registry"], writes: ["registry"] }, [defineProcedureProcedure]),
+    ...withEffects(REGISTRY_READ_EFFECTS, [getProcedureProcedure, listProceduresProcedure]),
+    ...withEffects({ reads: ["registry"], writes: ["registry"] }, [deleteProcedureProcedure]),
+];
+//# sourceMappingURL=define-procedure.js.map

package/dist/procedures/define-procedure.js.map

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