@procedures/client 0.0.0-stage → 0.2.0

package/dist/procedures/core/object.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Object Procedures
+ *
+ * Object manipulation operations for procedure aggregation.
+ * All procedures are namespaced under "client" (e.g., client.get, client.set).
+ */
+import type { AnyProcedure, Procedure } from "../types.js";
+interface GetInput {
+    object: Record<string, unknown>;
+    path: string;
+    default?: unknown | undefined;
+}
+type GetProcedure = Procedure<GetInput, unknown, {
+    description: string;
+    tags: string[];
+}>;
+declare const getProcedure: GetProcedure;
+interface SetInput {
+    object: Record<string, unknown>;
+    path: string;
+    value?: unknown;
+}
+type SetProcedure = Procedure<SetInput, Record<string, unknown>, {
+    description: string;
+    tags: string[];
+}>;
+declare const setProcedure: SetProcedure;
+interface MergeInput {
+    objects: Record<string, unknown>[];
+    deep?: boolean | undefined;
+}
+type MergeProcedure = Procedure<MergeInput, Record<string, unknown>, {
+    description: string;
+    tags: string[];
+}>;
+declare const mergeProcedure: MergeProcedure;
+interface KeysInput {
+    object: Record<string, unknown>;
+}
+type KeysProcedure = Procedure<KeysInput, string[], {
+    description: string;
+    tags: string[];
+}>;
+declare const keysProcedure: KeysProcedure;
+interface ValuesInput {
+    object: Record<string, unknown>;
+}
+type ValuesProcedure = Procedure<ValuesInput, unknown[], {
+    description: string;
+    tags: string[];
+}>;
+declare const valuesProcedure: ValuesProcedure;
+interface EntriesInput {
+    object: Record<string, unknown>;
+}
+type EntriesOutput = Array<[string, unknown]>;
+type EntriesProcedure = Procedure<EntriesInput, EntriesOutput, {
+    description: string;
+    tags: string[];
+}>;
+declare const entriesProcedure: EntriesProcedure;
+interface FromEntriesInput {
+    entries: Array<[string, unknown]>;
+}
+type FromEntriesProcedure = Procedure<FromEntriesInput, Record<string, unknown>, {
+    description: string;
+    tags: string[];
+}>;
+declare const fromEntriesProcedure: FromEntriesProcedure;
+interface PickInput {
+    object: Record<string, unknown>;
+    keys: string[];
+}
+type PickProcedure = Procedure<PickInput, Record<string, unknown>, {
+    description: string;
+    tags: string[];
+}>;
+declare const pickProcedure: PickProcedure;
+interface OmitInput {
+    object: Record<string, unknown>;
+    keys: string[];
+}
+type OmitProcedure = Procedure<OmitInput, Record<string, unknown>, {
+    description: string;
+    tags: string[];
+}>;
+declare const omitProcedure: OmitProcedure;
+interface HasInput {
+    object: Record<string, unknown>;
+    path: string;
+}
+type HasProcedure = Procedure<HasInput, boolean, {
+    description: string;
+    tags: string[];
+}>;
+declare const hasProcedure: HasProcedure;
+/**
+ * All object procedures namespaced under "client".
+ */
+export declare const objectProcedures: AnyProcedure[];
+/**
+ * Object procedures module for registration.
+ */
+export declare const objectModule: {
+    name: string;
+    procedures: AnyProcedure[];
+};
+export { getProcedure, setProcedure, mergeProcedure, keysProcedure, valuesProcedure, entriesProcedure, fromEntriesProcedure, pickProcedure, omitProcedure, hasProcedure, };
+//# sourceMappingURL=object.d.ts.map

package/dist/procedures/core/object.d.ts.map

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

package/dist/procedures/core/object.js

@@ -0,0 +1,272 @@
+/**
+ * Object Procedures
+ *
+ * Object manipulation operations for procedure aggregation.
+ * All procedures are namespaced under "client" (e.g., client.get, client.set).
+ */
+import { z } from "zod";
+import { anyOutput, arrayOutput, booleanOutput, recordOutput } from "./outputs.js";
+import { defineProcedure, namespace } from "../define.js";
+import { PURE_EFFECTS, withEffects } from "../effects.js";
+// =============================================================================
+// Helper: Get nested value by path
+// =============================================================================
+function getByPath(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+// =============================================================================
+// Helper: Set nested value by path
+// =============================================================================
+function setByPath(obj, path, value) {
+    const result = { ...obj };
+    const parts = path.split(".");
+    let current = result;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!(part in current) || typeof current[part] !== "object" || current[part] === null) {
+            current[part] = {};
+        }
+        else {
+            current[part] = { ...current[part] };
+        }
+        current = current[part];
+    }
+    const lastPart = parts[parts.length - 1];
+    if (lastPart !== undefined) {
+        current[lastPart] = value;
+    }
+    return result;
+}
+const GetInputSchema = z.object({
+    object: z.record(z.string(), z.unknown()).describe("The object"),
+    path: z.string().describe("The path of the field, with dots (for example user.name)"),
+    default: z.unknown().optional().describe("The value to give when the path has no value"),
+});
+const getProcedure = defineProcedure({
+    path: ["get"],
+    input: GetInputSchema,
+    output: anyOutput("The value at the path, or the default"),
+    metadata: {
+        description: "Get nested value from object by dot-separated path",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        const value = getByPath(input.object, input.path);
+        return value !== undefined ? value : input.default;
+    },
+});
+const SetInputSchema = z.object({
+    object: z.record(z.string(), z.unknown()).describe("The object"),
+    path: z.string().describe("The path of the field, with dots (for example user.name)"),
+    value: z.unknown().optional().describe("The value"),
+});
+const setProcedure = defineProcedure({
+    path: ["set"],
+    input: SetInputSchema,
+    output: recordOutput("The object with the value at the path"),
+    metadata: {
+        description: "Set nested value in object by dot-separated path (immutable)",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        return setByPath(input.object, input.path, input.value);
+    },
+});
+const MergeInputSchema = z.object({
+    objects: z.array(z.record(z.string(), z.unknown())).describe("The objects"),
+    deep: z.boolean().optional().describe("Merge nested objects too"),
+});
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        if (typeof source[key] === "object" &&
+            source[key] !== null &&
+            !Array.isArray(source[key]) &&
+            typeof result[key] === "object" &&
+            result[key] !== null &&
+            !Array.isArray(result[key])) {
+            result[key] = deepMerge(result[key], source[key]);
+        }
+        else {
+            result[key] = source[key];
+        }
+    }
+    return result;
+}
+const mergeProcedure = defineProcedure({
+    path: ["merge"],
+    input: MergeInputSchema,
+    output: recordOutput("The merged object"),
+    metadata: {
+        description: "Merge multiple objects (shallow or deep)",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        if (input.deep) {
+            return input.objects.reduce((acc, obj) => deepMerge(acc, obj), {});
+        }
+        return Object.assign({}, ...input.objects);
+    },
+});
+const KeysInputSchema = z.object({
+    object: z.record(z.string(), z.unknown()).describe("The object"),
+});
+const keysProcedure = defineProcedure({
+    path: ["keys"],
+    input: KeysInputSchema,
+    output: z.array(z.string()).describe("The own keys of the object"),
+    metadata: {
+        description: "Get array of object keys",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        return Object.keys(input.object);
+    },
+});
+const ValuesInputSchema = z.object({
+    object: z.record(z.string(), z.unknown()).describe("The object"),
+});
+const valuesProcedure = defineProcedure({
+    path: ["values"],
+    input: ValuesInputSchema,
+    output: arrayOutput("The own values of the object"),
+    metadata: {
+        description: "Get array of object values",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        return Object.values(input.object);
+    },
+});
+const EntriesInputSchema = z.object({
+    object: z.record(z.string(), z.unknown()).describe("The object"),
+});
+const entriesProcedure = defineProcedure({
+    path: ["entries"],
+    input: EntriesInputSchema,
+    output: z.array(z.tuple([z.string(), z.unknown()])).describe("The [key, value] pairs of the object"),
+    metadata: {
+        description: "Get array of [key, value] pairs",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        return Object.entries(input.object);
+    },
+});
+const FromEntriesInputSchema = z.object({
+    entries: z.array(z.tuple([z.string(), z.unknown()])).describe("The [key, value] pairs"),
+});
+const fromEntriesProcedure = defineProcedure({
+    path: ["fromEntries"],
+    input: FromEntriesInputSchema,
+    output: recordOutput("The object of the pairs"),
+    metadata: {
+        description: "Create object from [key, value] pairs",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        return Object.fromEntries(input.entries);
+    },
+});
+const PickInputSchema = z.object({
+    object: z.record(z.string(), z.unknown()).describe("The object"),
+    keys: z.array(z.string()).describe("The keys"),
+});
+const pickProcedure = defineProcedure({
+    path: ["pick"],
+    input: PickInputSchema,
+    output: recordOutput("The object with only the given keys"),
+    metadata: {
+        description: "Pick specified keys from object",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        const result = {};
+        for (const key of input.keys) {
+            if (key in input.object) {
+                result[key] = input.object[key];
+            }
+        }
+        return result;
+    },
+});
+const OmitInputSchema = z.object({
+    object: z.record(z.string(), z.unknown()).describe("The object"),
+    keys: z.array(z.string()).describe("The keys"),
+});
+const omitProcedure = defineProcedure({
+    path: ["omit"],
+    input: OmitInputSchema,
+    output: recordOutput("The object without the given keys"),
+    metadata: {
+        description: "Omit specified keys from object",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        const keysToOmit = new Set(input.keys);
+        const result = {};
+        for (const key of Object.keys(input.object)) {
+            if (!keysToOmit.has(key)) {
+                result[key] = input.object[key];
+            }
+        }
+        return result;
+    },
+});
+const HasInputSchema = z.object({
+    object: z.record(z.string(), z.unknown()).describe("The object"),
+    path: z.string().describe("The path of the field, with dots (for example user.name)"),
+});
+const hasProcedure = defineProcedure({
+    path: ["has"],
+    input: HasInputSchema,
+    output: booleanOutput("True when the path exists"),
+    metadata: {
+        description: "Check if object has a value at the specified path",
+        tags: ["core", "object"],
+    },
+    handler: async (input) => {
+        return getByPath(input.object, input.path) !== undefined;
+    },
+});
+// =============================================================================
+// Export Object Procedures
+// =============================================================================
+/**
+ * All object procedures (before namespacing).
+ */
+const objectProceduresRaw = [
+    getProcedure,
+    setProcedure,
+    mergeProcedure,
+    keysProcedure,
+    valuesProcedure,
+    entriesProcedure,
+    fromEntriesProcedure,
+    pickProcedure,
+    omitProcedure,
+    hasProcedure,
+];
+/**
+ * All object procedures namespaced under "client".
+ */
+// Each one calculates its output from its input: no reads, no changes (CAPABILITIES-2026-10)
+export const objectProcedures = namespace(["client"], withEffects(PURE_EFFECTS, objectProceduresRaw));
+/**
+ * Object procedures module for registration.
+ */
+export const objectModule = {
+    name: "client-object",
+    procedures: objectProcedures,
+};
+// Re-export individual procedures for direct access
+export { getProcedure, setProcedure, mergeProcedure, keysProcedure, valuesProcedure, entriesProcedure, fromEntriesProcedure, pickProcedure, omitProcedure, hasProcedure, };
+//# sourceMappingURL=object.js.map

package/dist/procedures/core/object.js.map

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

package/dist/procedures/core/operands.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The operands of the control-flow procedures, shared by `client.chain`, `client.conditional`
+ * and the others, and by `client.eval` (`meta.ts`).
+ */
+import type { ProcedureContext, ProcedurePath } from "../types.js";
+import { type AnyProcedureRef, type RefScope } from "../ref.js";
+/**
+ * The operands of a control-flow procedure arrive raw: the procedure runs them itself, with the
+ * same rules as `exec()` (one interpreter, `hydrateInput`). The input of a control-flow procedure
+ * carries the scope of its caller (`withScope`), so an operand can read the names of an outer
+ * chain, `map` or `reduce` (deep dive CORE-13).
+ */
+/** The raw-input rule of the caller's registry: the procedure at a path decides (deep dive CORE-5). */
+export declare function rawRule(ctx: ProcedureContext): (path: ProcedurePath) => boolean;
+/**
+ * Without a client, a control-flow procedure cannot run refs. This function gives a value with
+ * its known `$ref` values resolved. A name that the scope does not have stays as it is.
+ */
+export declare function substituteRefs(value: unknown, scope: RefScope): unknown;
+/**
+ * This function gives the value of an operand that is not a ref: it resolves its `$ref` values
+ * in `scope` and runs its nested refs, as `exec()` does for an input.
+ */
+export declare function hydrateOperand(value: unknown, ctx: ProcedureContext, scope?: RefScope): Promise<unknown>;
+/**
+ * This function runs an operand ref of a control-flow procedure.
+ *
+ * It resolves the `$ref` values of the ref's input in `scope`, runs the nested refs of the
+ * input and adds `extra` (the parent context, for example `cwd`). Then it calls the procedure.
+ * A procedure that takes its input raw (control flow) gets the input unchanged, with the scope:
+ * that procedure runs its own operands.
+ */
+export declare function callOperand(ref: AnyProcedureRef, ctx: ProcedureContext, options?: {
+    scope?: RefScope | undefined;
+    extra?: Record<string, unknown> | undefined;
+}): Promise<unknown>;
+/** This function gives the value of any operand: a ref runs, another value is hydrated. */
+export declare function evaluateOperand(value: unknown, ctx: ProcedureContext, options?: {
+    scope?: RefScope | undefined;
+    extra?: Record<string, unknown> | undefined;
+}): Promise<unknown>;
+/** The parent context that the control-flow procedures give to their operands. */
+export declare function parentContext(input: {
+    cwd?: string | undefined;
+    node?: unknown;
+}): Record<string, unknown>;
+/** A child scope of `parent` with the given `$ref` names, for one call of `fn`. */
+export declare function scopeWith(values: Record<string, unknown>, parent?: RefScope): RefScope;
+/** The tags of a control-flow procedure: hydration gives it its input raw. */
+export declare function controlFlowTags(...tags: string[]): string[];
+//# sourceMappingURL=operands.d.ts.map

package/dist/procedures/core/operands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operands.d.ts","sourceRoot":"","sources":["../../../src/procedures/core/operands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAUL,KAAK,eAAe,EACpB,KAAK,QAAQ,EACd,MAAM,WAAW,CAAC;AAEnB;;;;;GAKG;AAEH,uGAAuG;AACvG,wBAAgB,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAE/E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAevE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9G;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,gBAAgB,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAAO,GAC1F,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,2FAA2F;AAC3F,wBAAsB,eAAe,CACnC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,gBAAgB,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAAO,GAC1F,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK1G;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAItF;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE3D"}

package/dist/procedures/core/operands.js

@@ -0,0 +1,90 @@
+/**
+ * The operands of the control-flow procedures, shared by `client.chain`, `client.conditional`
+ * and the others, and by `client.eval` (`meta.ts`).
+ */
+import { PROCEDURE_REGISTRY } from "../registry.js";
+import { isAnyProcedureRef, normalizeRef, hydrateInput, createRefScope, isOutputRef, lookupOutputRef, rawInputRule, withScope, RUNS_REFS_TAG, } from "../ref.js";
+/**
+ * The operands of a control-flow procedure arrive raw: the procedure runs them itself, with the
+ * same rules as `exec()` (one interpreter, `hydrateInput`). The input of a control-flow procedure
+ * carries the scope of its caller (`withScope`), so an operand can read the names of an outer
+ * chain, `map` or `reduce` (deep dive CORE-13).
+ */
+/** The raw-input rule of the caller's registry: the procedure at a path decides (deep dive CORE-5). */
+export function rawRule(ctx) {
+    return rawInputRule(ctx.registry ?? PROCEDURE_REGISTRY);
+}
+/**
+ * Without a client, a control-flow procedure cannot run refs. This function gives a value with
+ * its known `$ref` values resolved. A name that the scope does not have stays as it is.
+ */
+export function substituteRefs(value, scope) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    if (isOutputRef(value)) {
+        const { found, value: resolved } = lookupOutputRef(value.$ref, scope);
+        return found ? resolved : value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => substituteRefs(item, scope));
+    }
+    if (isAnyProcedureRef(value)) {
+        return value;
+    }
+    return Object.fromEntries(Object.entries(value).map(([key, val]) => [key, substituteRefs(val, scope)]));
+}
+/**
+ * This function gives the value of an operand that is not a ref: it resolves its `$ref` values
+ * in `scope` and runs its nested refs, as `exec()` does for an input.
+ */
+export async function hydrateOperand(value, ctx, scope) {
+    return hydrateInput(value, (path, input) => ctx.client.call(path, input), { scope, rawInput: rawRule(ctx), onRef: ctx.onRef });
+}
+/**
+ * This function runs an operand ref of a control-flow procedure.
+ *
+ * It resolves the `$ref` values of the ref's input in `scope`, runs the nested refs of the
+ * input and adds `extra` (the parent context, for example `cwd`). Then it calls the procedure.
+ * A procedure that takes its input raw (control flow) gets the input unchanged, with the scope:
+ * that procedure runs its own operands.
+ */
+export async function callOperand(ref, ctx, options = {}) {
+    const normalized = normalizeRef(ref);
+    const raw = rawRule(ctx)(normalized.path);
+    let input = raw ? normalized.input : await hydrateOperand(normalized.input, ctx, options.scope);
+    const extra = options.extra ?? {};
+    if (Object.keys(extra).length > 0) {
+        input = { ...(typeof input === "object" && input !== null && !Array.isArray(input) ? input : {}), ...extra };
+    }
+    if (raw) {
+        input = withScope(input, options.scope);
+    }
+    return ctx.client.call(normalized.path, input);
+}
+/** This function gives the value of any operand: a ref runs, another value is hydrated. */
+export async function evaluateOperand(value, ctx, options = {}) {
+    if (isAnyProcedureRef(value)) {
+        return callOperand(value, ctx, options);
+    }
+    return hydrateOperand(value, ctx, options.scope);
+}
+/** The parent context that the control-flow procedures give to their operands. */
+export function parentContext(input) {
+    return {
+        ...(input.cwd ? { cwd: input.cwd } : {}),
+        ...(input.node ? { node: input.node } : {}),
+    };
+}
+/** A child scope of `parent` with the given `$ref` names, for one call of `fn`. */
+export function scopeWith(values, parent) {
+    const scope = createRefScope(parent);
+    for (const [name, value] of Object.entries(values))
+        scope.outputs.set(name, value);
+    return scope;
+}
+/** The tags of a control-flow procedure: hydration gives it its input raw. */
+export function controlFlowTags(...tags) {
+    return ["core", ...tags, RUNS_REFS_TAG];
+}
+//# sourceMappingURL=operands.js.map

package/dist/procedures/core/operands.js.map

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

package/dist/procedures/core/outputs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The output schemas of the core procedures (roadmap 2.1).
+ *
+ * Before, every core procedure declared a pass-through output, so a wrong output went through,
+ * the MCP tools had no output schema, and `mark --help` could not show the result. These
+ * helpers give each output a real zod 4 schema with a description.
+ */
+import { z } from "zod";
+/**
+ * Any JavaScript number, also `NaN` and `Infinity`. zod 4's `z.number()` refuses both, but
+ * `client.divide` by 0, `client.sqrt` of a negative number and `client.pow` can give them (the
+ * Composer shows them). The JSON Schema is `{ "type": "number" }`.
+ */
+export declare function numberOutput(description: string): z.ZodType<number>;
+/** A string result. */
+export declare function stringOutput(description: string): z.ZodType<string>;
+/** A boolean result. */
+export declare function booleanOutput(description: string): z.ZodType<boolean>;
+/**
+ * A result whose shape depends on the input or on the program: any JSON value (also
+ * `undefined`). Its JSON Schema is `{}`, so an MCP client gets no output schema for it.
+ */
+export declare function anyOutput(description: string): z.ZodType<unknown>;
+/** An array of any values. */
+export declare function arrayOutput(description: string): z.ZodType<unknown[]>;
+/** An object with string keys and any values. */
+export declare function recordOutput(description: string): z.ZodType<Record<string, unknown>>;
+//# sourceMappingURL=outputs.d.ts.map

package/dist/procedures/core/outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../../../src/procedures/core/outputs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAInE;AAED,uBAAuB;AACvB,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,wBAAwB;AACxB,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAErE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAEjE;AAED,8BAA8B;AAC9B,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAErE;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEpF"}

package/dist/procedures/core/outputs.js

@@ -0,0 +1,42 @@
+/**
+ * The output schemas of the core procedures (roadmap 2.1).
+ *
+ * Before, every core procedure declared a pass-through output, so a wrong output went through,
+ * the MCP tools had no output schema, and `mark --help` could not show the result. These
+ * helpers give each output a real zod 4 schema with a description.
+ */
+import { z } from "zod";
+/**
+ * Any JavaScript number, also `NaN` and `Infinity`. zod 4's `z.number()` refuses both, but
+ * `client.divide` by 0, `client.sqrt` of a negative number and `client.pow` can give them (the
+ * Composer shows them). The JSON Schema is `{ "type": "number" }`.
+ */
+export function numberOutput(description) {
+    return z
+        .custom((value) => typeof value === "number", { message: "Expected a number" })
+        .meta({ type: "number", description });
+}
+/** A string result. */
+export function stringOutput(description) {
+    return z.string().describe(description);
+}
+/** A boolean result. */
+export function booleanOutput(description) {
+    return z.boolean().describe(description);
+}
+/**
+ * A result whose shape depends on the input or on the program: any JSON value (also
+ * `undefined`). Its JSON Schema is `{}`, so an MCP client gets no output schema for it.
+ */
+export function anyOutput(description) {
+    return z.unknown().describe(description);
+}
+/** An array of any values. */
+export function arrayOutput(description) {
+    return z.array(z.unknown()).describe(description);
+}
+/** An object with string keys and any values. */
+export function recordOutput(description) {
+    return z.record(z.string(), z.unknown()).describe(description);
+}
+//# sourceMappingURL=outputs.js.map

package/dist/procedures/core/outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.js","sourceRoot":"","sources":["../../../src/procedures/core/outputs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,CAAC;SACL,MAAM,CAAS,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;SACtF,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,WAAmB;IAC3C,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACpD,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACjE,CAAC"}