@moxxy/core 0.3.0

package/dist/registries/transcribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribers.d.ts","sourceRoot":"","sources":["../../src/registries/transcribers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,SAAQ,qBAAqB,CAAC,cAAc,EAAE,WAAW,CAAC;;CAI1F"}

package/dist/registries/transcribers.js

@@ -0,0 +1,18 @@
+import { ActiveBackendRegistry } from './active-backend-registry.js';
+/**
+ * Registry of speech-to-text backends:
+ *   - plugins call `register(def)` at load time
+ *   - the host/CLI calls `setActive(name, config)` once a backend is chosen
+ *   - channels with audio input read `getActive()` to transcribe bytes
+ *
+ * At most one transcriber is *active* at a time, selected explicitly (no
+ * auto-adopt). `getActive()` throws when none is active, so call sites can
+ * degrade gracefully (e.g. Telegram falls back to "you sent a voice note but no
+ * transcriber is configured").
+ */
+export class TranscriberRegistry extends ActiveBackendRegistry {
+    constructor() {
+        super({ noun: 'Transcriber', build: (def, config) => def.createClient(config) });
+    }
+}
+//# sourceMappingURL=transcribers.js.map

package/dist/registries/transcribers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribers.js","sourceRoot":"","sources":["../../src/registries/transcribers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,mBAAoB,SAAQ,qBAAkD;IACzF;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;CACF"}

package/dist/registries/tunnel-providers.d.ts

@@ -0,0 +1,12 @@
+import type { TunnelProviderDef } from '@moxxy/sdk';
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * One active tunnel provider per session. Register throws on duplicate,
+ * auto-activates the first, and `unregister` clears the active slot. Core
+ * seeds the `localhost` provider so `getActive()` is non-null even when no
+ * tunnel plugin is installed. See {@link ActiveDefRegistry}.
+ */
+export declare class TunnelProviderRegistry extends ActiveDefRegistry<TunnelProviderDef> {
+    constructor();
+}
+//# sourceMappingURL=tunnel-providers.d.ts.map

package/dist/registries/tunnel-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-providers.d.ts","sourceRoot":"","sources":["../../src/registries/tunnel-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB,CAAC,iBAAiB,CAAC;;CAI/E"}

package/dist/registries/tunnel-providers.js

@@ -0,0 +1,13 @@
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * One active tunnel provider per session. Register throws on duplicate,
+ * auto-activates the first, and `unregister` clears the active slot. Core
+ * seeds the `localhost` provider so `getActive()` is non-null even when no
+ * tunnel plugin is installed. See {@link ActiveDefRegistry}.
+ */
+export class TunnelProviderRegistry extends ActiveDefRegistry {
+    constructor() {
+        super({ noun: 'Tunnel provider' });
+    }
+}
+//# sourceMappingURL=tunnel-providers.js.map

package/dist/registries/tunnel-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-providers.js","sourceRoot":"","sources":["../../src/registries/tunnel-providers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,iBAAoC;IAC9E;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/registries/view-renderers.d.ts

@@ -0,0 +1,13 @@
+import type { ViewRendererDef } from '@moxxy/sdk';
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * One active view-spec renderer per session. Register throws on duplicate,
+ * auto-activates the first, and `unregister` clears the active slot rather
+ * than picking an arbitrary successor. Core seeds a default renderer so
+ * `getActive()` is non-null even with no plugins. See
+ * {@link ActiveDefRegistry}.
+ */
+export declare class ViewRendererRegistry extends ActiveDefRegistry<ViewRendererDef> {
+    constructor();
+}
+//# sourceMappingURL=view-renderers.d.ts.map

package/dist/registries/view-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-renderers.d.ts","sourceRoot":"","sources":["../../src/registries/view-renderers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB,CAAC,eAAe,CAAC;;CAI3E"}

package/dist/registries/view-renderers.js

@@ -0,0 +1,14 @@
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * One active view-spec renderer per session. Register throws on duplicate,
+ * auto-activates the first, and `unregister` clears the active slot rather
+ * than picking an arbitrary successor. Core seeds a default renderer so
+ * `getActive()` is non-null even with no plugins. See
+ * {@link ActiveDefRegistry}.
+ */
+export class ViewRendererRegistry extends ActiveDefRegistry {
+    constructor() {
+        super({ noun: 'View renderer' });
+    }
+}
+//# sourceMappingURL=view-renderers.js.map

package/dist/registries/view-renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-renderers.js","sourceRoot":"","sources":["../../src/registries/view-renderers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,OAAO,oBAAqB,SAAQ,iBAAkC;IAC1E;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/registries/workflow-executors.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowExecutorDef } from '@moxxy/sdk';
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * Registry of swappable workflow-execution strategies. Register throws on
+ * duplicate, auto-activates the first registration (so a session always has
+ * an executor once `@moxxy/plugin-workflows` loads its default `dag`), and
+ * `unregister` clears the active slot rather than silently picking a
+ * successor. See {@link ActiveDefRegistry}.
+ */
+export declare class WorkflowExecutorRegistry extends ActiveDefRegistry<WorkflowExecutorDef> {
+    constructor();
+}
+//# sourceMappingURL=workflow-executors.d.ts.map

package/dist/registries/workflow-executors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-executors.d.ts","sourceRoot":"","sources":["../../src/registries/workflow-executors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB,CAAC,mBAAmB,CAAC;;CAInF"}

package/dist/registries/workflow-executors.js

@@ -0,0 +1,14 @@
+import { ActiveDefRegistry } from './active-def-registry.js';
+/**
+ * Registry of swappable workflow-execution strategies. Register throws on
+ * duplicate, auto-activates the first registration (so a session always has
+ * an executor once `@moxxy/plugin-workflows` loads its default `dag`), and
+ * `unregister` clears the active slot rather than silently picking a
+ * successor. See {@link ActiveDefRegistry}.
+ */
+export class WorkflowExecutorRegistry extends ActiveDefRegistry {
+    constructor() {
+        super({ noun: 'Workflow executor' });
+    }
+}
+//# sourceMappingURL=workflow-executors.js.map

package/dist/registries/workflow-executors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-executors.js","sourceRoot":"","sources":["../../src/registries/workflow-executors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,OAAO,wBAAyB,SAAQ,iBAAsC;IAClF;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/requirements.d.ts

@@ -0,0 +1,59 @@
+import type { MoxxyRequirement, RequirementCheck, RequirementKind, RequirementState, AgentDef, ChannelDef, CommandDef, CompactorDef, ModeDef, ProviderDef, ToolDef, TranscriberDef, SynthesizerDef } from '@moxxy/sdk';
+export interface RequirementChecker {
+    check(requirements: ReadonlyArray<MoxxyRequirement> | undefined): RequirementCheck;
+}
+export interface RequirementRegistryOptions {
+    readonly tools: {
+        get(name: string): ToolDef | undefined;
+    };
+    readonly providers: {
+        list(): ReadonlyArray<ProviderDef>;
+        getActiveName(): string | null;
+    };
+    readonly modes: {
+        list(): ReadonlyArray<ModeDef>;
+        getActive(): ModeDef;
+    };
+    readonly compactors: {
+        list(): ReadonlyArray<CompactorDef>;
+        getActive(): CompactorDef | null;
+    };
+    readonly channels: {
+        get(name: string): ChannelDef | undefined;
+    };
+    readonly agents: {
+        get(name: string): AgentDef | undefined;
+    };
+    readonly commands: {
+        get(name: string): CommandDef | undefined;
+    };
+    readonly transcribers: {
+        list(): ReadonlyArray<TranscriberDef>;
+        getActiveName(): string | null;
+    };
+    readonly synthesizers: {
+        list(): ReadonlyArray<SynthesizerDef>;
+        getActiveName(): string | null;
+    };
+}
+export declare class RequirementRegistry {
+    private readonly opts;
+    private readonly runtime;
+    private readonly plugins;
+    constructor(opts: RequirementRegistryOptions);
+    registerPlugin(name: string, version: string): void;
+    unregisterPlugin(name: string): void;
+    setRuntime(name: string, state?: RequirementState): void;
+    clearRuntime(name: string): void;
+    check(requirements: ReadonlyArray<MoxxyRequirement> | undefined): RequirementCheck;
+    /**
+     * Convenience: check whether a single named target is present and (if
+     * its kind has an active/inactive distinction) currently active.
+     * Equivalent to `check([{ kind, name, state: 'active' }])`.
+     */
+    isReady(kind: RequirementKind, name: string): RequirementCheck;
+    private checkOne;
+    private checkRuntime;
+    private targetInfo;
+}
+//# sourceMappingURL=requirements.d.ts.map

package/dist/requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../src/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEhB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,OAAO,EACP,WAAW,EACX,OAAO,EACP,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,SAAS,GAAG,gBAAgB,CAAC;CACpF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE;QACd,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;KACxC,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE;QAClB,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;QACnC,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE;QACd,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/B,SAAS,IAAI,OAAO,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE;QACnB,IAAI,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;QACpC,SAAS,IAAI,YAAY,GAAG,IAAI,CAAC;KAClC,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE;QACjB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;KAC3C,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE;QACf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;KACzC,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE;QACjB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;KAC3C,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE;QACrB,IAAI,IAAI,aAAa,CAAC,cAAc,CAAC,CAAC;QACtC,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE;QACrB,IAAI,IAAI,aAAa,CAAC,cAAc,CAAC,CAAC;QACtC,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACH;AAwCD,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;gBAElC,IAAI,EAAE,0BAA0B;IAE7D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAInD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,gBAA0B,GAAG,IAAI;IAIjE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC,KAAK,CAAC,YAAY,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,SAAS,GAAG,gBAAgB;IAUlF;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAI9D,OAAO,CAAC,QAAQ;IAwBhB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;CAmBnB"}

package/dist/requirements.js

@@ -0,0 +1,149 @@
+/** Active for kinds with no active/inactive distinction (tool/channel/agent/command). */
+const ALWAYS_ACTIVE = () => true;
+export class RequirementRegistry {
+    opts;
+    runtime = new Map();
+    plugins = new Map();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    registerPlugin(name, version) {
+        this.plugins.set(name, { name, version });
+    }
+    unregisterPlugin(name) {
+        this.plugins.delete(name);
+    }
+    setRuntime(name, state = 'ready') {
+        this.runtime.set(name, state);
+    }
+    clearRuntime(name) {
+        this.runtime.delete(name);
+    }
+    check(requirements) {
+        const issues = [];
+        for (const requirement of requirements ?? []) {
+            const issue = this.checkOne(requirement);
+            if (issue)
+                issues.push(issue);
+        }
+        const blocking = issues.filter((issue) => !issue.requirement.optional);
+        return { ready: blocking.length === 0, issues };
+    }
+    /**
+     * Convenience: check whether a single named target is present and (if
+     * its kind has an active/inactive distinction) currently active.
+     * Equivalent to `check([{ kind, name, state: 'active' }])`.
+     */
+    isReady(kind, name) {
+        return this.check([{ kind, name, state: 'active' }]);
+    }
+    checkOne(requirement) {
+        if (requirement.kind === 'runtime')
+            return this.checkRuntime(requirement);
+        const target = this.targetInfo(requirement.kind, requirement.name);
+        if (!target) {
+            return issue(requirement, 'missing', `Required ${label(requirement.kind)} is not registered: ${requirement.name}`);
+        }
+        if (requirement.version && target.version !== requirement.version) {
+            return issue(requirement, 'version_mismatch', `Required ${label(requirement.kind)} has version ${target.version ?? '(unknown)'}, expected ${requirement.version}: ${requirement.name}`);
+        }
+        const state = requirement.state ?? 'registered';
+        if ((state === 'active' || state === 'ready') && !target.active) {
+            return issue(requirement, 'inactive', `Required ${label(requirement.kind)} is not active: ${requirement.name}`);
+        }
+        return null;
+    }
+    checkRuntime(requirement) {
+        const state = requirement.state ?? 'ready';
+        const actual = this.runtime.get(requirement.name);
+        if (actual !== state) {
+            return issue(requirement, 'not_ready', `Required runtime is not ready: ${requirement.name}`);
+        }
+        return null;
+    }
+    targetInfo(kind, name) {
+        // `plugin` resolves against this instance's private registration map (not a
+        // registry on `opts`) and is the only kind carrying a version, so it stays a
+        // special case rather than being contorted into the shared table.
+        if (kind === 'plugin') {
+            const plugin = this.plugins.get(name);
+            return plugin ? { kind, name, version: plugin.version, active: true } : null;
+        }
+        // `runtime` never reaches here — `checkOne` routes it to `checkRuntime` first.
+        if (kind === 'runtime')
+            return null;
+        // Every remaining kind has a table entry: `TARGET_DESCRIPTORS` is a total
+        // `Record` over `Exclude<RequirementKind, 'plugin' | 'runtime'>`, so a kind
+        // added to the union without an entry is a compile error (the table-driven
+        // replacement for the old switch's `assertNever` default).
+        const descriptor = TARGET_DESCRIPTORS[kind];
+        if (!descriptor.present(this.opts, name))
+            return null;
+        return { kind, name, active: descriptor.active(this.opts, name) };
+    }
+}
+/**
+ * Lookup table backing {@link RequirementRegistry.targetInfo} for every
+ * registry-backed {@link RequirementKind}. `plugin` (private map + version) and
+ * `runtime` (handled before `targetInfo`) are intentionally absent and dealt
+ * with as special cases; the `Partial`-free `Record` keyed on the remaining
+ * kinds keeps the set exhaustive (a new kind is a compile error until listed).
+ */
+const TARGET_DESCRIPTORS = {
+    provider: {
+        present: (opts, name) => opts.providers.list().some((p) => p.name === name),
+        active: (opts, name) => opts.providers.getActiveName() === name,
+    },
+    tool: {
+        present: (opts, name) => opts.tools.get(name) !== undefined,
+        active: ALWAYS_ACTIVE,
+    },
+    transcriber: {
+        present: (opts, name) => opts.transcribers.list().some((t) => t.name === name),
+        active: (opts, name) => opts.transcribers.getActiveName() === name,
+    },
+    synthesizer: {
+        present: (opts, name) => opts.synthesizers.list().some((s) => s.name === name),
+        active: (opts, name) => opts.synthesizers.getActiveName() === name,
+    },
+    mode: {
+        present: (opts, name) => opts.modes.list().some((m) => m.name === name),
+        active: (opts, name) => activeModeName(opts.modes) === name,
+    },
+    compactor: {
+        present: (opts, name) => opts.compactors.list().some((c) => c.name === name),
+        active: (opts, name) => opts.compactors.getActive()?.name === name,
+    },
+    channel: {
+        present: (opts, name) => opts.channels.get(name) !== undefined,
+        active: ALWAYS_ACTIVE,
+    },
+    agent: {
+        present: (opts, name) => opts.agents.get(name) !== undefined,
+        active: ALWAYS_ACTIVE,
+    },
+    command: {
+        present: (opts, name) => opts.commands.get(name) !== undefined,
+        active: ALWAYS_ACTIVE,
+    },
+};
+function issue(requirement, code, message) {
+    return {
+        requirement,
+        code,
+        message,
+        ...(requirement.hint ? { hint: requirement.hint } : {}),
+    };
+}
+function label(kind) {
+    return kind;
+}
+function activeModeName(modes) {
+    try {
+        return modes.getActive().name;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=requirements.js.map

package/dist/requirements.js.map

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

package/dist/run-turn.d.ts

@@ -0,0 +1,6 @@
+import type { MoxxyEvent, RunTurnOptions } from '@moxxy/sdk';
+import type { SessionRuntime } from './session-runtime.js';
+export type { RunTurnOptions } from '@moxxy/sdk';
+export declare function runTurn(session: SessionRuntime, prompt: string, opts?: RunTurnOptions): AsyncIterable<MoxxyEvent>;
+export declare function collectTurn(session: SessionRuntime, prompt: string, opts?: RunTurnOptions): Promise<ReadonlyArray<MoxxyEvent>>;
+//# sourceMappingURL=run-turn.d.ts.map

package/dist/run-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-turn.d.ts","sourceRoot":"","sources":["../src/run-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAuB,OAAO,CAC5B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,cAAmB,GACxB,aAAa,CAAC,UAAU,CAAC,CAoI3B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAIpC"}

package/dist/run-turn.js

@@ -0,0 +1,141 @@
+import { createSubagentSpawner } from './subagents.js';
+export async function* runTurn(session, prompt, opts = {}) {
+    // Mint the turnId first so the subscriber below can filter by it. Without
+    // the filter, concurrent runTurn() calls on the same Session would each
+    // observe every event from every other turn (the EventLog has one global
+    // listener set), causing cross-talk for hosts like the HTTP channel that
+    // serve multiple turns in parallel.
+    // Use a caller-supplied turnId when present (the runner mints it up front so
+    // it can return the id before the turn runs); otherwise mint one here.
+    const turnId = opts.turnId ?? session.startTurn().turnId;
+    const provider = session.providers.getActive();
+    const model = opts.model ?? provider.models[0]?.id ?? 'default';
+    // Record the resolution so out-of-band spawns (workflow triggers) can
+    // inherit the conversation's current model. Last-writer-wins when turns
+    // run concurrently — see the field's doc in SessionRuntime.
+    session.lastResolvedModel = model;
+    const queue = [];
+    const waiters = [];
+    let done = false;
+    let strategyError = null;
+    // A mode can ask (via ctx.requestModeSwitch) to hand off to another mode
+    // once this turn finishes — applied after the strategy drains, below.
+    let requestedModeSwitch = null;
+    const wake = () => waiters.shift()?.();
+    const unsubscribe = session.log.subscribe((event) => {
+        if (event.turnId !== turnId)
+            return;
+        queue.push(event);
+        wake();
+    });
+    let strategyPromise = null;
+    try {
+        await session.log.append({
+            type: 'user_prompt',
+            sessionId: session.id,
+            turnId,
+            source: 'user',
+            text: prompt,
+            ...(opts.attachments && opts.attachments.length > 0
+                ? { attachments: opts.attachments }
+                : {}),
+        });
+        const strategy = session.modes.getActive();
+        // Combine the session's signal with the per-turn one (if provided)
+        // so either firing cancels the turn.
+        const effectiveSignal = opts.signal
+            ? AbortSignal.any([session.signal, opts.signal])
+            : session.signal;
+        // The session's working dir + environment, mirrored onto the ModeContext
+        // so the shared tool dispatcher can hand onToolCall hooks the real cwd/env
+        // (path-based policy hooks gate on these) instead of empty placeholders.
+        const appCtx = session.appContext();
+        const ctx = {
+            sessionId: session.id,
+            turnId,
+            cwd: appCtx.cwd,
+            env: appCtx.env,
+            model,
+            systemPrompt: opts.systemPrompt,
+            provider,
+            tools: session.tools,
+            skills: session.skills,
+            log: session.log,
+            compactor: session.compactors.getActive(),
+            cacheStrategy: session.cacheStrategies.getActive(),
+            ...(session.elisionSettings ? { elision: session.elisionSettings } : {}),
+            ...(session.lazyTools ? { lazyTools: true } : {}),
+            // Reasoning preference (effort) — honored only by providers/models that
+            // advertise `supportsReasoning` (gated in collectProviderStream).
+            ...(session.reasoning ? { reasoning: session.reasoning } : {}),
+            permissions: session.resolver,
+            ...(session.approvalResolver ? { approval: session.approvalResolver } : {}),
+            hooks: session.dispatcher,
+            pluginHost: session.pluginHost,
+            signal: effectiveSignal,
+            maxIterations: opts.maxIterations,
+            subagents: createSubagentSpawner({
+                parentSession: session,
+                parentTurnId: turnId,
+                parentSignal: effectiveSignal,
+                parentModel: model,
+            }),
+            requestModeSwitch: (modeName) => {
+                requestedModeSwitch = modeName;
+            },
+            emit: (event) => session.log.append(event),
+        };
+        const turnStartCtx = { ...appCtx, turnId, iteration: 0 };
+        strategyPromise = (async () => {
+            try {
+                await session.dispatcher.dispatchTurnStart(turnStartCtx);
+                for await (const _ of strategy.run(ctx)) {
+                    // Events are surfaced via the log subscription above.
+                    void _;
+                }
+                await session.dispatcher.dispatchTurnEnd(turnStartCtx);
+            }
+            catch (err) {
+                strategyError = err;
+            }
+            finally {
+                done = true;
+                wake();
+            }
+        })();
+        while (true) {
+            while (queue.length > 0)
+                yield queue.shift();
+            if (done)
+                break;
+            await new Promise((resolve) => waiters.push(resolve));
+        }
+    }
+    finally {
+        unsubscribe();
+        if (strategyPromise)
+            await strategyPromise;
+        // Apply a mode hand-off the strategy requested, now that the turn has
+        // fully drained. Only on clean completion (a thrown/aborted turn keeps
+        // the current mode); an unknown target is ignored so a bad name can't
+        // wedge the session. The registry's setActive triggers the runner's
+        // InfoChanged broadcast, so channels see the new mode.
+        if (requestedModeSwitch && !strategyError) {
+            try {
+                session.modes.setActive(requestedModeSwitch);
+            }
+            catch {
+                /* unregistered target — leave the active mode unchanged */
+            }
+        }
+    }
+    if (strategyError)
+        throw strategyError;
+}
+export async function collectTurn(session, prompt, opts = {}) {
+    const events = [];
+    for await (const event of runTurn(session, prompt, opts))
+        events.push(event);
+    return events;
+}
+//# sourceMappingURL=run-turn.js.map

package/dist/run-turn.js.map

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

package/dist/session-runtime.d.ts

@@ -0,0 +1,67 @@
+import type { AppContext, ApprovalResolver, CacheStrategyDef, CompactorDef, ElisionSettings, HookDispatcher, LLMProvider, ModeDef, PermissionResolver, PluginHostHandle, SessionId, SkillRegistry, TurnId } from '@moxxy/sdk';
+import type { EventLog } from './events/log.js';
+import type { ToolRegistry } from './registries/tools.js';
+/**
+ * The slice of the concrete `Session` that the turn driver (`run-turn.ts`)
+ * and the subagent runtime (`subagents/spawn.ts`, `subagents/events.ts`)
+ * actually consume. Those modules depend on *this* interface rather than
+ * importing the `Session` class directly.
+ *
+ * Why: `session.ts` value-imports `runTurn`, so if `run-turn.ts` (and the
+ * subagent modules it pulls in) imported the `Session` class back, the
+ * package would have an import cycle — flagged by `pnpm check:deps` because
+ * dependency-cruiser tracks type-only edges (`tsPreCompilationDeps`). Routing
+ * through this leaf contract keeps the value graph a DAG
+ * (`session → run-turn → subagents → spawn → events`) with no edges pointing
+ * back at `session.ts`.
+ *
+ * `Session implements SessionRuntime`, so the contract can't silently drift
+ * from the class it abstracts.
+ */
+export interface SessionRuntime {
+    readonly id: SessionId;
+    readonly log: EventLog;
+    readonly signal: AbortSignal;
+    readonly tools: ToolRegistry;
+    readonly skills: SkillRegistry;
+    readonly providers: {
+        getActive(): LLMProvider;
+    };
+    readonly modes: {
+        getActive(): ModeDef;
+        list(): ReadonlyArray<ModeDef>;
+        /** Post-turn mode hand-off (one mode handing back to another). Throws on an
+         *  unknown name; run-turn guards the call. */
+        setActive(name: string): void;
+    };
+    readonly compactors: {
+        getActive(): CompactorDef | null;
+    };
+    readonly cacheStrategies: {
+        getActive(): CacheStrategyDef | null;
+    };
+    readonly resolver: PermissionResolver;
+    readonly approvalResolver: ApprovalResolver | null;
+    readonly elisionSettings: ElisionSettings | null;
+    readonly lazyTools: boolean;
+    /** Reasoning/thinking preference (effort), forwarded to each turn's ModeContext. */
+    readonly reasoning?: {
+        readonly effort?: 'low' | 'medium' | 'high';
+    } | boolean | undefined;
+    readonly dispatcher: HookDispatcher;
+    readonly pluginHost: PluginHostHandle;
+    /**
+     * Model id resolved by the most recent `runTurn()` on this session.
+     * Out-of-band spawns (workflow triggers, schedulers) read this so their
+     * children inherit whatever the user is currently talking to instead of a
+     * stale hardcoded default. Last-writer-wins under concurrent turns — it is
+     * a "current conversation model" hint, not a per-turn record. Null until
+     * the first turn resolves a model.
+     */
+    lastResolvedModel: string | null;
+    startTurn(): {
+        turnId: TurnId;
+    };
+    appContext(): AppContext;
+}
+//# sourceMappingURL=session-runtime.d.ts.map

package/dist/session-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../src/session-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,EACX,OAAO,EACP,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE;QAAE,SAAS,IAAI,WAAW,CAAA;KAAE,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE;QACd,SAAS,IAAI,OAAO,CAAC;QACrB,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/B;sDAC8C;QAC9C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE;QAAE,SAAS,IAAI,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1D,QAAQ,CAAC,eAAe,EAAE;QAAE,SAAS,IAAI,gBAAgB,GAAG,IAAI,CAAA;KAAE,CAAC;IACnE,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3F,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC;;;;;;;OAOG;IACH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,IAAI;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,UAAU,IAAI,UAAU,CAAC;CAC1B"}

package/dist/session-runtime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-runtime.js.map

package/dist/session-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-runtime.js","sourceRoot":"","sources":["../src/session-runtime.ts"],"names":[],"mappings":""}