@wowyuarm/dsh-agent-team 0.1.8 → 0.1.10

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

@@ -0,0 +1,219 @@
+/**
+ * Host-only Session projection for Agent Team context management.
+ *
+ * One pure synchronous fold over a Member Session log derives every
+ * context-management fact the Host needs: pending rollover intent (a
+ * successful `context_rollover` call/result pair — under the legacy
+ * `new_context` name for Sessions recorded before the rename), explicit
+ * checkpoints (a
+ * successful `context_checkpoint` pair resolved by its containing `turn/end`),
+ * handoff/compaction boundaries, and quiet-continuation delivery state. The
+ * fold is the single authority for these facts — no second store, and callers
+ * never re-derive intent from raw events.
+ *
+ * A seeded child Session folds with `inheritedEventCount` respected: events
+ * inherited from the fork prefix are already resolved history, never fresh
+ * intent. The cold fold and the registered unit both start past the inherited
+ * cut, so an inherited historical rollover call can never schedule
+ * another transition in the child.
+ * @module @wowyuarm/dsh-agent-team/context-projection
+ */
+import type { UserMessage } from '@deepseek-ai/dsh-llm';
+import type { SessionEvent, SessionLogOffset } from '@deepseek-ai/dsh-session';
+import type { ProjectionDefinition } from '@deepseek-ai/dsh-session-projection';
+import type { AgentTeamContextCheckpointRef } from './types.ts';
+import { isCheckpointContinuationMessage } from './context-source.ts';
+/** Whether one notice summary is a pure reminder (never a semantic Team fact). */
+export declare function isReminderNoticeSummary(summary: string): boolean;
+/** Stable tool names the projection recognizes. */
+export declare const CONTEXT_CHECKPOINT_TOOL_NAME = "context_checkpoint";
+export declare const CONTEXT_ROLLOVER_TOOL_NAME = "context_rollover";
+/**
+ * Legacy decoder name: the rollover tool was renamed `new_context` →
+ * `context_rollover`, and Sessions recorded before the rename still carry
+ * durable `new_context` call/result pairs. The projection keeps folding them
+ * — pending rollovers and crash recovery of existing Members depend on old
+ * events still resolving intent — but this is a log decoder, not a tool
+ * alias: no new call can carry the old name.
+ */
+export declare const NEW_CONTEXT_TOOL_NAME = "new_context";
+/** One completed-turn checkpoint anchor in this Session lineage. */
+export interface ContextCheckpointEntry {
+    /** Opaque stable ref; selection authority, never derived from the name. */
+    readonly checkpointRef: AgentTeamContextCheckpointRef;
+    /** Display label supplied by the model. */
+    readonly name: string;
+    /** Seq of the successful tool result that recorded the checkpoint. */
+    readonly resultSeq: number;
+    /** Turn the checkpoint concluded; the completed-turn boundary anchor. */
+    readonly turn: number;
+    /** Seq of the `turn/end` that resolved the checkpoint; -1 until resolved. */
+    readonly turnEndSeq: number;
+}
+/** Arguments the model passed to one successful rollover call. */
+export interface RolloverToolArguments {
+    readonly handoff: string;
+    readonly checkpointRef?: AgentTeamContextCheckpointRef | undefined;
+    readonly relatedFiles: readonly {
+        readonly path: string;
+        readonly reason: string;
+    }[];
+}
+/** Rollover intent waiting for the containing turn to finish and the Agent to idle. */
+export interface PendingRolloverIntent extends RolloverToolArguments {
+    /** The provider-issued call id of the successful rollover call. */
+    readonly toolCallId: string;
+    /** Seq of the successful rollover tool result. */
+    readonly resultSeq: number;
+    /** Turn containing the successful call; the swap waits for its end. */
+    readonly turn: number;
+    /** Seq of the `turn/end` that released the intent for the swap; -1 until observed. */
+    readonly turnEndSeq: number;
+}
+/** Quiet-continuation delivery state for one checkpoint, keyed by checkpointRef. */
+export interface ContinuationDeliveryState {
+    /** The checkpoint the continuation follows. */
+    readonly checkpointRef: AgentTeamContextCheckpointRef;
+    /** Seq of the delivered continuation notice in this Session; -1 until delivered. */
+    readonly deliveredSeq: number;
+}
+/** One non-Team message queued after the pending intent; a carry candidate. */
+export interface CarriedCandidate {
+    /** The queued message itself, verbatim. */
+    readonly message: UserMessage;
+    /** The turn that surfaced the message onto the model-visible input, if any. */
+    readonly surfacedTurn: number;
+    /** Whether a completed assistant answer proved the old generation handled it. */
+    readonly consumed: boolean;
+}
+/** State of the `agentTeamContext` projection for one Session. */
+export interface AgentTeamContextProjectionState {
+    /** Checkpoints recorded by a successful call, resolved ones anchored to their turn end. */
+    readonly checkpoints: readonly ContextCheckpointEntry[];
+    /** Rollover intent awaiting its containing turn end, at most one. */
+    readonly pending: PendingRolloverIntent | null;
+    /** Quiet continuations recorded (with or without delivery), keyed by checkpoint ref. */
+    readonly continuations: readonly ContinuationDeliveryState[];
+    /**
+     * Non-Team messages queued into the inbox after the pending intent's tool
+     * result. The durable `agent/inbox/spliced` log is the truth: the
+     * transition delivers every candidate the old generation never answered
+     * (a claimed-but-rejected or canceled message stays a candidate), deduped
+     * by message id. Empty until an intent exists.
+     */
+    readonly carriedCandidates: readonly CarriedCandidate[];
+    /** The most recently opened turn; user/message events carry no turn of their own. */
+    readonly lastTurn: number;
+    /**
+     * Context-tool calls whose results have not landed yet. Part of the state so
+     * the live unit folds one event at a time and still pairs call to result; a
+     * dangling call at any cut simply never becomes intent or a checkpoint.
+     */
+    readonly openCalls: readonly {
+        readonly callId: string;
+        readonly name: string;
+        readonly arguments: string;
+    }[];
+    /**
+     * Timeline boundaries beyond explicit checkpoints, resolved to their
+     * containing completed turn: handoff deliveries (each generation begins
+     * with one), compaction notices, and Team semantic facts that entered
+     * model context (successful claim-state tool results or structured Team
+     * notification delivery). Each is a structural timeline candidate with the
+     * same completed-turn anchor contract as a checkpoint.
+     */
+    readonly boundaries: readonly TimelineBoundary[];
+    /**
+     * Threads whose first delivery already anchored a boundary. The first
+     * arrival of a Thread's facts is the one preserved push-face anchor; every
+     * later re-delivery of the same Thread is noise and produces no boundary.
+     * Fold-internal by design: cold and live folds replay it identically from
+     * the event log, so no query-time rescan exists.
+     */
+    readonly seenThreads: readonly string[];
+    /** Seq of the latest resolved `turn/end`; the head boundary of the timeline. */
+    readonly lastTurnEndSeq: number;
+}
+/** One non-checkpoint timeline candidate resolved at a completed turn. */
+export interface TimelineBoundary {
+    /** Stable identity for the timeline: kind plus the anchoring event seq. */
+    readonly key: string;
+    /** Which structural source produced this boundary. */
+    readonly source: 'team-boundary' | 'handoff' | 'compaction';
+    /** Human-facing label derived from the boundary's own data. */
+    readonly label: string;
+    /** Seq of the boundary's own anchoring event (delivery or tool result). */
+    readonly seq: number;
+    /** Turn the boundary landed in. */
+    readonly turn: number;
+    /** Seq of the `turn/end` that resolved it; -1 until resolved. */
+    readonly turnEndSeq: number;
+}
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionStateMap {
+        agentTeamContext: AgentTeamContextProjectionState;
+    }
+}
+/**
+ * Deterministic checkpoint ref from the recording session and tool call
+ * identity: a bounded, collision-resistant opaque token. Provider call ids
+ * are arbitrary-length free text that may repeat across generations and even
+ * collide between Sessions, so the ref derives from the SHA-256 of the exact
+ * `(sessionId, callId)` pair — same pair always reproduces the ref, any
+ * other pair is overwhelmingly unlikely to collide, and the token can never
+ * smuggle delimiters or unbounded content through a ref field.
+ */
+export declare function checkpointRefFor(sessionId: string, callId: string): AgentTeamContextCheckpointRef;
+/**
+ * Deterministic default-boundary ref for one delivered Team boundary: the
+ * same session-scoped hash shape as checkpoint refs, keyed on the boundary's
+ * anchoring event seq. Consecutive generations routinely repeat event seqs,
+ * so the Session identity must be part of the key or two generations'
+ * boundaries at the same seq collide — the timeline would silently drop the
+ * ancestor item and a `context_rollover` return would resolve the wrong boundary.
+ */
+export declare function boundaryRefFor(sessionId: string, seq: number): AgentTeamContextCheckpointRef;
+/**
+ * Cold-fold one immutable event log into the projection state. Events at or
+ * before `inheritedEventCount` belong to the fork prefix and are resolved
+ * history in this Session, so they never produce fresh intent. `sessionId` is
+ * the log's own Session identity — it keys checkpoint refs, so the same
+ * provider call id in two different Sessions produces two distinct refs.
+ */
+export declare function foldContextProjection(events: readonly SessionEvent[], inheritedEventCount?: SessionLogOffset, sessionId?: string): AgentTeamContextProjectionState;
+/**
+ * The host-only projection unit; no wire view is published. The definition is
+ * a factory: each Session folds with its own identity so checkpoint refs
+ * derive from that Session's exact `(sessionId, callId)` pairs.
+ */
+export declare const agentTeamContextProjectionDefinition: (sessionId: string) => ProjectionDefinition<"agentTeamContext", AgentTeamContextProjectionState>;
+/** The carried input one transition must deliver: unconsumed post-intent candidates, in queue order. */
+export declare function carriedInputOf(state: AgentTeamContextProjectionState): readonly UserMessage[];
+/** Whether a quiet continuation for one checkpoint was already delivered in this Session. */
+export declare function continuationDelivered(state: AgentTeamContextProjectionState, checkpointRef: AgentTeamContextCheckpointRef): boolean;
+/** Record that a continuation for one checkpoint is scheduled (delivery not yet seen). */
+export declare function withScheduledContinuation(state: AgentTeamContextProjectionState, checkpointRef: AgentTeamContextCheckpointRef): AgentTeamContextProjectionState;
+export { isCheckpointContinuationMessage };
+/** One structural timeline candidate, projection view: anchor plus identity. */
+export interface TimelineCandidate {
+    /** Stable selection ref (checkpoint refs for agent checkpoints; the boundary key otherwise). */
+    readonly ref: string;
+    /** Semantic label: the model-supplied checkpoint name or the boundary label. */
+    readonly label: string;
+    /** Which structural source produced this candidate. */
+    readonly source: 'agent' | 'team-boundary' | 'handoff' | 'compaction' | 'head';
+    /** Seq of the anchoring event (the tool result or delivery message). */
+    readonly seq: number;
+    /** Seq of the completed `turn/end` that resolved the candidate; -1 while unresolved. */
+    readonly turnEndSeq: number;
+}
+/**
+ * Bounded structural timeline candidates, newest first: explicit checkpoints
+ * (resolved only), structural boundaries, then the current head. The Host
+ * prices retained/discarded tokens and applies restorability guards on top;
+ * this view is the single source of candidate anchors and labels.
+ */
+export declare function timelineCandidates(state: AgentTeamContextProjectionState, limit: number): readonly TimelineCandidate[];
+/** Find one resolved checkpoint entry by its stable ref, if it exists. */
+export declare function checkpointByRef(state: AgentTeamContextProjectionState, checkpointRef: string): ContextCheckpointEntry | undefined;
+//# sourceMappingURL=context-projection.d.ts.map

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

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

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

@@ -0,0 +1,117 @@
+/**
+ * Plugin-attributed message sources for Agent Team context management.
+ *
+ * Both sources ride ordinary `UserMessage`s under the shipped `plugin` kind
+ * with the `snapshot` context form — the same shape the Harness's own
+ * system-prompt producer writes. This module declares no `MessageSourceMap`
+ * member of its own, and carries no bespoke source members: Session format
+ * migration validates a `plugin` source against a closed member list
+ * (`kind`, `plugin`, `form`, `sections`, `summary`), and refuses every logged
+ * Session that carries anything else. A plugin-declared kind is type-legal yet
+ * refused the same way. See `docs/dsh-release-compatibility.md`
+ * § "Session message sources".
+ *
+ * Everything the Host needs to read back therefore rides the admitted payload
+ * slots: the handoff envelope and the checkpoint correlation both travel as
+ * named {@link ContextSnapshotSection} contributions, distinguished by their
+ * stable section names. Sections are the format's designed slot for structured
+ * producer payload, and they render as named contributions on any
+ * snapshot-aware surface.
+ *
+ * The validators below are the single place that recognizes these messages, so
+ * callers never match on localized body text.
+ * @module @wowyuarm/dsh-agent-team/context-source
+ */
+import type { ContextSnapshotSection, UserMessage } from '@deepseek-ai/dsh-llm';
+/** Plugin identity attributing every Agent Team message source. */
+export declare const AGENT_TEAM_PLUGIN_ID = "@wowyuarm/dsh-agent-team";
+/** Handoff snapshot section name carrying the model-authored prose. */
+export declare const HANDOFF_SECTION_NAME = "HANDOFF";
+/** Stable section name marking a checkpoint continuation and carrying its ref. */
+export declare const CHECKPOINT_SECTION_NAME = "Checkpoint";
+/** Fixed text of the quiet checkpoint continuation delivered on the next turn. */
+export declare const CHECKPOINT_CONTINUATION_TEXT = "A context checkpoint was recorded at the end of the previous turn. Continue the work you were doing.";
+/**
+ * The rollover handoff envelope: the model-authored prose plus the verifiable
+ * Host facts, all as named snapshot contributions.
+ */
+export interface AgentTeamContextHandoff {
+    /** The Member's Session before this rollover. */
+    readonly previousSessionId: string;
+    /** The rollover generation this handoff opened. */
+    readonly newSessionId: string;
+    /** Why the rollover happened. */
+    readonly trigger: 'model' | 'pressure';
+    /** Seq of the successful `context_rollover` tool result in the previous Session log. */
+    readonly handoffEventSeq: number;
+    /** The checkpoint a return was seeded from; absent on a fresh rollover. */
+    readonly checkpointRef?: string;
+    /** Workspace paths the handoff called out as relevant. */
+    readonly relatedFiles?: readonly string[];
+    /** Named contributions, starting with the model-authored handoff prose. */
+    readonly sections: readonly ContextSnapshotSection[];
+}
+/**
+ * Build the first model-facing context of one rollover generation. The Host
+ * owns only the verifiable envelope; the prose is the Member's own handoff.
+ *
+ * The envelope sections are additive structure, not the only carrier of these
+ * facts: {@link handoffBody} already states them in the model-facing text, so a
+ * surface that renders only the body loses nothing.
+ */
+export declare function createHandoffMessage(input: {
+    readonly handoff: string;
+    readonly previousSessionId: string;
+    readonly newSessionId: string;
+    readonly trigger: 'model' | 'pressure';
+    readonly handoffEventSeq: number;
+    readonly checkpointRef?: string;
+    readonly relatedFiles?: readonly {
+        readonly path: string;
+        readonly reason?: string;
+    }[];
+}): UserMessage;
+/**
+ * Build the quiet follow-up that continues work after an explicit checkpoint
+ * concluded its turn. Delivery is scheduled only after the checkpoint's
+ * successful tool result is durable, so a result-render failure can never
+ * leave a ghost continuation behind.
+ *
+ * This is a `snapshot` rather than a `notice` for one reason: the projection
+ * must read the checkpoint ref back out of the durable log to record delivery,
+ * and `sections` is the only admitted payload slot that carries structure. A
+ * notice would have forced the ref into its human-readable one-line summary.
+ */
+export declare function createCheckpointContinuationMessage(checkpointRef: string): UserMessage;
+/**
+ * The rollover handoff one message carries, when it is one.
+ * @param message - candidate user message.
+ * @returns the envelope, or `undefined` when the message is not a handoff.
+ */
+export declare function handoffOf(message: UserMessage): AgentTeamContextHandoff | undefined;
+/**
+ * The checkpoint ref one continuation notice carries, when the message is one.
+ * @param message - candidate user message.
+ * @returns the checkpoint ref, or `undefined` when the message is not a continuation.
+ */
+export declare function continuationCheckpointRefOf(message: UserMessage): string | undefined;
+/** Whether one user message is a rollover handoff snapshot. */
+export declare function isHandoffMessage(message: UserMessage): boolean;
+/** Whether one user message is a checkpoint continuation, optionally for one checkpoint. */
+export declare function isCheckpointContinuationMessage(message: UserMessage, checkpointRef?: string): boolean;
+/**
+ * Whether one message carries a rollover-handoff or checkpoint-continuation
+ * envelope. Ordinary Team notices share this plugin's attribution, so callers
+ * that replace rederived notices must exclude these two families explicitly.
+ */
+export declare function isAgentTeamContextSource(message: UserMessage): boolean;
+/** Envelope section names; stable, because they are read back from the log.
+ * Exported for the legacy-artifact remediation, which rewrites pre-0.1.10
+ * envelopes into exactly these names — one shared vocabulary, no drift. */
+export declare const HANDOFF_PREVIOUS_SESSION = "Previous session";
+export declare const HANDOFF_NEW_SESSION = "New session";
+export declare const HANDOFF_TRIGGER = "Trigger";
+export declare const HANDOFF_EVENT_SEQ = "Handoff event seq";
+export declare const HANDOFF_CHECKPOINT = "Continued from checkpoint";
+export declare const HANDOFF_RELATED_FILES = "Related files";
+//# sourceMappingURL=context-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-source.d.ts","sourceRoot":"","sources":["../../src/context-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAG/E,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,6BAA6B,CAAA;AAE9D,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,eAAe,CAAA;AAEnD,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,yGAAyG,CAAA;AAElJ;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,iDAAiD;IACjD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAA;IACtC,wFAAwF;IACxF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAA;CACrD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAA;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACvF,GAAG,WAAW,CAUd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mCAAmC,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAUtF;AAsCD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,uBAAuB,GAAG,SAAS,CAwBnF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAKpF;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAE9D;AAED,4FAA4F;AAC5F,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAGrG;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;2EAE2E;AAC3E,eAAO,MAAM,wBAAwB,qBAAqB,CAAA;AAC1D,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAChD,eAAO,MAAM,eAAe,YAAY,CAAA;AACxC,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AACpD,eAAO,MAAM,kBAAkB,8BAA8B,CAAA;AAC7D,eAAO,MAAM,qBAAqB,kBAAkB,CAAA"}