kiokuko-dsh 0.1.0

package/dist/dsh/standard-skill-provider.d.ts

@@ -0,0 +1,50 @@
+export declare const STANDARD_DSH_SKILL_PROVIDER = "kiokuko-standard";
+export declare const STANDARD_DSH_SKILL_RANK = 600;
+export interface DshSkillInvocationPolicy {
+    readonly modelInvocable: boolean;
+    readonly userInvocable: boolean;
+}
+export interface DshSkillCandidate {
+    readonly name: string;
+    readonly description: string;
+    readonly invocation: DshSkillInvocationPolicy;
+    readonly source: 'bundled';
+    readonly provider: string;
+    readonly rank: number;
+    readonly locator: {
+        readonly skillName: string;
+    };
+    readonly resourceBase: {
+        readonly kind: 'opaque';
+        readonly description: string;
+    };
+}
+export interface DshSkillDefinition extends DshSkillCandidate {
+    readonly content: string;
+}
+export interface DshSkillProvider {
+    readonly name: string;
+    list(options: {
+        readonly signal?: AbortSignal;
+    }): Promise<readonly DshSkillCandidate[] | {
+        readonly candidates: readonly DshSkillCandidate[];
+        readonly complete: true;
+    }>;
+    get(candidate: DshSkillCandidate, options: {
+        readonly signal?: AbortSignal;
+    }): Promise<DshSkillDefinition | undefined>;
+}
+/** Create a complete, read-only provider over the core standard Skill loader. */
+export declare function createStandardSkillProvider(): DshSkillProvider & {
+    dispose(): void;
+};
+export interface DshSkillContext {
+    readonly skills: {
+        registerProvider(create: (control: {
+            readonly signal: AbortSignal;
+        }) => DshSkillProvider): () => void;
+    };
+}
+/** Register the bundled provider; the caller owns the returned Cordis disposer. */
+export declare function mountStandardSkillProvider(ctx: DshSkillContext): () => void;
+//# sourceMappingURL=standard-skill-provider.d.ts.map

package/dist/dsh/standard-skill-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-skill-provider.d.ts","sourceRoot":"","sources":["../../src/dsh/standard-skill-provider.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,2BAA2B,qBAAqB,CAAA;AAC7D,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAA;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;CACjF;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,GAAG;QAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IACxK,GAAG,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAA;CACvH;AAwBD,iFAAiF;AACjF,wBAAgB,2BAA2B,IAAI,gBAAgB,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CA2BpF;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE;QAAE,gBAAgB,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;YAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;SAAE,KAAK,gBAAgB,GAAG,MAAM,IAAI,CAAA;KAAE,CAAA;CAC3H;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,IAAI,CAW3E"}

package/dist/dsh/standard-skill-provider.js

@@ -0,0 +1,71 @@
+import { loadStandardSkillParity, standardSkillFrontmatter } from './parity.js';
+export const STANDARD_DSH_SKILL_PROVIDER = 'kiokuko-standard';
+export const STANDARD_DSH_SKILL_RANK = 600;
+function abortIfRequested(signal) {
+    if (signal?.aborted)
+        throw signal.reason ?? new Error('Skill lookup aborted');
+}
+function candidates(parity) {
+    return parity.skills.map((skillName) => {
+        const primary = parity.files.find((file) => file.skillName === skillName && file.relativePath === 'SKILL.md');
+        const description = standardSkillFrontmatter(primary.content).description;
+        if (description === null || description.length === 0)
+            throw new Error(`Missing standard Skill description: ${skillName}`);
+        return {
+            name: skillName,
+            description,
+            invocation: { modelInvocable: true, userInvocable: true },
+            source: 'bundled',
+            provider: STANDARD_DSH_SKILL_PROVIDER,
+            rank: STANDARD_DSH_SKILL_RANK,
+            locator: { skillName },
+            resourceBase: { kind: 'opaque', description: 'Kiokuko package bundled standard Skill resources' },
+        };
+    });
+}
+/** Create a complete, read-only provider over the core standard Skill loader. */
+export function createStandardSkillProvider() {
+    let disposed = false;
+    let parityPromise;
+    const parity = () => parityPromise ??= loadStandardSkillParity();
+    const provider = {
+        name: STANDARD_DSH_SKILL_PROVIDER,
+        async list(options) {
+            abortIfRequested(options.signal);
+            if (disposed)
+                return { candidates: [], complete: true };
+            const result = { candidates: candidates(await parity()), complete: true };
+            abortIfRequested(options.signal);
+            return result;
+        },
+        async get(candidate, options) {
+            abortIfRequested(options.signal);
+            if (disposed || candidate.provider !== STANDARD_DSH_SKILL_PROVIDER || candidate.source !== 'bundled')
+                return undefined;
+            const result = await parity();
+            const file = result.files.find((item) => item.skillName === candidate.locator.skillName && item.relativePath === 'SKILL.md');
+            if (file === undefined || candidate.name !== file.skillName)
+                return undefined;
+            abortIfRequested(options.signal);
+            return { ...candidate, content: file.content };
+        },
+        dispose() {
+            disposed = true;
+        },
+    };
+    return provider;
+}
+/** Register the bundled provider; the caller owns the returned Cordis disposer. */
+export function mountStandardSkillProvider(ctx) {
+    let provider;
+    const unregister = ctx.skills.registerProvider((control) => {
+        provider = createStandardSkillProvider();
+        control.signal.addEventListener('abort', () => provider?.dispose(), { once: true });
+        return provider;
+    });
+    return () => {
+        provider?.dispose();
+        unregister();
+    };
+}
+//# sourceMappingURL=standard-skill-provider.js.map

package/dist/dsh/standard-skill-provider.js.map

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

package/dist/dsh/tool-policy.d.ts

@@ -0,0 +1,40 @@
+import type { EnnoNextAction } from '../enno-oduno/types.js';
+import { type DshToolExecution, type DshNativeToolExecution, type DshToolHostBinding } from './tools.js';
+export type DshToolPhase = 'intake' | 'ideal' | 'planning' | 'confirmation' | 'goki' | 'verifying' | 'meditation' | 'completed' | 'blocked' | 'cancelled';
+export interface DshToolPolicyState extends Omit<DshToolHostBinding, 'idempotencyKey'> {
+    readonly phase: DshToolPhase;
+    readonly currentWorkUnitId?: string;
+    readonly dshSessionId?: string;
+    readonly nextAction?: EnnoNextAction;
+}
+export type DshToolPolicyDenyCode = 'UNLOADED' | 'UNKNOWN_TOOL' | 'HOST_ONLY' | 'WRONG_PHASE' | 'WRONG_DIRECTIVE' | 'STALE_STATE' | 'LEASE_REQUIRED' | 'CANCELLED' | 'IDENTITY_INJECTION';
+export type DshToolPolicyDecision = {
+    readonly kind: 'allow';
+    readonly binding: DshToolHostBinding;
+} | {
+    readonly kind: 'deny';
+    readonly code: DshToolPolicyDenyCode;
+    readonly reason: string;
+};
+export interface DshToolPolicyContext {
+    readonly tools: {
+        guard(guard: (execution: DshToolExecution | DshNativeToolExecution) => string | undefined): () => void;
+    };
+    readonly on?: (name: 'tools/pre-execute', listener: (execution: DshToolExecution | DshNativeToolExecution, next: () => Promise<unknown>) => Promise<unknown>, options?: {
+        readonly prepend?: boolean;
+    }) => () => void;
+}
+/** Own the monotonic policy decision without granting authority to the caller. */
+export declare class DshToolPolicy {
+    #private;
+    constructor(state: DshToolPolicyState);
+    setState(state: DshToolPolicyState): void;
+    dispose(): void;
+    decide(execution: DshToolExecution): DshToolPolicyDecision;
+    guardReason(execution: DshToolExecution): string | undefined;
+}
+/** Install a final monotonic guard; later waterfall listeners cannot allow a denied call. */
+export declare function mountDshToolPolicy(ctx: DshToolPolicyContext, policy: DshToolPolicy): () => void;
+export declare function dshToolPhaseAllowlist(phase: DshToolPhase): readonly string[];
+export declare const DSH_TOOL_OPERATION_COUNT: number;
+//# sourceMappingURL=tool-policy.d.ts.map

package/dist/dsh/tool-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/dsh/tool-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EAGxB,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAAA;AAEzJ,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;IACpF,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAA;CACrC;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,aAAa,GAAG,gBAAgB,GAAG,WAAW,GAAG,oBAAoB,CAAA;AAEzL,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE;QACd,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,gBAAgB,GAAG,sBAAsB,KAAK,MAAM,GAAG,SAAS,GAAG,MAAM,IAAI,CAAA;KACvG,CAAA;IACD,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,gBAAgB,GAAG,sBAAsB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,IAAI,CAAA;CACtN;AA+BD,kFAAkF;AAClF,qBAAa,aAAa;;gBAIZ,KAAK,EAAE,kBAAkB;IAIrC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAKzC,OAAO,IAAI,IAAI;IAKf,MAAM,CAAC,SAAS,EAAE,gBAAgB,GAAG,qBAAqB;IAuC1D,WAAW,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS;CAI7D;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,oBAAoB,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,IAAI,CAa/F;AAeD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAE5E;AAED,eAAO,MAAM,wBAAwB,QAAuE,CAAA"}

package/dist/dsh/tool-policy.js

@@ -0,0 +1,125 @@
+import { KiokukoError } from '../errors.js';
+import { DSH_HOST_ONLY_OPERATIONS, DSH_MODEL_FACING_OPERATIONS, bindDshToolInvocation, isDshHostOnlyOperation, isDshModelFacingOperation, } from './tools.js';
+const phaseAllowlist = Object.freeze({
+    intake: [],
+    ideal: ['enno_ideal_submit'],
+    planning: ['enno_plan_submit'],
+    confirmation: [],
+    goki: ['enno_work_report', 'curator_check', 'memory_checkpoint'],
+    verifying: ['enno_finish', 'curator_check', 'memory_checkpoint'],
+    meditation: ['enno_meditation_submit'],
+    completed: [],
+    blocked: [],
+    cancelled: [],
+});
+const directiveOperation = Object.freeze({
+    submit_ideal: 'enno_ideal_submit',
+    submit_plan: 'enno_plan_submit',
+    execute_work_unit: 'enno_work_report',
+    submit_final_review: 'enno_finish',
+    submit_meditation: 'enno_meditation_submit',
+});
+function denied(code, reason) {
+    return { kind: 'deny', code, reason };
+}
+function publicReason(code) {
+    return `Kiokuko dsh tool denied (${code.toLowerCase()})`;
+}
+/** Own the monotonic policy decision without granting authority to the caller. */
+export class DshToolPolicy {
+    #state;
+    #disposed = false;
+    constructor(state) {
+        this.#state = Object.freeze({ ...state });
+    }
+    setState(state) {
+        if (this.#disposed)
+            throw new KiokukoError('SERVICE_UNAVAILABLE', 'dsh tool policy is disposed');
+        this.#state = Object.freeze({ ...state });
+    }
+    dispose() {
+        this.#disposed = true;
+        this.#state = undefined;
+    }
+    decide(execution) {
+        if (this.#disposed)
+            return denied('UNLOADED', publicReason('UNLOADED'));
+        const state = this.#state;
+        if (state === undefined)
+            return denied('UNLOADED', publicReason('UNLOADED'));
+        if (execution.signal.aborted)
+            return denied('CANCELLED', publicReason('CANCELLED'));
+        if (!isDshModelFacingOperation(execution.name) && !isDshHostOnlyOperation(execution.name)) {
+            return denied('UNKNOWN_TOOL', publicReason('UNKNOWN_TOOL'));
+        }
+        if (execution.origin !== 'host' && isDshHostOnlyOperation(execution.name)) {
+            return denied('HOST_ONLY', publicReason('HOST_ONLY'));
+        }
+        if (state.nextAction !== undefined && execution.origin !== 'host') {
+            const expected = directiveOperation[state.nextAction];
+            if (expected !== execution.name)
+                return denied('WRONG_DIRECTIVE', publicReason('WRONG_DIRECTIVE'));
+        }
+        if (!phaseAllowlist[state.phase].includes(execution.name)) {
+            return denied('WRONG_PHASE', publicReason('WRONG_PHASE'));
+        }
+        if (execution.name === 'enno_work_report'
+            && (state.currentWorkUnitId === undefined || state.workUnitId !== state.currentWorkUnitId || state.leaseToken === undefined)) {
+            return denied('LEASE_REQUIRED', publicReason('LEASE_REQUIRED'));
+        }
+        if (execution.agent !== undefined && state.dshSessionId !== undefined
+            && execution.agent.dshSessionId !== state.dshSessionId && execution.origin !== 'host') {
+            return denied('STALE_STATE', publicReason('STALE_STATE'));
+        }
+        try {
+            return { kind: 'allow', binding: bindDshToolInvocation(execution, state) };
+        }
+        catch (error) {
+            if (error instanceof KiokukoError && error.code === 'SECURITY_REJECTION') {
+                return denied('IDENTITY_INJECTION', publicReason('IDENTITY_INJECTION'));
+            }
+            if (error instanceof KiokukoError && error.code === 'CONFLICT') {
+                return denied('STALE_STATE', publicReason('STALE_STATE'));
+            }
+            throw error;
+        }
+    }
+    guardReason(execution) {
+        const decision = this.decide(execution);
+        return decision.kind === 'deny' ? decision.reason : undefined;
+    }
+}
+/** Install a final monotonic guard; later waterfall listeners cannot allow a denied call. */
+export function mountDshToolPolicy(ctx, policy) {
+    const guardDisposer = ctx.tools.guard((execution) => {
+        return policy.guardReason(normalizePolicyExecution(execution));
+    });
+    const preExecuteDisposer = ctx.on?.('tools/pre-execute', async (execution, next) => {
+        const decision = policy.decide(normalizePolicyExecution(execution));
+        if (decision.kind === 'deny')
+            return { kind: 'deny', reason: decision.reason };
+        return next();
+    }, { prepend: true });
+    return () => {
+        preExecuteDisposer?.();
+        guardDisposer();
+    };
+}
+function normalizePolicyExecution(execution) {
+    if (execution.agent === undefined || 'dshSessionId' in execution.agent)
+        return execution;
+    return {
+        callId: execution.callId,
+        ...(execution.rootCallId === undefined ? {} : { rootCallId: execution.rootCallId }),
+        name: execution.name,
+        arguments: execution.arguments,
+        agent: { dshSessionId: execution.agent.id, turn: 0 },
+        ...(execution.parent === undefined ? {} : { parent: execution.parent }),
+        signal: execution.signal,
+    };
+}
+export function dshToolPhaseAllowlist(phase) {
+    return phaseAllowlist[phase];
+}
+export const DSH_TOOL_OPERATION_COUNT = DSH_MODEL_FACING_OPERATIONS.length + DSH_HOST_ONLY_OPERATIONS.length;
+//# sourceMappingURL=tool-policy.js.map

package/dist/dsh/tool-policy.js.map

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

package/dist/dsh/tools.d.ts

@@ -0,0 +1,85 @@
+import { type ModelToolOperationName } from '../model-tools/contracts.js';
+import { type JsonSchema } from '../model-tools/registry.js';
+export declare const DSH_MODEL_FACING_OPERATIONS: readonly ["enno_plan_submit", "enno_ideal_submit", "enno_work_report", "enno_finish", "enno_meditation_submit", "curator_check", "memory_checkpoint"];
+export declare const DSH_HOST_ONLY_OPERATIONS: readonly ["task_prepare", "task_answer", "enno_advice_submit", "enno_advice_read", "enno_answer", "enno_verify_prepare", "curator_globalize"];
+export type DshModelFacingOperation = (typeof DSH_MODEL_FACING_OPERATIONS)[number];
+export type DshHostOnlyOperation = (typeof DSH_HOST_ONLY_OPERATIONS)[number];
+export interface DshToolExecution {
+    readonly callId: string;
+    readonly rootCallId?: string;
+    readonly name: string;
+    readonly arguments: unknown;
+    readonly agent?: {
+        readonly dshSessionId: string;
+        readonly turn: number;
+    };
+    readonly parent?: unknown;
+    readonly origin?: 'model' | 'host';
+    readonly signal: AbortSignal;
+}
+/**
+ * The execution shape supplied by dsh-tools.  This is intentionally a
+ * structural type: the plugin package must not take a hard dependency on a
+ * particular dsh package graph just to expose the bundle entrypoint.
+ */
+export interface DshNativeToolExecution {
+    readonly callId: string;
+    readonly rootCallId?: string;
+    readonly name: string;
+    readonly arguments: unknown;
+    readonly agent?: {
+        readonly id: string;
+    };
+    readonly parent?: unknown;
+    readonly signal: AbortSignal;
+}
+export interface DshToolHostBinding {
+    readonly runId: string;
+    readonly workspace: string;
+    readonly orchestrationId: string;
+    readonly revision: number;
+    readonly routeEpoch: number;
+    readonly leaseToken?: string;
+    readonly workUnitId?: string;
+    readonly idempotencyKey: string;
+}
+export interface DshToolDefinition {
+    readonly name: ModelToolOperationName;
+    readonly description: string;
+    readonly parameters: JsonSchema;
+    readonly modelFacing: boolean;
+    /** dsh-tools requires this output declaration for native registration. */
+    readonly output: {
+        readonly schema: JsonSchema;
+        readonly render: (args: unknown, value: unknown) => readonly {
+            readonly type: 'text';
+            readonly text: string;
+        }[];
+    };
+    readonly execute: (args: unknown, execution: DshToolExecution | DshNativeToolExecution) => Promise<unknown>;
+}
+export interface DshToolHost {
+    readonly bind: (execution: DshToolExecution) => Omit<DshToolHostBinding, 'idempotencyKey'>;
+    readonly execute: (operation: ModelToolOperationName, args: unknown, binding: DshToolHostBinding) => Promise<unknown>;
+}
+export interface DshToolRegistrationContext {
+    readonly tools: {
+        register(definition: DshToolDefinition): () => void;
+    };
+}
+/** Derive one stable idempotency key for a direct or nested dsh tool call. */
+export declare function dshToolIdempotencyKey(execution: Pick<DshToolExecution, 'callId' | 'rootCallId' | 'name' | 'agent'>): string;
+/** Bind host-owned identity after model arguments have crossed the boundary. */
+export declare function bindDshToolInvocation(execution: DshToolExecution, state: Omit<DshToolHostBinding, 'idempotencyKey'>): DshToolHostBinding;
+/** Build the exact operation set; only model-facing tools receive wire schemas. */
+export declare function createDshToolDefinitions(host: DshToolHost): readonly DshToolDefinition[];
+/** Register only tools that dsh may expose to the model. Host-only operations
+ * remain available to the explicit Kiokuko host adapter, never as model tools. */
+export declare function createDshModelToolDefinitions(host: DshToolHost): readonly DshToolDefinition[];
+/** Register all operations and return a reverse-order disposer. */
+export declare function mountDshTools(ctx: DshToolRegistrationContext, host: DshToolHost): () => void;
+/** Native dsh composition boundary: expose only model-facing operations. */
+export declare function mountDshModelTools(ctx: DshToolRegistrationContext, host: DshToolHost): () => void;
+export declare function isDshModelFacingOperation(name: string): name is DshModelFacingOperation;
+export declare function isDshHostOnlyOperation(name: string): name is DshHostOnlyOperation;
+//# sourceMappingURL=tools.d.ts.map

package/dist/dsh/tools.d.ts.map

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

package/dist/dsh/tools.js

@@ -0,0 +1,156 @@
+import { canonicalContentHash } from '../serialization/validate.js';
+import { MODEL_TOOL_OPERATION_NAMES } from '../model-tools/contracts.js';
+import { modelFacingInputSchema } from '../model-tools/registry.js';
+import { KiokukoError } from '../errors.js';
+export const DSH_MODEL_FACING_OPERATIONS = [
+    'enno_plan_submit',
+    'enno_ideal_submit',
+    'enno_work_report',
+    'enno_finish',
+    'enno_meditation_submit',
+    'curator_check',
+    'memory_checkpoint',
+];
+export const DSH_HOST_ONLY_OPERATIONS = [
+    'task_prepare',
+    'task_answer',
+    'enno_advice_submit',
+    'enno_advice_read',
+    'enno_answer',
+    'enno_verify_prepare',
+    'curator_globalize',
+];
+const modelFacingSet = new Set(DSH_MODEL_FACING_OPERATIONS);
+const hostOnlySet = new Set(DSH_HOST_ONLY_OPERATIONS);
+if (new Set([...DSH_MODEL_FACING_OPERATIONS, ...DSH_HOST_ONLY_OPERATIONS]).size !== MODEL_TOOL_OPERATION_NAMES.length) {
+    throw new Error('dsh tool ownership must cover the exact Kiokuko operation set once');
+}
+function normalizeExecution(execution) {
+    if (execution.agent === undefined || 'dshSessionId' in execution.agent)
+        return execution;
+    return {
+        callId: execution.callId,
+        ...(execution.rootCallId === undefined ? {} : { rootCallId: execution.rootCallId }),
+        name: execution.name,
+        arguments: execution.arguments,
+        agent: { dshSessionId: execution.agent.id, turn: 0 },
+        ...(execution.parent === undefined ? {} : { parent: execution.parent }),
+        signal: execution.signal,
+    };
+}
+function validCallId(callId) {
+    if (typeof callId !== 'string' || callId.length === 0 || callId.length > 256 || /[\p{Cc}]/u.test(callId)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'dsh tool call identity is invalid');
+    }
+    return callId;
+}
+function validOperation(name) {
+    if (typeof name !== 'string' || !MODEL_TOOL_OPERATION_NAMES.includes(name)) {
+        throw new KiokukoError('NOT_FOUND', 'dsh tool is not registered');
+    }
+    return name;
+}
+function ownKeys(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return [];
+    return Object.keys(value);
+}
+function containsHostIdentity(value, seen = new Set()) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (seen.has(value))
+        return true;
+    seen.add(value);
+    const forbidden = new Set(['runId', 'workspace', 'orchestrationId', 'resumeToken', 'expectedRevision', 'leaseToken', 'routeEpoch', 'idempotencyKey']);
+    if (ownKeys(value).some((key) => forbidden.has(key)))
+        return true;
+    return Array.isArray(value)
+        ? value.some((item) => containsHostIdentity(item, seen))
+        : Object.values(value).some((item) => containsHostIdentity(item, seen));
+}
+/** Derive one stable idempotency key for a direct or nested dsh tool call. */
+export function dshToolIdempotencyKey(execution) {
+    const callId = validCallId(execution.rootCallId ?? execution.callId);
+    if (execution.agent !== undefined) {
+        if (typeof execution.agent.dshSessionId !== 'string' || execution.agent.dshSessionId.length === 0
+            || !Number.isSafeInteger(execution.agent.turn) || execution.agent.turn < 0) {
+            throw new KiokukoError('VALIDATION_ERROR', 'dsh agent identity is invalid');
+        }
+    }
+    return `dsh-tool:${canonicalContentHash({
+        version: 1,
+        callId,
+        name: validOperation(execution.name),
+        agent: execution.agent === undefined ? null : execution.agent,
+    })}`;
+}
+/** Bind host-owned identity after model arguments have crossed the boundary. */
+export function bindDshToolInvocation(execution, state) {
+    const operation = validOperation(execution.name);
+    validCallId(execution.callId);
+    if (containsHostIdentity(execution.arguments)) {
+        throw new KiokukoError('SECURITY_REJECTION', 'dsh tool arguments contain host-owned identity');
+    }
+    if (typeof state.runId !== 'string' || state.runId.length === 0
+        || typeof state.workspace !== 'string' || state.workspace.length === 0
+        || typeof state.orchestrationId !== 'string' || state.orchestrationId.length === 0
+        || !Number.isSafeInteger(state.revision) || state.revision < 1
+        || !Number.isSafeInteger(state.routeEpoch) || state.routeEpoch < 0) {
+        throw new KiokukoError('VALIDATION_ERROR', 'dsh host binding is invalid');
+    }
+    if (operation === 'enno_work_report' && (state.workUnitId === undefined || state.leaseToken === undefined)) {
+        throw new KiokukoError('CONFLICT', 'dsh WorkUnit report requires the current host lease');
+    }
+    return Object.freeze({ ...state, idempotencyKey: dshToolIdempotencyKey(execution) });
+}
+function descriptionFor(operation) {
+    return `Kiokuko ${operation} semantic operation. Host identity, routing, lease, and idempotency fields are supplied by the dsh host.`;
+}
+/** Build the exact operation set; only model-facing tools receive wire schemas. */
+export function createDshToolDefinitions(host) {
+    return Object.freeze(MODEL_TOOL_OPERATION_NAMES.map((operation) => Object.freeze({
+        name: operation,
+        description: descriptionFor(operation),
+        parameters: modelFacingSet.has(operation) ? modelFacingInputSchema(operation) : Object.freeze({ type: 'object', properties: {}, additionalProperties: false }),
+        modelFacing: modelFacingSet.has(operation),
+        // `{}` is the dsh JSON-schema spelling for any lossless JSON value. The
+        // Kiokuko operation registry owns the input/output semantic schemas; this
+        // declaration only satisfies dsh's native tool registration contract.
+        output: {
+            schema: Object.freeze({}),
+            render: (_args, value) => Object.freeze([{
+                    type: 'text',
+                    text: typeof value === 'string' ? value : JSON.stringify(value),
+                }]),
+        },
+        execute: async (args, rawExecution) => {
+            const execution = normalizeExecution(rawExecution);
+            const binding = bindDshToolInvocation(execution, host.bind(execution));
+            return host.execute(operation, args, binding);
+        },
+    })));
+}
+/** Register only tools that dsh may expose to the model. Host-only operations
+ * remain available to the explicit Kiokuko host adapter, never as model tools. */
+export function createDshModelToolDefinitions(host) {
+    return Object.freeze(createDshToolDefinitions(host).filter((definition) => definition.modelFacing));
+}
+/** Register all operations and return a reverse-order disposer. */
+export function mountDshTools(ctx, host) {
+    const disposers = createDshToolDefinitions(host).map((definition) => ctx.tools.register(definition));
+    return () => { for (const dispose of disposers.reverse())
+        dispose(); };
+}
+/** Native dsh composition boundary: expose only model-facing operations. */
+export function mountDshModelTools(ctx, host) {
+    const disposers = createDshModelToolDefinitions(host).map((definition) => ctx.tools.register(definition));
+    return () => { for (const dispose of disposers.reverse())
+        dispose(); };
+}
+export function isDshModelFacingOperation(name) {
+    return modelFacingSet.has(name);
+}
+export function isDshHostOnlyOperation(name) {
+    return hostOnlySet.has(name);
+}
+//# sourceMappingURL=tools.js.map

package/dist/dsh/tools.js.map

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

package/dist/dsh/user-interaction.d.ts

@@ -0,0 +1,51 @@
+import type { AkinatorQuestion } from '../akinator/types.js';
+import type { UserFacingConfirmation, UserFacingConfirmationAction } from '../enno-oduno/types.js';
+import { type PlanStartRecovery } from '../enno-oduno/plan-recovery.js';
+export interface DshUserQuestionRequest {
+    readonly questions: readonly [
+        {
+            readonly id: string;
+            readonly question: string;
+            readonly detail?: string;
+            readonly header?: string;
+            readonly options?: readonly DshUserQuestionOption[];
+            readonly multiSelect?: boolean;
+            readonly intent?: string;
+        }
+    ];
+    readonly signal?: AbortSignal;
+}
+/** Native dsh-user-questions option shape. */
+export interface DshUserQuestionOption {
+    readonly label: string;
+    readonly description?: string;
+}
+export interface DshUserQuestionAnswer {
+    readonly answers: readonly [{
+        readonly id: string;
+        readonly selected: readonly string[];
+        readonly custom?: string;
+    }];
+}
+export interface DshUserQuestions {
+    ask(request: DshUserQuestionRequest): Promise<DshUserQuestionAnswer>;
+}
+export interface DshIntakeAnswerer {
+    ask(question: AkinatorQuestion, signal?: AbortSignal): Promise<string>;
+}
+export interface DshConfirmationAnswer {
+    readonly action: UserFacingConfirmationAction;
+    readonly requestedChanges?: string;
+}
+export interface DshConfirmationAnswerer {
+    ask(confirmation: UserFacingConfirmation, signal?: AbortSignal): Promise<DshConfirmationAnswer>;
+}
+/** Adapt the dsh user-question service to one exact Akinator question at a time. */
+export declare function createDshIntakeAnswerer(service: DshUserQuestions): DshIntakeAnswerer;
+/** Render only the public confirmation projection; internal directive fields never cross this boundary. */
+export declare function renderDshConfirmation(confirmation: UserFacingConfirmation): string;
+/** Keep plan-recovery choices user-facing and free of machine identity fields. */
+export declare function renderDshPlanRecovery(recovery: PlanStartRecovery): string;
+/** Adapt one explicit confirmation choice to dsh UserQuestions. */
+export declare function createDshConfirmationAnswerer(service: DshUserQuestions): DshConfirmationAnswerer;
+//# sourceMappingURL=user-interaction.d.ts.map

package/dist/dsh/user-interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-interaction.d.ts","sourceRoot":"","sources":["../../src/dsh/user-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAClG,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEhG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS;QAAC;YAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;YACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;YACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;YACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;YACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAA;YACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;YAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SACzB;KAAC,CAAA;IACF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrH;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;CACrE;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAA;IAC7C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,YAAY,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;CAChG;AAMD,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAkBpF;AA6BD,2GAA2G;AAC3G,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,sBAAsB,GAAG,MAAM,CAElF;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAEzE;AAED,mEAAmE;AACnE,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,gBAAgB,GAAG,uBAAuB,CAwBhG"}