kiokuko-dsh 0.1.0

package/dist/dsh/commands.js

@@ -0,0 +1,83 @@
+import { KiokukoError } from '../errors.js';
+export const PONYTAIL_MODES = ['lite', 'full', 'ultra'];
+function parseMode(args) {
+    if (args.length !== 1 || !PONYTAIL_MODES.includes(args[0])) {
+        throw new KiokukoError('VALIDATION_ERROR', 'ponytail requires exactly one mode: lite, full, or ultra');
+    }
+    return args[0];
+}
+/** Own request-local Ponytail state; it never changes global configuration. */
+export class DshPonytailModes {
+    #activeRequestId;
+    #mode;
+    begin(requestId) {
+        if (requestId.length === 0 || requestId.length > 256 || /[\p{Cc}]/u.test(requestId))
+            throw new KiokukoError('VALIDATION_ERROR', 'requestId is invalid');
+        if (this.#activeRequestId !== undefined && this.#activeRequestId !== requestId)
+            throw new KiokukoError('CONFLICT', 'another logical request is already active');
+        this.#activeRequestId = requestId;
+        this.#mode = undefined;
+    }
+    isActive(requestId) {
+        return this.#activeRequestId === requestId;
+    }
+    set(requestId, mode) {
+        if (this.#activeRequestId !== requestId)
+            throw new KiokukoError('CONFLICT', 'ponytail is available only for the active logical request');
+        if (!PONYTAIL_MODES.includes(mode))
+            throw new KiokukoError('VALIDATION_ERROR', 'Unknown ponytail mode');
+        this.#mode = mode;
+        return mode;
+    }
+    execute(args) {
+        if (this.#activeRequestId === undefined)
+            throw new KiokukoError('CONFLICT', 'ponytail is available only for the active logical request');
+        const mode = this.set(this.#activeRequestId, parseMode(args));
+        return `Ponytail mode set to ${mode} for the active request.`;
+    }
+    mode(requestId) {
+        return this.#activeRequestId === requestId ? this.#mode : undefined;
+    }
+    end(requestId) {
+        if (this.#activeRequestId !== requestId)
+            return false;
+        this.#activeRequestId = undefined;
+        this.#mode = undefined;
+        return true;
+    }
+    dispose() {
+        this.#activeRequestId = undefined;
+        this.#mode = undefined;
+    }
+}
+export function mountDshPonytailCommand(ctx, modes) {
+    // Cordis test doubles and early dsh adapters used the two-argument helper;
+    // dsh-commands uses one immutable definition object. Supporting both keeps
+    // the domain command independent from the host package version while making
+    // the native registration the default for the real harness.
+    if (ctx.commands.register.length >= 2) {
+        return ctx.commands.register('ponytail', (args) => modes.execute(args));
+    }
+    return ctx.commands.register({
+        name: 'ponytail',
+        description: 'Set the active Kiokuko request mode: lite, full, or ultra.',
+        input: { hint: 'lite | full | ultra' },
+        recordInput: true,
+        handler: (invocation) => {
+            try {
+                const args = invocation.rawInput.trim().length === 0 ? [] : invocation.rawInput.trim().split(/\s+/u);
+                return { kind: 'success', text: modes.execute(args) };
+            }
+            catch (error) {
+                return { kind: 'error', text: error instanceof Error ? error.message : 'Invalid Ponytail command.' };
+            }
+        },
+    });
+}
+/** Bind the command handler to one active request without leaking that request identity into the command text. */
+export function executeDshPonytailCommand(modes, requestId, args) {
+    if (!modes.isActive(requestId))
+        throw new KiokukoError('CONFLICT', 'ponytail is available only for the active logical request');
+    return modes.execute(args);
+}
+//# sourceMappingURL=commands.js.map

package/dist/dsh/commands.js.map

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

package/dist/dsh/composition.d.ts

@@ -0,0 +1,64 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { DshEnnoController } from './enno-controller.js';
+import { DshIntakeGate, type DshPreStepEvent } from './intake-gate.js';
+import { type DshRunLifecycle, type DshSessionBridge, type DshSessionRunResolver } from './session-bridge.js';
+import { type DshToolPolicy } from './tool-policy.js';
+import { type DshToolHost, type DshToolRegistrationContext } from './tools.js';
+import { DshPonytailModes, type DshPonytailCommandContext } from './commands.js';
+import { type DshSkillContext } from './standard-skill-provider.js';
+import { mountSoulPrompt } from './prompt-policy.js';
+import type { DshUserQuestions } from './user-interaction.js';
+import type { DshRuntime } from './runtime.js';
+/** The optional, explicit host adapter supplied by a dsh profile. */
+export declare const KIOKUKO_DSH_HOST_SERVICE = "kiokukoDsh";
+export interface DshNativePreStepPayload {
+    readonly agent: {
+        readonly id: string;
+    };
+    readonly messages: readonly unknown[];
+    readonly turn: number;
+    readonly step: number;
+    readonly signal: AbortSignal;
+}
+export interface DshNativeTurnStoppingPayload {
+    readonly agent: {
+        readonly id: string;
+        readonly steer: (message: unknown) => void;
+        readonly cancel?: (reason: unknown) => void;
+    };
+    readonly turn: number;
+    readonly signal: AbortSignal;
+}
+export interface DshCompositionHost {
+    readonly skills?: DshSkillContext['skills'];
+    readonly systemPrompt?: Parameters<typeof mountSoulPrompt>[0]['systemPrompt'];
+    readonly runtime?: DshRuntime;
+    readonly userQuestions?: DshUserQuestions;
+    readonly commands?: DshPonytailCommandContext['commands'];
+    readonly ponytailModes?: DshPonytailModes;
+    readonly tools?: {
+        register: DshToolHostRegistration;
+        guard: (guard: (execution: any) => string | undefined) => () => void;
+    };
+    readonly toolHost?: DshToolHost;
+    readonly toolPolicy?: DshToolPolicy;
+    readonly intakeGate?: DshIntakeGate;
+    readonly mapPreStep?: (payload: DshNativePreStepPayload) => DshPreStepEvent;
+    readonly bridge?: DshSessionBridge;
+    readonly resolveSessionRunId?: DshSessionRunResolver;
+    readonly ennoController?: DshEnnoController;
+    readonly lifecycle?: DshRunLifecycle;
+    readonly resolveIdleClose?: (agentId: string) => {
+        readonly runId: string;
+        readonly status: 'completed' | 'failed' | 'cancelled';
+    } | undefined;
+}
+type DshToolHostRegistration = DshToolRegistrationContext['tools']['register'];
+/**
+ * Mount every seam for which the profile supplied a real host adapter. The
+ * adapter is deliberately explicit: a generic Cordis context cannot invent a
+ * repository/run binding or an intake task projection safely.
+ */
+export declare function mountDshComposition(ctx: Context, host: DshCompositionHost): () => void;
+export {};
+//# sourceMappingURL=composition.d.ts.map

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

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

package/dist/dsh/composition.js

@@ -0,0 +1,104 @@
+import { mountDshDurabilityBarriers, mountDshIdleLifecycle, mountDshSessionBridge } from './session-bridge.js';
+import { mountDshToolPolicy } from './tool-policy.js';
+import { mountDshModelTools } from './tools.js';
+import { DshPonytailModes, mountDshPonytailCommand } from './commands.js';
+import { mountStandardSkillProvider } from './standard-skill-provider.js';
+import { mountSoulPrompt } from './prompt-policy.js';
+/** The optional, explicit host adapter supplied by a dsh profile. */
+export const KIOKUKO_DSH_HOST_SERVICE = 'kiokukoDsh';
+/** Native registration is structurally compatible with dsh-tools' ToolRuntime. */
+function toolRegistration(host) {
+    return host.tools === undefined ? undefined : { register: host.tools.register };
+}
+function mountRuntime(ctx, runtime) {
+    let closed = false;
+    ctx.effect(() => {
+        const started = runtime.start();
+        return async () => {
+            if (closed)
+                return;
+            closed = true;
+            await started.catch(() => undefined);
+            await runtime.close();
+        };
+    }, 'kiokuko-dsh runtime');
+    return () => { if (!closed)
+        void runtime.close(); };
+}
+function mountNativeIntakeGate(ctx, gate, mapPreStep) {
+    return ctx.on('agent/pre-step', (payload, next) => gate.preStep(mapPreStep(payload), next), { prepend: true });
+}
+function mountNativeEnnoController(ctx, controller) {
+    return ctx.on('agent/turn-stopping', async (payload) => {
+        const agent = {
+            id: payload.agent.id,
+            steer: (message) => payload.agent.steer({
+                id: `kiokuko-dsh:${payload.agent.id}:${payload.turn}`,
+                role: 'user',
+                content: [{ type: 'text', text: message.content }],
+                source: { kind: 'plugin', plugin: 'kiokuko-dsh', form: 'instructions' },
+            }),
+            ...(payload.agent.cancel === undefined ? {} : { cancel: (reason) => payload.agent.cancel(reason) }),
+        };
+        await controller.handle({ agent, turn: payload.turn, signal: payload.signal });
+    }, { prepend: true });
+}
+/**
+ * Mount every seam for which the profile supplied a real host adapter. The
+ * adapter is deliberately explicit: a generic Cordis context cannot invent a
+ * repository/run binding or an intake task projection safely.
+ */
+export function mountDshComposition(ctx, host) {
+    const disposers = [];
+    if (host.runtime !== undefined)
+        disposers.push(mountRuntime(ctx, host.runtime));
+    if (host.skills !== undefined)
+        disposers.push(mountStandardSkillProvider({ skills: host.skills }));
+    if (host.systemPrompt !== undefined) {
+        const disposer = mountSoulPrompt({ systemPrompt: host.systemPrompt, effect: ctx.effect });
+        if (typeof disposer === 'function')
+            disposers.push(() => disposer());
+    }
+    if (host.commands !== undefined)
+        disposers.push(mountDshPonytailCommand({ commands: host.commands }, host.ponytailModes ?? new DshPonytailModes()));
+    const registration = toolRegistration(host);
+    if ((registration === undefined) !== (host.toolHost === undefined)) {
+        if (host.toolPolicy === undefined)
+            throw new Error('kiokuko-dsh requires a tool policy whenever native tools are mounted');
+        if (registration === undefined || host.toolHost === undefined)
+            throw new Error('kiokuko-dsh native tool host is incomplete');
+    }
+    if (registration !== undefined && host.toolHost !== undefined) {
+        if (host.toolPolicy === undefined)
+            throw new Error('kiokuko-dsh requires a monotonic tool policy');
+        const tools = host.tools;
+        if (tools === undefined)
+            throw new Error('kiokuko-dsh native tool registry is incomplete');
+        disposers.push(mountDshToolPolicy({
+            tools: { guard: tools.guard },
+            on: (name, listener, options) => ctx.on(name, listener, options),
+        }, host.toolPolicy));
+        disposers.push(mountDshModelTools({ tools: registration }, host.toolHost));
+    }
+    if (host.intakeGate !== undefined) {
+        if (host.mapPreStep === undefined)
+            throw new Error('kiokuko-dsh intake gate requires a native task projection');
+        disposers.push(mountNativeIntakeGate(ctx, host.intakeGate, host.mapPreStep));
+    }
+    if (host.bridge !== undefined) {
+        if (host.resolveSessionRunId === undefined)
+            throw new Error('kiokuko-dsh session bridge requires a run resolver');
+        disposers.push(mountDshSessionBridge(ctx, host.bridge, host.resolveSessionRunId));
+        disposers.push(mountDshDurabilityBarriers(ctx, host.bridge));
+    }
+    if (host.ennoController !== undefined)
+        disposers.push(mountNativeEnnoController(ctx, host.ennoController));
+    if (host.lifecycle !== undefined) {
+        if (host.resolveIdleClose === undefined)
+            throw new Error('kiokuko-dsh idle lifecycle requires a close resolver');
+        disposers.push(mountDshIdleLifecycle(ctx, host.lifecycle, host.resolveIdleClose));
+    }
+    return () => { for (const dispose of disposers.reverse())
+        void dispose(); };
+}
+//# sourceMappingURL=composition.js.map

package/dist/dsh/composition.js.map

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

package/dist/dsh/config.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+/** Runtime configuration accepted by the dsh bundle entrypoint. */
+export declare const Config: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof Config>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/dsh/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,mEAAmE;AACnE,eAAO,MAAM,MAAM;;iBAEjB,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAA"}

package/dist/dsh/config.js

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+/** Runtime configuration accepted by the dsh bundle entrypoint. */
+export const Config = z.object({
+    enabled: z.boolean().default(true),
+});
+//# sourceMappingURL=config.js.map

package/dist/dsh/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/dsh/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,mEAAmE;AACnE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACnC,CAAC,CAAA"}

package/dist/dsh/context-injection.d.ts

@@ -0,0 +1,24 @@
+import type { PreparedAgentTask } from '../akinator/agent-task.js';
+import type { DshRuntime } from './runtime.js';
+import type { DshExpertReference, DshMessageSource } from './message-sources.js';
+import type { RoleDirective } from '../enno-oduno/types.js';
+export interface DshModelMessage {
+    readonly role: 'system' | 'user';
+    readonly content: string;
+    readonly source: DshMessageSource['kind'];
+}
+export interface DshDirectiveSourceSelection {
+    readonly routeSkillNames: readonly string[];
+    readonly expertRefs: readonly DshExpertReference[];
+}
+/** Project only the current role directive's required skills and selected experts. */
+export declare function selectDshDirectiveSources(directive: Pick<RoleDirective, 'requiredSkills' | 'workUnit'>): DshDirectiveSourceSelection;
+/** Compose the fixed source ordering into dsh-compatible model messages. */
+export declare function injectDshContext(input: {
+    readonly prepared: PreparedAgentTask;
+    readonly task: string;
+    readonly routeSkillNames?: readonly string[];
+    readonly expertRefs?: readonly DshExpertReference[];
+    readonly runtime?: Pick<DshRuntime, 'withDatabase'>;
+}): Promise<readonly DshModelMessage[]>;
+//# sourceMappingURL=context-injection.d.ts.map

package/dist/dsh/context-injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-injection.d.ts","sourceRoot":"","sources":["../../src/dsh/context-injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAGlE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAyB,MAAM,sBAAsB,CAAA;AAEvG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAQ3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACnD;AAOD,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,UAAU,CAAC,GAAG,2BAA2B,CAWpI;AAgBD,4EAA4E;AAC5E,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;CACpD,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAqBtC"}

package/dist/dsh/context-injection.js

@@ -0,0 +1,61 @@
+import { readEntry } from '../memory/entries.js';
+import { isRetrievableEntry } from '../memory/hybrid-retrieval.js';
+import { buildDshMessageSources } from './message-sources.js';
+import { STANDARD_FUNCTION_EXPERT_FILES, STANDARD_FUNCTION_EXPERT_IDS, STANDARD_UI_EXPERT_FILES, STANDARD_UI_EXPERT_IDS, } from '../setup/standard-skills.js';
+const expertFilesById = new Map([
+    ...STANDARD_FUNCTION_EXPERT_IDS.map((id, index) => [id, STANDARD_FUNCTION_EXPERT_FILES[index]]),
+    ...STANDARD_UI_EXPERT_IDS.map((id, index) => [id, STANDARD_UI_EXPERT_FILES[index]]),
+]);
+/** Project only the current role directive's required skills and selected experts. */
+export function selectDshDirectiveSources(directive) {
+    const expertRefs = (directive.workUnit?.expertRefs ?? []).map((reference) => {
+        const relativePath = expertFilesById.get(reference.id);
+        if (relativePath === undefined)
+            throw new Error(`No bundled dsh expert mapping exists for ${reference.id}`);
+        const skillName = reference.id.startsWith('ui.') ? 'kiokuko-ui-design-soul' : 'kiokuko-single-purpose-functions';
+        return { skillName, relativePath };
+    });
+    return Object.freeze({
+        routeSkillNames: Object.freeze([...new Set(directive.requiredSkills)]),
+        expertRefs: Object.freeze(expertRefs),
+    });
+}
+function sourceInput(prepared, routeSkillNames, expertRefs) {
+    if (prepared.intake.status !== 'ready' && prepared.intake.status !== 'exhausted')
+        throw new Error('Cannot inject context before intake is finalized');
+    if (prepared.nextAction !== 'proceed')
+        throw new Error('Cannot inject context when the host gate did not permit proceeding');
+    return {
+        task: prepared.intake.profile.target === null ? prepared.intake.profile.expected ?? '' : prepared.intake.profile.target,
+        intakeStatus: prepared.intake.status,
+        nextAction: 'proceed',
+        memoryPolicy: prepared.memoryPolicy,
+        context: prepared.context,
+        routeSkillNames,
+        expertRefs,
+    };
+}
+/** Compose the fixed source ordering into dsh-compatible model messages. */
+export async function injectDshContext(input) {
+    const assertMemoryCurrent = input.runtime === undefined || input.prepared.context === null
+        ? undefined
+        : async (item) => {
+            await input.runtime.withDatabase((database) => {
+                const entry = readEntry(database, { workspace: input.prepared.project.workspace, entryId: item.entryId });
+                if (entry.revision !== item.revision || !isRetrievableEntry(database, entry) || entry.status === 'superseded') {
+                    throw new Error('Scoped memory changed or is no longer retrievable');
+                }
+            });
+        };
+    const sources = await buildDshMessageSources({
+        ...sourceInput(input.prepared, input.routeSkillNames ?? [], input.expertRefs ?? []),
+        task: input.task,
+        ...(assertMemoryCurrent === undefined ? {} : { assertMemoryCurrent }),
+    });
+    return Object.freeze(sources.map((source) => Object.freeze({
+        role: source.kind === 'user-task' ? 'user' : 'system',
+        content: source.text,
+        source: source.kind,
+    })));
+}
+//# sourceMappingURL=context-injection.js.map

package/dist/dsh/context-injection.js.map

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

package/dist/dsh/enno-controller.d.ts

@@ -0,0 +1,94 @@
+import type { EnnoNextAction, EnnoOdunoState } from '../enno-oduno/types.js';
+import { type DshDirectiveSourceSelection } from './context-injection.js';
+import type { UserFacingConfirmation } from '../enno-oduno/types.js';
+import type { DshConfirmationAnswer, DshConfirmationAnswerer } from './user-interaction.js';
+import type { DshAdvisoryRoundResult, DshAdvisoryRunner } from './advisory-runner.js';
+export interface DshTurnStoppingAgent {
+    readonly id: string;
+    steer(message: DshContinuationMessage): void;
+    cancel?(reason: string): void;
+}
+export interface DshTurnStoppingEvent {
+    readonly agent: DshTurnStoppingAgent;
+    readonly turn: number;
+    readonly signal: AbortSignal;
+}
+export interface DshContinuationMessage {
+    readonly content: string;
+    readonly source: 'kiokuko-dsh';
+}
+export interface DshEnnoControllerDependencies {
+    readonly readState: (event: DshTurnStoppingEvent) => Promise<EnnoOdunoState | null>;
+    readonly injectNextStepContext?: (input: {
+        readonly event: DshTurnStoppingEvent;
+        readonly selection: DshDirectiveSourceSelection;
+    }) => void | PromiseLike<void>;
+    readonly maxSteersPerDirective?: number;
+    readonly advisoryRunner?: DshAdvisoryRunner;
+    readonly submitAdvisory?: (result: DshAdvisoryRoundResult) => void | PromiseLike<void>;
+    readonly runFinalVerification?: (input: {
+        readonly event: DshTurnStoppingEvent;
+        readonly state: EnnoOdunoState;
+    }) => void | PromiseLike<void>;
+}
+export interface DshConfirmationControllerDependencies {
+    readonly answerer?: DshConfirmationAnswerer;
+    readonly submit: (input: {
+        readonly action: DshConfirmationAnswer['action'];
+        readonly requestedChanges?: string;
+        readonly expectedRevision: number;
+    }) => void | PromiseLike<void>;
+    readonly readRevision: () => number | PromiseLike<number>;
+}
+export type DshConfirmationDecision = {
+    readonly kind: 'submitted';
+    readonly answer: DshConfirmationAnswer;
+} | {
+    readonly kind: 'blocked';
+    readonly reason: 'answerer_unavailable' | 'stale_revision' | 'aborted';
+};
+export type DshEnnoNextActionHandler = {
+    readonly kind: 'pending';
+    readonly requiresDirective: true;
+} | {
+    readonly kind: 'terminal';
+    readonly requiresDirective: false;
+};
+/** Exhaustive policy table: every core Enno next action has exactly one dsh owner. */
+export declare const DSH_ENNO_NEXT_ACTION_HANDLERS: Readonly<Record<EnnoNextAction, DshEnnoNextActionHandler>>;
+/** Execute confirmation only after a public answer and a fresh revision check. */
+export declare class DshConfirmationController {
+    #private;
+    constructor(dependencies: DshConfirmationControllerDependencies);
+    confirm(input: {
+        readonly confirmation: UserFacingConfirmation;
+        readonly expectedRevision: number;
+        readonly signal?: AbortSignal;
+    }): Promise<DshConfirmationDecision>;
+}
+export type DshTurnStoppingDecision = {
+    readonly kind: 'close';
+    readonly nextAction: EnnoNextAction;
+} | {
+    readonly kind: 'steer';
+    readonly nextAction: EnnoNextAction;
+    readonly selection: DshDirectiveSourceSelection;
+} | {
+    readonly kind: 'abort';
+    readonly reason: 'aborted' | 'state_unavailable' | 'directive_missing' | 'stale_directive' | 'continuation_limit' | 'verification_failed' | 'context_injection_failed';
+};
+/** Own the awaited turn boundary and never convert an Enno error into a normal close. */
+export declare class DshEnnoController {
+    #private;
+    constructor(dependencies: DshEnnoControllerDependencies);
+    turnStopping(event: DshTurnStoppingEvent): Promise<DshTurnStoppingDecision>;
+    handle(event: DshTurnStoppingEvent): Promise<DshTurnStoppingDecision>;
+    dispose(): void;
+}
+export interface DshTurnStoppingContext {
+    on(name: 'agent/turn-stopping', listener: (event: DshTurnStoppingEvent) => Promise<void>, options?: {
+        readonly prepend?: boolean;
+    }): () => void;
+}
+export declare function mountDshEnnoController(ctx: DshTurnStoppingContext, controller: DshEnnoController): () => void;
+//# sourceMappingURL=enno-controller.d.ts.map

package/dist/dsh/enno-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enno-controller.d.ts","sourceRoot":"","sources":["../../src/dsh/enno-controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC3F,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAErF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC5C,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IACnF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE;QACvC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;QACpC,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAA;KAChD,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAC9B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IACtF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;KAAE,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;CAC9I;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IACjL,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;CAC1D;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,SAAS,CAAA;CAAE,CAAA;AAExG,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAA;CAAE,CAAA;AAEpE,sFAAsF;AACtF,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAWnG,CAAA;AAEF,kFAAkF;AAClF,qBAAa,yBAAyB;;gBAGxB,YAAY,EAAE,qCAAqC;IAIzD,OAAO,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;QAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAa5K;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAA;CAAE,GAChH;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,0BAA0B,CAAA;CAAE,CAAA;AAetM,yFAAyF;AACzF,qBAAa,iBAAiB;;gBAShB,YAAY,EAAE,6BAA6B;IAYjD,YAAY,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2C3E,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAQ3E,OAAO,IAAI,IAAI;CAGhB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,IAAI,CAAA;CAChJ;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,sBAAsB,EAAE,UAAU,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAE7G"}

package/dist/dsh/enno-controller.js

@@ -0,0 +1,137 @@
+import { canonicalContentHash } from '../serialization/validate.js';
+import { selectDshDirectiveSources, } from './context-injection.js';
+/** Exhaustive policy table: every core Enno next action has exactly one dsh owner. */
+export const DSH_ENNO_NEXT_ACTION_HANDLERS = Object.freeze({
+    answer_intake: { kind: 'pending', requiresDirective: true },
+    submit_ideal: { kind: 'pending', requiresDirective: true },
+    submit_plan: { kind: 'pending', requiresDirective: true },
+    ask_user_confirmation: { kind: 'pending', requiresDirective: true },
+    execute_work_unit: { kind: 'pending', requiresDirective: true },
+    run_final_verification: { kind: 'pending', requiresDirective: true },
+    submit_final_review: { kind: 'pending', requiresDirective: true },
+    submit_meditation: { kind: 'pending', requiresDirective: true },
+    report_blocker: { kind: 'terminal', requiresDirective: false },
+    complete: { kind: 'terminal', requiresDirective: false },
+});
+/** Execute confirmation only after a public answer and a fresh revision check. */
+export class DshConfirmationController {
+    #dependencies;
+    constructor(dependencies) {
+        this.#dependencies = dependencies;
+    }
+    async confirm(input) {
+        if (input.signal?.aborted)
+            return { kind: 'blocked', reason: 'aborted' };
+        if (this.#dependencies.answerer === undefined)
+            return { kind: 'blocked', reason: 'answerer_unavailable' };
+        const answer = await this.#dependencies.answerer.ask(input.confirmation, input.signal);
+        if (input.signal?.aborted)
+            return { kind: 'blocked', reason: 'aborted' };
+        if (await this.#dependencies.readRevision() !== input.expectedRevision)
+            return { kind: 'blocked', reason: 'stale_revision' };
+        await this.#dependencies.submit({
+            action: answer.action,
+            expectedRevision: input.expectedRevision,
+            ...(answer.requestedChanges === undefined ? {} : { requestedChanges: answer.requestedChanges }),
+        });
+        return { kind: 'submitted', answer };
+    }
+}
+const continuationText = 'Kiokuko の現在の処理は未完了です。提示された現在の指示に従って次の処理を実行し、完了を先取りしないでください。';
+function directiveKey(event, state) {
+    return canonicalContentHash({
+        agentId: event.agent.id,
+        turn: event.turn,
+        nextAction: state.nextAction,
+        directive: state.directive,
+        contractRevision: state.contractRevision,
+        routeEpoch: state.routeEpoch,
+    });
+}
+/** Own the awaited turn boundary and never convert an Enno error into a normal close. */
+export class DshEnnoController {
+    #readState;
+    #injectNextStepContext;
+    #maxSteersPerDirective;
+    #advisoryRunner;
+    #submitAdvisory;
+    #runFinalVerification;
+    #steers = new Map();
+    constructor(dependencies) {
+        this.#readState = dependencies.readState;
+        this.#injectNextStepContext = dependencies.injectNextStepContext ?? (() => undefined);
+        this.#maxSteersPerDirective = dependencies.maxSteersPerDirective ?? 1;
+        this.#advisoryRunner = dependencies.advisoryRunner;
+        this.#submitAdvisory = dependencies.submitAdvisory;
+        this.#runFinalVerification = dependencies.runFinalVerification;
+        if (!Number.isSafeInteger(this.#maxSteersPerDirective) || this.#maxSteersPerDirective < 1 || this.#maxSteersPerDirective > 8) {
+            throw new Error('maxSteersPerDirective must be between 1 and 8');
+        }
+    }
+    async turnStopping(event) {
+        if (event.signal.aborted)
+            return { kind: 'abort', reason: 'aborted' };
+        let state;
+        try {
+            state = await this.#readState(event);
+        }
+        catch {
+            return { kind: 'abort', reason: 'state_unavailable' };
+        }
+        if (state === null || !state.applicable)
+            return { kind: 'close', nextAction: 'complete' };
+        const handler = DSH_ENNO_NEXT_ACTION_HANDLERS[state.nextAction];
+        if (handler.kind === 'terminal')
+            return { kind: 'close', nextAction: state.nextAction };
+        if (state.directive === null)
+            return { kind: 'abort', reason: 'directive_missing' };
+        if ((state.contractRevision !== null && state.directive.contractRevision !== state.contractRevision)
+            || (state.routeEpoch !== null && state.directive.routeEpoch !== state.routeEpoch)) {
+            return { kind: 'abort', reason: 'stale_directive' };
+        }
+        const key = directiveKey(event, state);
+        const used = this.#steers.get(key) ?? 0;
+        if (used >= this.#maxSteersPerDirective)
+            return { kind: 'abort', reason: 'continuation_limit' };
+        const selection = selectDshDirectiveSources(state.directive);
+        if (state.nextAction === 'run_final_verification') {
+            if (this.#runFinalVerification === undefined)
+                return { kind: 'abort', reason: 'state_unavailable' };
+            try {
+                await this.#runFinalVerification({ event, state });
+            }
+            catch {
+                return { kind: 'abort', reason: 'verification_failed' };
+            }
+        }
+        try {
+            if (state.directive.advisoryRound !== undefined) {
+                if (this.#advisoryRunner === undefined || this.#submitAdvisory === undefined)
+                    return { kind: 'abort', reason: 'state_unavailable' };
+                const advisory = await this.#advisoryRunner.run({ directive: state.directive.advisoryRound, signal: event.signal });
+                await this.#submitAdvisory(advisory);
+            }
+            await this.#injectNextStepContext({ event, selection });
+        }
+        catch {
+            return { kind: 'abort', reason: 'context_injection_failed' };
+        }
+        this.#steers.set(key, used + 1);
+        event.agent.steer({ content: continuationText, source: 'kiokuko-dsh' });
+        return { kind: 'steer', nextAction: state.nextAction, selection };
+    }
+    async handle(event) {
+        const decision = await this.turnStopping(event);
+        if (decision.kind === 'abort' && decision.reason !== 'aborted') {
+            event.agent.cancel?.(`kiokuko dsh Enno continuation stopped: ${decision.reason}`);
+        }
+        return decision;
+    }
+    dispose() {
+        this.#steers.clear();
+    }
+}
+export function mountDshEnnoController(ctx, controller) {
+    return ctx.on('agent/turn-stopping', async (event) => { await controller.handle(event); }, { prepend: true });
+}
+//# sourceMappingURL=enno-controller.js.map