@wowyuarm/dsh-agent-team 0.1.8 → 0.1.10

package/packages/tool-agent-team/lib/types/context-tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Model-facing context-management tools for Team Members. Thin adapters
+ * only: validation runs in the Host adapter, the successful result is the
+ * durable intent, and every lifecycle side effect — generation swap, Session
+ * creation, inbox handling — happens in the Host coordinator after the
+ * result is durably appended. `concludeTurn()` rides the success result of
+ * `context_rollover` and `context_checkpoint`, so sibling calls settle in model
+ * order before the turn closes.
+ * @module @wowyuarm/dsh-agent-team/context-tools
+ */
+export declare function registerContextTools(ctx: {
+    readonly tools: {
+        register(tool: unknown): void;
+    };
+}): void;
+//# sourceMappingURL=context-tools.d.ts.map

package/packages/tool-agent-team/lib/types/context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/context-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoKH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,CAIrG"}

package/packages/tool-agent-team/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAWlD,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C,eAAO,MAAM,MAAM,UAAY,CAAA;AAwT/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAMxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAclD,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C,eAAO,MAAM,MAAM,UAAY,CAAA;AAypB/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAOxC"}

package/packages/agent-team/lib/auto-compaction.js

@@ -1,201 +0,0 @@
-import { ManualCompactionError } from '@deepseek-ai/dsh-compaction';
-/** Strict threshold: 200K exactly does not compact. */
-export const AUTO_COMPACTION_TOKEN_LIMIT = 200_000;
-/**
- * Suggested summary marker of the pre-compaction memory hint. Same shape as
- * the inbox and recovery notices so future turns can recognize it.
- */
-export const PRE_COMPACTION_NOTICE_SUMMARY = 'Compaction is imminent; consider persisting key conclusions.';
-/** Suggested pre-compaction hint body; writing is the Agent's own call. */
-export function preCompactionNoticeText() {
-    return 'This session is about to be compacted, which will summarize away the current conversation detail. If there are durable conclusions worth keeping — validated facts, decisions, or reusable details — consider writing them to your memory or notes now. This is only a reminder: decide yourself whether anything is worth persisting, and do nothing if not. Do not start new work because of this message.';
-}
-/** Claim owners of a durable Human acceptance, including early-completed ones. */
-export function acceptedTaskCompactionMembers(operation) {
-    if (operation.kind !== 'team/task-changed' || operation.actor.kind !== 'human' || operation.data.activity.kind !== 'accept')
-        return undefined;
-    return [...new Set(operation.data.claims.map(claim => claim.owner))];
-}
-/**
- * Small Host-side accepted-Task follow-up. This is deliberately not a generic
- * workflow/state-machine: a pending set deduplicates Members, an error map is
- * owned by the Host, and each worker is only whenIdle → measure → compactNow.
- */
-export class AutoCompactionCoordinator {
-    options;
-    pending = new Set();
-    workers = new Map();
-    controller = new AbortController();
-    constructor(options) {
-        this.options = options;
-    }
-    /** Queue all unique claim owners; unavailable Members stay pending. */
-    schedule(memberIds) {
-        for (const memberId of new Set(memberIds)) {
-            this.pending.add(memberId);
-            this.start(memberId);
-        }
-    }
-    /** Activation/recovery calls this after a live handle becomes available. */
-    activated(memberId) {
-        this.start(memberId);
-    }
-    async dispose() {
-        this.controller.abort();
-        await Promise.all([...this.workers.values()].map(worker => worker.catch(() => { })));
-        this.workers.clear();
-        this.pending.clear();
-    }
-    start(memberId) {
-        if (this.controller.signal.aborted || this.workers.has(memberId) || !this.pending.has(memberId))
-            return;
-        // No live handle is not a failure: member activation/recovery calls activated().
-        if (this.options.agentForMember(memberId) === undefined)
-            return;
-        const worker = this.work(memberId).finally(() => { this.workers.delete(memberId); });
-        this.workers.set(memberId, worker);
-    }
-    async work(memberId) {
-        let reactivated = false;
-        while (!this.controller.signal.aborted && this.pending.has(memberId)) {
-            const agent = this.options.agentForMember(memberId);
-            if (agent === undefined)
-                return;
-            try {
-                if (!(await waitForIdleOrAbort(agent, this.controller.signal)))
-                    return;
-            }
-            catch (error) {
-                this.fail(memberId, agent, `automatic compaction idle wait failed: ${describe(error)}`);
-                return;
-            }
-            // A restart can replace the handle while it waited; restart the turn on
-            // the current agent so measurement and compactNow share one scope.
-            if (this.options.agentForMember(memberId) !== agent)
-                continue;
-            const meter = agent.ctx.get('tokenMeter');
-            if (meter === undefined) {
-                this.fail(memberId, agent, 'automatic compaction failed: tokenMeter is unavailable in the Member scope');
-                return;
-            }
-            let before = meter.measure(agent.session).totalTokens;
-            if (before <= AUTO_COMPACTION_TOKEN_LIMIT) {
-                this.complete(memberId, agent);
-                return;
-            }
-            // The session is over the threshold and about to be compacted: steer one
-            // advisory hint so the Agent can persist its own key conclusions first.
-            // The hint turn itself is ordinary agent work — its failure is contained
-            // by the agent loop and never blocks compaction; only the fresh idle
-            // boundary is awaited before the final measurement and compactNow.
-            if (this.options.steerPreCompaction !== undefined) {
-                try {
-                    this.options.steerPreCompaction(agent);
-                }
-                catch (error) {
-                    this.options.log(`pre-compaction memory hint failed: ${describe(error)} (member ${memberId}, session ${agent.id})`);
-                }
-                try {
-                    if (!(await waitForIdleOrAbort(agent, this.controller.signal)))
-                        return;
-                }
-                catch (error) {
-                    this.options.log(`pre-compaction hint idle wait failed: ${describe(error)} (member ${memberId}, session ${agent.id})`);
-                }
-                if (this.controller.signal.aborted)
-                    return;
-                if (this.options.agentForMember(memberId) !== agent)
-                    continue;
-                before = meter.measure(agent.session).totalTokens;
-                if (before <= AUTO_COMPACTION_TOKEN_LIMIT) {
-                    this.complete(memberId, agent);
-                    return;
-                }
-            }
-            const engine = this.options.compactionForAgent(agent);
-            if (engine === undefined) {
-                // A roster-subtree teardown (bundle-row reload, config hot-apply)
-                // prunes the standing mount while this agent's scope binding still
-                // names the dead key, so resolution can never succeed again for this
-                // handle. One in-place re-activation rebuilds the binding from the
-                // live roster; a preset that mounts no compaction row keeps failing
-                // and lands in the terminal diagnostic below.
-                if (!reactivated && await this.tryReactivate(memberId)) {
-                    reactivated = true;
-                    continue;
-                }
-                this.fail(memberId, agent, 'automatic compaction failed: compaction is unavailable in the Member scope');
-                return;
-            }
-            try {
-                const result = await engine.compactNow(agent, this.controller.signal);
-                if (this.controller.signal.aborted)
-                    return;
-                if (result === null) {
-                    this.fail(memberId, agent, `automatic compaction returned no compactable range above ${AUTO_COMPACTION_TOKEN_LIMIT} tokens`);
-                    return;
-                }
-            }
-            catch (error) {
-                if (this.controller.signal.aborted)
-                    return;
-                if (error instanceof ManualCompactionError && error.code === 'busy')
-                    continue;
-                this.fail(memberId, agent, `automatic compaction failed: ${describe(error)}`);
-                return;
-            }
-            const after = meter.measure(agent.session).totalTokens;
-            if (after >= before) {
-                this.fail(memberId, agent, `automatic compaction did not reduce context (${before} → ${after} tokens)`);
-                return;
-            }
-            this.options.cleared(memberId, agent.id);
-            // Still over the strict threshold: next iteration waits at a fresh idle
-            // boundary before attempting another compactNow.
-        }
-    }
-    complete(memberId, agent) {
-        this.pending.delete(memberId);
-        this.options.cleared(memberId, agent.id);
-    }
-    tryReactivate(memberId) {
-        return this.options.reactivate(memberId).catch(error => {
-            this.options.log(`automatic compaction re-activation failed: ${describe(error)} (member ${memberId})`);
-            return false;
-        });
-    }
-    fail(memberId, agent, diagnostic) {
-        this.pending.delete(memberId);
-        this.options.log(`${diagnostic} (member ${memberId}, session ${agent.id})`);
-        this.options.failed(memberId, agent.id, diagnostic);
-    }
-}
-/** Abortable idle wait; the Agent owns its idle promise and is never cancelled. */
-function waitForIdleOrAbort(agent, signal) {
-    const idle = agent.whenIdle();
-    if (signal.aborted) {
-        // The agent may settle or reject after teardown; keep that late outcome
-        // observed without making it a coordinator failure.
-        void idle.catch(() => { });
-        return Promise.resolve(false);
-    }
-    return new Promise((resolve, reject) => {
-        let settled = false;
-        const finish = (outcome, error) => {
-            if (settled)
-                return;
-            settled = true;
-            signal.removeEventListener('abort', onAbort);
-            if (outcome === 'error')
-                reject(error);
-            else
-                resolve(outcome === 'idle');
-        };
-        const onAbort = () => { finish('aborted'); };
-        signal.addEventListener('abort', onAbort, { once: true });
-        idle.then(() => { finish('idle'); }, error => { finish('error', error); });
-    });
-}
-function describe(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/packages/agent-team/lib/types/auto-compaction.d.ts

@@ -1,47 +0,0 @@
-import type { Agent } from '@deepseek-ai/dsh-agent';
-import { type CompactionEngine } from '@deepseek-ai/dsh-compaction';
-import type { AgentTeamMemberId, AgentTeamOperation } from './types.ts';
-/** Strict threshold: 200K exactly does not compact. */
-export declare const AUTO_COMPACTION_TOKEN_LIMIT = 200000;
-/**
- * Suggested summary marker of the pre-compaction memory hint. Same shape as
- * the inbox and recovery notices so future turns can recognize it.
- */
-export declare const PRE_COMPACTION_NOTICE_SUMMARY = "Compaction is imminent; consider persisting key conclusions.";
-/** Suggested pre-compaction hint body; writing is the Agent's own call. */
-export declare function preCompactionNoticeText(): string;
-/** Claim owners of a durable Human acceptance, including early-completed ones. */
-export declare function acceptedTaskCompactionMembers(operation: AgentTeamOperation): readonly AgentTeamMemberId[] | undefined;
-/**
- * Small Host-side accepted-Task follow-up. This is deliberately not a generic
- * workflow/state-machine: a pending set deduplicates Members, an error map is
- * owned by the Host, and each worker is only whenIdle → measure → compactNow.
- */
-export declare class AutoCompactionCoordinator {
-    private readonly options;
-    private readonly pending;
-    private readonly workers;
-    private readonly controller;
-    constructor(options: {
-        readonly agentForMember: (memberId: AgentTeamMemberId) => Agent | undefined;
-        readonly compactionForAgent: (agent: Agent) => CompactionEngine | undefined;
-        /** Rebuild one enabled Member in place from its persisted Session; false when it stays unusable. */
-        readonly reactivate: (memberId: AgentTeamMemberId) => Promise<boolean>;
-        readonly failed: (memberId: AgentTeamMemberId, sessionId: Agent['id'], diagnostic: string) => void;
-        readonly cleared: (memberId: AgentTeamMemberId, sessionId: Agent['id']) => void;
-        readonly log: (message: string) => void;
-        /** Steer the pre-compaction memory hint; absent skips the hint entirely. */
-        readonly steerPreCompaction?: (agent: Agent) => void;
-    });
-    /** Queue all unique claim owners; unavailable Members stay pending. */
-    schedule(memberIds: readonly AgentTeamMemberId[]): void;
-    /** Activation/recovery calls this after a live handle becomes available. */
-    activated(memberId: AgentTeamMemberId): void;
-    dispose(): Promise<void>;
-    private start;
-    private work;
-    private complete;
-    private tryReactivate;
-    private fail;
-}
-//# sourceMappingURL=auto-compaction.d.ts.map

package/packages/agent-team/lib/types/auto-compaction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto-compaction.d.ts","sourceRoot":"","sources":["../../src/auto-compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAG1F,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEvE,uDAAuD;AACvD,eAAO,MAAM,2BAA2B,SAAU,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,iEAAiE,CAAA;AAE3G,2EAA2E;AAC3E,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,kFAAkF;AAClF,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,kBAAkB,GAAG,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAGrH;AAED;;;;GAIG;AACH,qBAAa,yBAAyB;IAKxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;gBAEtB,OAAO,EAAE;QACpC,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,KAAK,GAAG,SAAS,CAAA;QAC3E,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,gBAAgB,GAAG,SAAS,CAAA;QAC3E,oGAAoG;QACpG,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;QACtE,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;QAClG,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;QAC/E,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;QACvC,4EAA4E;QAC5E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;KACrD;IAED,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI;IAOvD,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAItC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,KAAK;YAQC,IAAI;IAuFlB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,IAAI;CAKb"}