@dsh-cc/tools 0.5.0

package/lib/runtime-schemas.js

@@ -0,0 +1,222 @@
+/**
+ * ToolRuntime presentation collaborators: the presentation-mode resolver, the
+ * `code` collapse statement, prompt-section assembly, and the model-facing
+ * schema projections. Bodies are verbatim moves from the former `ToolRuntime`
+ * methods with `this.` → `rt.`.
+ * @module
+ */
+import { scopeOf } from '@deepseek-ai/dsh-scope';
+import { snapshotJsonValue } from '@deepseek-ai/dsh-session';
+import { RUN_CODE_NAME, SDK_SECTION_ORDER } from "./code-mode.js";
+import { SDK_RENDERERS } from "./runtime-core.js";
+/**
+ * Prompt order of the `code` collapse statement: after the persona and before
+ * the 100-199 per-tool guidance band, so the model reads which tools it may
+ * call before it reads what each one is for.
+ */
+const COLLAPSE_SECTION_ORDER = 99;
+/**
+ * The model-facing statement of the `code` collapse. Names the consequence
+ * (the call fails) and the route (inside the program), because a rule the
+ * model can only discover by being denied is one it corrects too late.
+ */
+const CODE_ONLY_INSTRUCTION = `\`${RUN_CODE_NAME}\` is the only tool you can call directly — a tool call naming any other tool fails. Reach every tool the SDK declares below from inside the program.`;
+/**
+ * The prompt statement of the `code` executor collapse, registered wherever
+ * `sdkSection` is and rendering empty outside an effective `code`.
+ *
+ * Every tool contributes its own guidance section naming its tool, none of
+ * them qualify how that tool is reached, and they all render before the SDK
+ * (orders 100-199 against `SDK_SECTION_ORDER`). Without this the model
+ * reads a catalog of tools it is told to use and no statement that only
+ * `run_code` may be called, so it emits a native call, receives
+ * `UNKNOWN_TOOL` for a tool the prompt just declared, and concludes the
+ * deployment is inconsistent. `COLLAPSE_SECTION_ORDER` places the rule
+ * before that guidance rather than after it.
+ *
+ * `both` renders empty: native calls do execute there, so the rule is false.
+ * @param rt - the owning runtime.
+ * @returns the section registration.
+ */
+export function collapseSection(rt) {
+    return {
+        name: 'tools:code-only',
+        order: COLLAPSE_SECTION_ORDER,
+        // The SAME predicate the executor denies by, so the prompt cannot state
+        // a rule the registry does not enforce (see `collapses`).
+        text: context => rt.modeFor(context.scope) === 'code' ? CODE_ONLY_INSTRUCTION : '',
+    };
+}
+/**
+ * The generated-SDK prompt section, registered globally by a code-mode
+ * deployment and per scope by `presentAs`.
+ *
+ * The body regenerates from the CALLING scope, and renders empty for an
+ * agent presenting natively — an agent that opted out under a code-mode
+ * deployment still sees the global registration, and an empty section is
+ * dropped from the rendered prompt.
+ * @param rt - the owning runtime.
+ * @returns the section registration.
+ */
+export function sdkSection(rt) {
+    return {
+        name: 'tools:sdk',
+        order: SDK_SECTION_ORDER,
+        // Regenerate from the calling scope's visible tools in stable order.
+        text: (context) => {
+            const mode = rt.modeFor(context.scope);
+            if (mode === 'native')
+                return '';
+            const runtime = rt.requireCodeRuntime(mode);
+            // Own-property read: a language like `toString`/`constructor` would
+            // otherwise resolve an inherited Object.prototype member as a renderer.
+            const render = SDK_RENDERERS[runtime.language];
+            /* v8 ignore next -- requireCodeRuntime rejects an unknown language before this runs. */
+            if (render === undefined)
+                throw new Error(`dsh-tools: no SDK renderer for ${runtime.language}`);
+            return render(rt.sdkSchemas(context.scope));
+        },
+    };
+}
+/**
+ * The presentation one scope's agent sees: its own declaration, else the
+ * deployment default.
+ * @param rt - the owning runtime.
+ * @param scope - the calling agent, or undefined for the global view.
+ * @returns the resolved presentation mode.
+ */
+export function modeFor(rt, scope) {
+    // Nearest scope wins along the chain: a preset's standing declaration
+    // covers every agent parented under it, and an agent's own (were one ever
+    // declared) would override its preset's. The mode decides what the model
+    // SEES, which is exactly the class of fact the chain inherits.
+    const layers = rt.layers.chainLayers(scope);
+    for (let index = layers.length - 1; index >= 0; index -= 1) {
+        const mode = layers[index]?.mode;
+        if (mode !== undefined)
+            return mode;
+    }
+    return rt.defaultMode;
+}
+/**
+ * Present the calling scope's tools in `mode` instead of the deployment
+ * default. Nearest scope on the chain wins, so a preset's standing
+ * declaration covers every agent joined under it.
+ *
+ * Scoped only, and one declaration per scope: this is how an agent preset
+ * composes Code Mode agents beside native ones in the same process, and a
+ * process-global override would be the `mode` config field instead.
+ * @param rt - the owning runtime.
+ * @param mode - the presentation the covered agents' models see.
+ * @returns the exact disposer that restores the deployment default.
+ */
+export function presentAs(rt, mode) {
+    const ctx = rt.ctx;
+    if (scopeOf(ctx) === undefined) {
+        throw new Error('tools.presentAs() requires a scoped context (agent.ctx): a context-global presentation is the `mode` config field on the tools row');
+    }
+    const dispose = ctx.effect(function* () {
+        yield this.layers.effect(ctx, (layer) => {
+            if (layer.mode !== undefined) {
+                throw new Error(`tools.presentAs("${mode}") conflicts with "${layer.mode}" already declared for this scope; one composition selects one presentation`);
+            }
+            layer.mode = mode;
+            return () => { layer.mode = undefined; };
+        }, { label: 'tools.presentAs()' });
+        // The SDK and collapse sections are per scope for the same reason the
+        // mode is. Under a deployment that already defaults to a code mode this
+        // shadows the global registration with an identical body, which costs
+        // nothing and keeps one rule instead of a case analysis.
+        if (mode !== 'native') {
+            yield ctx.systemPrompt.section(this.collapseSection());
+            yield ctx.systemPrompt.section(this.sdkSection());
+        }
+    }.bind(rt), 'tools.presentAs()');
+    return dispose;
+}
+/**
+ * Build one scope's wire schemas and names for prompt-order validation.
+ * Restrictions do not make known tools invalid, but a mode collapse does.
+ */
+export function wireSchemas(rt, scope) {
+    const view = rt.view(scope);
+    const mode = rt.modeFor(scope);
+    if (mode === 'native') {
+        const schemas = [...view.visible.values()].map(definition => rt.schemaOf(definition, false));
+        return { schemas, knownNames: [...view.knownNames] };
+    }
+    // Validate the runtime language BEFORE projecting schemas: schemaOf reads
+    // run_code's language-aware description/parameters getters, whose own
+    // flavor-table guard would otherwise surface first. This keeps the
+    // renderer-table rejection the canonical assembly-time error for a
+    // language with no SDK renderer.
+    rt.requireCodeRuntime(mode);
+    const schemas = [...view.visible.values()].map(definition => rt.schemaOf(definition, false));
+    if (mode === 'code') {
+        return {
+            schemas: schemas.filter(schema => schema.name === RUN_CODE_NAME),
+            knownNames: [RUN_CODE_NAME],
+        };
+    }
+    return { schemas, knownNames: [...view.knownNames, RUN_CODE_NAME] };
+}
+/**
+ * Project visible definitions onto the allowlisted model-facing schema fields,
+ * excluding execution and presentation callbacks.
+ * @param rt - the owning runtime.
+ * @param scope - the viewing scope (the agent); omitted = the global view.
+ * @returns one deep-cloned schema per visible tool.
+ */
+export function schemas(rt, scope) {
+    return [...rt.view(scope).visible.values()].map(definition => rt.schemaOf(definition, true));
+}
+/** Project visible callable tools onto the generated Code Mode SDK contract. */
+export function sdkSchemas(rt, scope) {
+    return [...rt.view(scope).visible.values()]
+        .filter(definition => definition.name !== RUN_CODE_NAME)
+        .map((definition) => {
+        const output = snapshotJsonValue(definition.output.schema);
+        /* v8 ignore next -- registration already validated and retained this schema as lossless JSON. */
+        if (output === undefined) {
+            throw new Error(`tool "${definition.name}" output schema must be lossless JSON before SDK projection`);
+        }
+        return {
+            ...rt.schemaOf(definition, true),
+            output,
+        };
+    });
+}
+/** Project one definition onto the model-facing schema fields. */
+export function schemaOf(_rt, definition, detachParameters) {
+    const { name, description, parameters } = definition;
+    const detached = detachParameters ? snapshotJsonValue(parameters) : parameters;
+    if (detached === undefined) {
+        throw new Error(`tool "${name}" parameters must be lossless JSON before schema projection`);
+    }
+    return {
+        name,
+        description,
+        parameters: detached,
+    };
+}
+/**
+ * Whether the `code` mode collapse denies a model-direct call: only the
+ * reserved `run_code` transport may be named. Nested sub-dispatches (a
+ * `parent` token set) bypass the collapse. One home for the
+ * security-relevant predicate, shared by `resolveExecution` and
+ * `createExecution` so the two can never drift apart.
+ *
+ * Resolved through `modeFor`, NOT `defaultMode`: an agent given `code`
+ * by an agent preset under a native deployment is the composition
+ * `dsh-agent-tool-presentation` exists for, and reading the deployment default would
+ * leave exactly that agent uncollapsed — announcing one surface while
+ * executing another, which is the bypass this collapse closes.
+ * @param rt - the owning runtime.
+ * @param name - the tool name as registered.
+ * @param scope - the viewing scope whose effective presentation mode applies.
+ * @param nested - whether the call is a transport sub-dispatch, not a model-direct call.
+ */
+export function collapses(rt, name, scope, nested) {
+    return !nested && rt.modeFor(scope) === 'code' && name !== RUN_CODE_NAME;
+}
+//# sourceMappingURL=runtime-schemas.js.map

package/lib/runtime-schemas.js.map

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

package/lib/scheduler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Upstream scheduler symbol binding, isolated as a leaf module so neither the
+ * package barrel nor Code Mode needs to import runtime values from the other.
+ * @module @dsh-cc/tools/src/scheduler
+ */
+declare const upstreamSchedulerSymbol: unique symbol;
+/**
+ * Scheduler entry point omitted from the generated named service API.
+ * The value MUST be the upstream symbol instance: the in-box agent loop reads
+ * the staged scheduler off the registry through the symbol exported by
+ * `@deepseek-ai/dsh-tools`, and a `Symbol()` is identity-unique — minting a
+ * private one here leaves the loop reading `undefined` and crashing every
+ * turn's first tool call (`undefined.prepare`). The binding is a type-erased
+ * `createRequire` rather than a static import so upstream's declaration graph
+ * (its own `Context` augmentation, whose vendored copy this package also
+ * ships) never enters downstream type programs; the dependency stays
+ * runtime-only (peer-declared).
+ * @internal
+ */
+export declare const TOOL_RUNTIME_SCHEDULER: typeof upstreamSchedulerSymbol;
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

package/lib/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,CAAC,MAAM,uBAAuB,EAAE,OAAO,MAAM,CAAA;AAEpD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,uBAEpB,CAAA"}

package/lib/scheduler.js

@@ -0,0 +1,21 @@
+/**
+ * Upstream scheduler symbol binding, isolated as a leaf module so neither the
+ * package barrel nor Code Mode needs to import runtime values from the other.
+ * @module @dsh-cc/tools/src/scheduler
+ */
+import { createRequire } from 'node:module';
+/**
+ * Scheduler entry point omitted from the generated named service API.
+ * The value MUST be the upstream symbol instance: the in-box agent loop reads
+ * the staged scheduler off the registry through the symbol exported by
+ * `@deepseek-ai/dsh-tools`, and a `Symbol()` is identity-unique — minting a
+ * private one here leaves the loop reading `undefined` and crashing every
+ * turn's first tool call (`undefined.prepare`). The binding is a type-erased
+ * `createRequire` rather than a static import so upstream's declaration graph
+ * (its own `Context` augmentation, whose vendored copy this package also
+ * ships) never enters downstream type programs; the dependency stays
+ * runtime-only (peer-declared).
+ * @internal
+ */
+export const TOOL_RUNTIME_SCHEDULER = createRequire(import.meta.url)('@deepseek-ai/dsh-tools').TOOL_RUNTIME_SCHEDULER;
+//# sourceMappingURL=scheduler.js.map

package/lib/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAI3C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,wBAAwB,CACxD,CAAC,sBAAsB,CAAA"}

package/lib/schema-spec.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Author-facing value-schema DSL types and compile-time inference for the
+ * unified JSON-value schema. Runtime compilation lives in
+ * {@link ./define-tool.ts}; the raw JSON Schema subset lives in
+ * {@link ./json-schema.ts}.
+ * @module dsh-tools/schema-spec
+ */
+import type { JsonValue } from '@deepseek-ai/dsh-session';
+import type { JsonSchemaNode, ObjectJsonSchema } from './json-schema.ts';
+/** Annotation keywords shared by every author-facing schema node. */
+export interface ValueSchemaAnnotations {
+    /** Human-readable description projected into JSON Schema and generated types. */
+    description?: string;
+    /** Human-readable title projected into JSON Schema. */
+    title?: string;
+    /** Non-validating default annotation; it must be lossless JSON data. */
+    default?: JsonValue;
+    /** Non-validating examples annotation; it must be lossless JSON data. */
+    examples?: JsonValue;
+}
+/** String value schema with type-correct literal constraints. */
+export interface StringValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'string';
+    enum?: readonly string[];
+    const?: string;
+}
+/** Finite JSON-number schema with type-correct literal constraints. */
+export interface NumberValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'number';
+    enum?: readonly number[];
+    const?: number;
+}
+/** Integer schema with type-correct literal constraints. */
+export interface IntegerValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'integer';
+    enum?: readonly number[];
+    const?: number;
+}
+/** Boolean value schema with type-correct literal constraints. */
+export interface BooleanValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'boolean';
+    enum?: readonly boolean[];
+    const?: boolean;
+}
+/** Null value schema with type-correct literal constraints. */
+export interface NullValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'null';
+    enum?: readonly null[];
+    const?: null;
+}
+/** Array value schema; omitted `items` accepts any lossless JSON item. */
+export interface ArrayValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'array';
+    items?: ValueSchemaSpec;
+}
+/**
+ * Explicit object value schema. Openness is mandatory so a nested or output
+ * object never acquires an accidental JSON Schema default.
+ */
+export interface ObjectValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'object';
+    properties?: ParameterSchemaSpec;
+    additionalProperties: boolean;
+}
+/** Author-only unconstrained lossless JSON node. */
+export interface JsonValueSchemaSpec extends ValueSchemaAnnotations {
+    type: 'json';
+}
+/** Exact-one union schema; at least two branches are required. */
+export interface OneOfValueSchemaSpec extends ValueSchemaAnnotations {
+    oneOf: readonly [ValueSchemaSpec, ValueSchemaSpec, ...ValueSchemaSpec[]];
+}
+/** One author-facing schema for any lossless JSON value root. */
+export type ValueSchemaSpec = StringValueSchemaSpec | NumberValueSchemaSpec | IntegerValueSchemaSpec | BooleanValueSchemaSpec | NullValueSchemaSpec | ArrayValueSchemaSpec | ObjectValueSchemaSpec | JsonValueSchemaSpec | OneOfValueSchemaSpec;
+/** One implicit parameter-root property, optionally required. */
+export type ParameterPropertySpec = ValueSchemaSpec & {
+    required?: true;
+};
+/**
+ * Tool parameter schema. The map itself is an implicit open object root;
+ * requiredness remains a per-property `required: true` annotation.
+ */
+export type ParameterSchemaSpec = {
+    [key: string]: ParameterPropertySpec;
+    [key: symbol]: never;
+};
+/** Raw JSON Schema projection of the implicit parameter object. */
+export interface ParameterJsonSchema extends ObjectJsonSchema {
+    properties: Record<string, JsonSchemaNode>;
+}
+/** Flatten an intersection into one object type for readable hovers. */
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** String keys of one property map; runtime compilation rejects symbol keys. */
+type StringKeyOf<S> = Extract<keyof S, string>;
+/** Keys of a property map marked `required: true`. */
+type RequiredKeys<S> = {
+    [K in StringKeyOf<S>]: S[K] extends {
+        required: true;
+    } ? K : never;
+}[StringKeyOf<S>];
+/** Infer the declared value of one parameter property without key optionality. */
+type InferProperty<P, Depth extends unknown[]> = InferValueAt<P, Depth>;
+/** Infer an implicit property map into required and optional object keys. */
+type InferProperties<S, Depth extends unknown[]> = Simplify<{
+    [K in RequiredKeys<S>]: InferProperty<S[K], Depth>;
+} & {
+    [K in Exclude<StringKeyOf<S>, RequiredKeys<S>>]?: InferProperty<S[K], Depth>;
+}>;
+/** Infer an explicit object node, including its declared openness. */
+type InferObject<S extends {
+    additionalProperties: boolean;
+}, Depth extends unknown[]> = S extends {
+    properties: infer P;
+} ? S['additionalProperties'] extends true ? InferProperties<P, Depth> & Record<string, JsonValue> : InferProperties<P, Depth> : S['additionalProperties'] extends true ? Record<string, JsonValue> : Record<string, never>;
+/** Infer a scalar node's literal constraint before its broad primitive type. */
+type InferScalar<S, Fallback> = S extends {
+    const: infer C;
+} ? C : S extends {
+    enum: readonly (infer E)[];
+} ? E : Fallback;
+/** Add one schema-container level to bounded compile-time inference. */
+type NextInferenceDepth<Depth extends unknown[]> = [unknown, ...Depth];
+/** Infer one node without recursively checking it against the full author union. */
+type InferValueAt<S, Depth extends unknown[]> = Depth['length'] extends 16 ? JsonValue : S extends {
+    type: 'string';
+} ? InferScalar<S, string> : S extends {
+    type: 'number' | 'integer';
+} ? InferScalar<S, number> : S extends {
+    type: 'boolean';
+} ? InferScalar<S, boolean> : S extends {
+    type: 'null';
+} ? null : S extends {
+    type: 'array';
+} ? S extends {
+    items: infer I;
+} ? InferValueAt<I, NextInferenceDepth<Depth>>[] : JsonValue[] : S extends {
+    type: 'object';
+    additionalProperties: boolean;
+} ? InferObject<S, NextInferenceDepth<Depth>> : S extends {
+    type: 'json';
+} ? JsonValue : S extends {
+    oneOf: readonly unknown[];
+} ? InferValueAt<S['oneOf'][number], NextInferenceDepth<Depth>> : never;
+/**
+ * Infer the TypeScript value accepted by an author-facing value schema. Exact
+ * inference is bounded to 16 container levels, then falls back to `JsonValue`.
+ */
+export type InferValue<S> = InferValueAt<S, []>;
+/** Infer the TypeScript argument object for an implicit parameter schema. */
+export type InferArgs<S> = InferProperties<S, []>;
+export {};
+//# sourceMappingURL=schema-spec.d.ts.map

package/lib/schema-spec.d.ts.map

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

package/lib/schema-spec.js

@@ -0,0 +1,9 @@
+/**
+ * Author-facing value-schema DSL types and compile-time inference for the
+ * unified JSON-value schema. Runtime compilation lives in
+ * {@link ./define-tool.ts}; the raw JSON Schema subset lives in
+ * {@link ./json-schema.ts}.
+ * @module dsh-tools/schema-spec
+ */
+export {};
+//# sourceMappingURL=schema-spec.js.map

package/lib/schema-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-spec.js","sourceRoot":"","sources":["../src/schema-spec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/lib/schema.d.ts

@@ -0,0 +1,5 @@
+/** Unified JSON-value schema DSL, inference, compilation, and typed tool helper. @module dsh-tools/schema */
+export type { ArrayValueSchemaSpec, BooleanValueSchemaSpec, InferArgs, InferValue, IntegerValueSchemaSpec, JsonValueSchemaSpec, NullValueSchemaSpec, NumberValueSchemaSpec, ObjectValueSchemaSpec, OneOfValueSchemaSpec, ParameterJsonSchema, ParameterPropertySpec, ParameterSchemaSpec, StringValueSchemaSpec, ValueSchemaAnnotations, ValueSchemaSpec, } from './schema-spec.ts';
+export { defineTool, parameterSchemaSpecToJsonSchema, ToolArgsError, validateArgs, valueSchemaSpecToJsonSchema } from './define-tool.ts';
+export type { DefineToolOptions } from './define-tool.ts';
+//# sourceMappingURL=schema.d.ts.map

package/lib/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,UAAU,EACV,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,GAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,+BAA+B,EAAE,aAAa,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AACxI,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA"}

package/lib/schema.js

@@ -0,0 +1,3 @@
+/** Unified JSON-value schema DSL, inference, compilation, and typed tool helper. @module dsh-tools/schema */
+export { defineTool, parameterSchemaSpecToJsonSchema, ToolArgsError, validateArgs, valueSchemaSpecToJsonSchema } from "./define-tool.js";
+//# sourceMappingURL=schema.js.map

package/lib/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAoB7G,OAAO,EAAE,UAAU,EAAE,+BAA+B,EAAE,aAAa,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA"}

package/lib/testing.d.ts

@@ -0,0 +1,25 @@
+/** Canonical tool-definition fixtures for repository tests. @module dsh-tools/testing */
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { DefineToolOptions, ParameterSchemaSpec } from './schema.ts';
+import type { ToolDefinition, ToolRunContext } from './index.ts';
+declare const CONTENT_VALUE_SCHEMA: {
+    readonly type: "array";
+    readonly items: {
+        readonly type: "json";
+    };
+};
+/** Options for a fixture whose canonical value is its rendered content array. */
+export type ContentToolFixtureOptions<S extends ParameterSchemaSpec> = Omit<DefineToolOptions<S, typeof CONTENT_VALUE_SCHEMA>, 'output' | 'execute'> & {
+    /** Produce the fixture's content blocks as its canonical test value. */
+    execute(args: import('./schema.ts').InferArgs<S>, exec: ToolRunContext): Promise<ContentBlock[]>;
+};
+/**
+ * Define a test fixture that deliberately uses its content blocks as the
+ * canonical JSON value. Product tools must declare domain-owned DTOs instead.
+ * @param options - ordinary fixture fields plus a content-producing body.
+ * @returns a registry-ready tool with an explicit JSON-array output contract.
+ * @internal
+ */
+export declare function defineContentToolFixture<const S extends ParameterSchemaSpec>(options: ContentToolFixtureOptions<S>): ToolDefinition;
+export {};
+//# sourceMappingURL=testing.d.ts.map

package/lib/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhE,QAAA,MAAM,oBAAoB;;;;;CAAsD,CAAA;AAEhF,iFAAiF;AACjF,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,mBAAmB,IAAI,IAAI,CACzE,iBAAiB,CAAC,CAAC,EAAE,OAAO,oBAAoB,CAAC,EACjD,QAAQ,GAAG,SAAS,CACrB,GAAG;IACF,wEAAwE;IACxE,OAAO,CAAC,IAAI,EAAE,OAAO,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACjG,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAC1E,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACpC,cAAc,CAahB"}

package/lib/testing.js

@@ -0,0 +1,25 @@
+/** Canonical tool-definition fixtures for repository tests. @module dsh-tools/testing */
+import { defineTool } from "./schema.js";
+const CONTENT_VALUE_SCHEMA = { type: 'array', items: { type: 'json' } };
+/**
+ * Define a test fixture that deliberately uses its content blocks as the
+ * canonical JSON value. Product tools must declare domain-owned DTOs instead.
+ * @param options - ordinary fixture fields plus a content-producing body.
+ * @returns a registry-ready tool with an explicit JSON-array output contract.
+ * @internal
+ */
+export function defineContentToolFixture(options) {
+    // oxlint-disable-next-line typescript/unbound-method
+    const execute = options.execute;
+    return defineTool({
+        ...options,
+        output: {
+            schema: CONTENT_VALUE_SCHEMA,
+            render: (_args, value) => value,
+        },
+        async execute(args, exec) {
+            return await execute(args, exec);
+        },
+    });
+}
+//# sourceMappingURL=testing.js.map

package/lib/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAIzF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAIxC,MAAM,oBAAoB,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAW,CAAA;AAWhF;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAqC;IAErC,qDAAqD;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAC/B,OAAO,UAAU,CAAC;QAChB,GAAG,OAAO;QACV,MAAM,EAAE;YACN,MAAM,EAAE,oBAAoB;YAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAkC;SAC7D;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,OAAO,MAAM,OAAO,CAAC,IAAI,EAAE,IAAI,CAA2B,CAAA;QAC5D,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/lib/tool-layer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * One scope's tool-registry contribution: visibility, reservations,
+ * restrictions, guards, and per-scope presentation shadowing.
+ * @module tool-layer
+ */
+import { AnonymousEntries, NamedEntries } from '@deepseek-ai/dsh-scope';
+import type { ScopeKey, ScopeLayer } from '@deepseek-ai/dsh-scope';
+import type { CompiledToolRestriction, ToolDefinition, ToolExecution, ToolGuard, PreToolDecision, ToolPresentationMode } from './tool-types.ts';
+/** One scope's complete tool-registry contribution. */
+export declare class ToolLayer implements ScopeLayer {
+    readonly tools: NamedEntries<ToolDefinition>;
+    /** Known-but-invisible capability names, so a scoped restriction can gate a tool before it loads. */
+    readonly reserved: NamedEntries<undefined>;
+    readonly restrictions: AnonymousEntries<CompiledToolRestriction>;
+    readonly guards: AnonymousEntries<ToolGuard>;
+    /**
+     * Presentation this scope's agent declared for itself, shadowing the
+     * deployment default. One cell rather than an entry table: two answers to
+     * "which form does the model see" is a contradiction, not a merge.
+     */
+    mode: ToolPresentationMode | undefined;
+    constructor(scope: ScopeKey | undefined);
+    /** Whether every contribution table in this aggregate layer is empty. */
+    isEmpty(): boolean;
+    /** Whether every compiled restriction in this layer admits a global tool name. */
+    admits(name: string): boolean;
+    /** First monotonic denial from this layer's live guard registrations. */
+    guardReason(exec: ToolExecution): string | undefined;
+}
+/** Approval decision plus whether the approval channel reported cancellation. */
+export interface ToolAskResolution {
+    readonly decision: Extract<PreToolDecision, {
+        kind: 'allow' | 'deny';
+    }>;
+    readonly approvalCancelled: boolean;
+}
+/** Caller cancellation and dispatch state kept outside the around-wrapper view. */
+export interface ToolCancellationState {
+    readonly callerSignal: AbortSignal;
+    bodyInvoked: boolean;
+}
+/** One dispatch-scoped fused signal plus listener cleanup after the body settles. */
+export interface FusedToolSignal {
+    readonly signal: AbortSignal;
+    dispose(): void;
+}
+/** Resolve the run_code overlap cap at the owning config boundary (direct construction bypasses the Loader schema). */
+export declare function resolveMaxParallelSubCalls(value: number | undefined): number;
+//# sourceMappingURL=tool-layer.d.ts.map

package/lib/tool-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-layer.d.ts","sourceRoot":"","sources":["../src/tool-layer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE/I,uDAAuD;AACvD,qBAAa,SAAU,YAAW,UAAU;IAC1C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC,CAAA;IAC5C,qGAAqG;IACrG,QAAQ,CAAC,QAAQ,0BAA0G;IAC3H,QAAQ,CAAC,YAAY,4CAAkD;IACvE,QAAQ,CAAC,MAAM,8BAAoC;IACnD;;;;OAIG;IACH,IAAI,EAAE,oBAAoB,GAAG,SAAS,CAAA;gBAE1B,KAAK,EAAE,QAAQ,GAAG,SAAS;IAMvC,yEAAyE;IACzE,OAAO,IAAI,OAAO;IAKlB,kFAAkF;IAClF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ7B,yEAAyE;IACzE,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS;CAOrD;AAED,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;KAAE,CAAC,CAAA;IACvE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;CACpC;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAA;IAClC,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,uHAAuH;AACvH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM5E"}