@deepseek-ai/dsh-subagent 0.2.0-rc.2 → 0.2.1-alpha.2

package/lib/types/inbox.js

@@ -1,61 +0,0 @@
-/**
- * Activation-local admission around one continuable subagent's Agent inbox.
- *
- * @module @deepseek-ai/dsh-subagent/inbox
- */
-import { SubagentError } from "./error.js";
-/** Delegate Queue and Steer to one live Agent until its Activation starts closing. */
-export class SubagentInbox {
-    agent;
-    closingPromise;
-    /**
-     * Wrap one live continuable Agent.
-     * @param agent - the Agent whose inbox receives accepted deliveries.
-     */
-    constructor(agent) {
-        this.agent = agent;
-    }
-    /**
-     * Read the Activation's close transaction.
-     * @returns the memoized transaction, or `undefined` while delivery remains open.
-     */
-    get closing() {
-        return this.closingPromise;
-    }
-    /**
-     * Read whether the underlying Agent still has accepted work to claim.
-     * @returns whether either Agent inbox destination is non-empty.
-     */
-    get hasPending() {
-        return this.agent.inbox.nextTurn.length > 0 || this.agent.inbox.nextStep.length > 0;
-    }
-    /**
-     * Submit through the Agent only while its Activation remains resident.
-     * @param message - the accepted input to submit.
-     * @param delivery - whether to queue a distinct turn or steer the nearest step.
-     */
-    deliver(message, delivery) {
-        if (this.closingPromise !== undefined) {
-            throw new SubagentError(`subagent "${this.agent.id}" activation is being disposed; the message was not accepted`, 'ACTIVATION_CLOSING');
-        }
-        if (delivery === 'steer')
-            this.agent.steer(message);
-        else
-            this.agent.followup(message);
-    }
-    /**
-     * Close delivery synchronously and share one asynchronous release.
-     * @param release - the one release operation to start after closing admission.
-     * @returns the memoized release transaction.
-     */
-    close(release) {
-        const existing = this.closingPromise;
-        if (existing !== undefined)
-            return existing;
-        const completion = Promise.withResolvers();
-        this.closingPromise = completion.promise;
-        void release().then(completion.resolve, completion.reject);
-        return completion.promise;
-    }
-}
-//# sourceMappingURL=inbox.js.map

package/lib/types/invariant.d.ts

@@ -1,13 +0,0 @@
-/** Package-owned subagent registry and lifecycle invariants. @module @deepseek-ai/dsh-subagent/invariant */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "subagent-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register the subagent invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.js

@@ -1,91 +0,0 @@
-/** Package-owned subagent registry and lifecycle invariants. @module @deepseek-ai/dsh-subagent/invariant */
-const PACKAGE_NAME = '@deepseek-ai/dsh-subagent';
-/** Cordis companion plugin name. */
-export const name = 'subagent-invariant';
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants'];
-/** Assert that a terminal lifecycle payload matches its start identity. */
-function validateRunEnd(start, end, fail) {
-    if (start.provider !== end.provider || start.id !== end.id || start.local !== end.local) {
-        fail(`subagent/end identity diverges from subagent/start for run ${JSON.stringify(end.runId)}`);
-    }
-}
-/** Install provider-registry and start/end pairing checks. */
-const install = Object.assign((ctx, fail) => {
-    const providers = new Set(ctx.subagents.list());
-    const runs = new Map();
-    const stagedProviders = new WeakSet();
-    const stagedRemovals = new Set();
-    const stagedStarts = new WeakSet();
-    const stagedEnds = new WeakSet();
-    ctx.on('internal/dispatch', (_mode, eventName, args) => {
-        if (eventName === 'subagent/provider-added') {
-            const provider = args[0];
-            if (provider.name.length === 0)
-                fail('subagent provider names must be non-empty');
-            if (providers.has(provider.name))
-                fail(`subagent/provider-added repeated ${JSON.stringify(provider.name)}`);
-            stagedProviders.add(provider);
-            return;
-        }
-        if (eventName === 'subagent/provider-removed') {
-            const providerName = args[0];
-            if (!providers.has(providerName))
-                fail(`subagent/provider-removed names unknown provider ${JSON.stringify(providerName)}`);
-            stagedRemovals.add(providerName);
-            return;
-        }
-        if (eventName === 'subagent/start') {
-            const info = args[0];
-            // Provider availability is an admission-time relationship. A published
-            // one-shot run may outlive provider removal, and a cold-resumed Activation
-            // records the initial provider name without dispatching through it.
-            if (info.provider.length === 0 || String(info.runId).length === 0 || String(info.id).length === 0) {
-                fail('subagent/start provider, runId, and child id must be non-empty');
-            }
-            if (runs.has(info.runId))
-                fail(`subagent/start repeated run id ${JSON.stringify(info.runId)}`);
-            stagedStarts.add(info);
-            return;
-        }
-        if (eventName !== 'subagent/end')
-            return;
-        const info = args[0];
-        const start = runs.get(info.runId);
-        if (start === undefined)
-            fail(`subagent/end has no matching subagent/start for run ${JSON.stringify(info.runId)}`);
-        validateRunEnd(start, info, fail);
-        stagedEnds.add(info);
-    }, { global: true });
-    ctx.on('subagent/provider-added', (provider) => {
-        /* v8 ignore next -- internal/dispatch stages the same provider object */
-        if (!stagedProviders.delete(provider))
-            return;
-        providers.add(provider.name);
-    }, { global: true });
-    ctx.on('subagent/provider-removed', (providerName) => {
-        /* v8 ignore next -- internal/dispatch stages the same provider name */
-        if (!stagedRemovals.delete(providerName))
-            return;
-        providers.delete(providerName);
-    }, { global: true });
-    ctx.on('subagent/start', (info) => {
-        /* v8 ignore next -- internal/dispatch stages the same lifecycle object */
-        if (!stagedStarts.delete(info))
-            return;
-        runs.set(info.runId, info);
-    }, { global: true });
-    ctx.on('subagent/end', (info) => {
-        /* v8 ignore next -- internal/dispatch stages the same lifecycle object */
-        if (!stagedEnds.delete(info))
-            return;
-        runs.delete(info.runId);
-    }, { global: true });
-}, { inject: ['subagents'] });
-/**
- * Register the subagent invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//# sourceMappingURL=invariant.js.map

package/lib/types/run-settlement.d.ts

@@ -1,17 +0,0 @@
-/**
- * Settlement of one ONE-SHOT subagent run into a background-Task outcome. Only
- * the one-shot background path uses Jobs; continuable children have no Task,
- * no per-message result, and no Task cancellation.
- *
- * @module @deepseek-ai/dsh-subagent/run-settlement
- */
-import type { JobOutcome } from '@deepseek-ai/dsh-jobs';
-import type { SubagentRun } from './types.ts';
-/**
- * Await the child result, dispose the run, then return its task outcome. Result
- * and disposal failures become `failed`; when both fail, both details survive.
- * @param run - live run to settle and release.
- * @returns outcome after child resources are released.
- */
-export declare function settleRun(run: SubagentRun): Promise<JobOutcome>;
-//# sourceMappingURL=run-settlement.d.ts.map

package/lib/types/run-settlement.js

@@ -1,70 +0,0 @@
-/**
- * Settlement of one ONE-SHOT subagent run into a background-Task outcome. Only
- * the one-shot background path uses Jobs; continuable children have no Task,
- * no per-message result, and no Task cancellation.
- *
- * @module @deepseek-ai/dsh-subagent/run-settlement
- */
-/** Flatten a child's final output blocks to the task's final text. */
-function finalText(blocks) {
-    return blocks
-        .filter((block) => block.type === 'text')
-        .map(block => block.text)
-        .join('');
-}
-/** Render a failed stop reason with optional provider-authored detail. */
-function failureDetail(result) {
-    const stopReason = result.stopReason;
-    return result.diagnostic === undefined
-        ? stopReason
-        : `${stopReason}; diagnostic: ${result.diagnostic}`;
-}
-/**
- * Map a child result to the task outcome: completed carries final text, local
- * cancellation (`aborted` without a diagnostic) is killed, and provider-
- * diagnosed remote aborts plus every other reason are failed without partial
- * output.
- * @param result - child terminal result.
- * @returns outcome for the `ctx.jobs` registration.
- */
-function runOutcome(result) {
-    switch (result.stopReason) {
-        case 'completed':
-            return { status: 'completed', result: finalText(result.output) };
-        case 'aborted':
-            return result.diagnostic === undefined
-                ? { status: 'killed' }
-                : { status: 'failed', detail: failureDetail(result) };
-        case 'error':
-        case 'max-tokens':
-        case 'refusal':
-            return { status: 'failed', detail: failureDetail(result) };
-        // Merge-extensible reasons remain failures with provider-authored detail.
-        default:
-            return { status: 'failed', detail: failureDetail(result) };
-    }
-}
-/**
- * Await the child result, dispose the run, then return its task outcome. Result
- * and disposal failures become `failed`; when both fail, both details survive.
- * @param run - live run to settle and release.
- * @returns outcome after child resources are released.
- */
-export async function settleRun(run) {
-    let outcome;
-    try {
-        outcome = runOutcome(await run.result);
-    }
-    catch (error) {
-        outcome = { status: 'failed', detail: String(error) };
-    }
-    try {
-        await run.dispose();
-    }
-    catch (error) {
-        const prefix = outcome.detail === undefined ? '' : `${outcome.detail}; `;
-        return { status: 'failed', detail: `${prefix}dispose failed: ${String(error)}` };
-    }
-    return outcome;
-}
-//# sourceMappingURL=run-settlement.js.map