@fishwithcat/dsh-agent 0.2.2-alpha.2 → 0.2.2-alpha.3

package/README.i18n.yaml

@@ -18,8 +18,8 @@
   en: 7d1ae2375bd4fbfc
   zh: b6b4b2e943174cb2
 /deepseek-ai-dsh-agent/use-this-package/create-or-resume-an-agent:
-  en: 26d49c76bce41e30
-  zh: 9710f54e24b190d1
+  en: a62e2d3dd8c32597
+  zh: 646f48ab401d5941
 /deepseek-ai-dsh-agent/use-this-package/select-a-model:
   en: 85b0ff72a187110f
   zh: 3f61c1568d27b8bc

package/README.md

@@ -29,7 +29,7 @@ Mount `dsh-agent` with `dsh-session-projection`: it provides `ctx.agents`, the `
 
 ### Create or resume an agent
 
-`ctx.agents.create()` builds a fresh agent and session under one identity; `ctx.agents.resume()` loads a persisted session and rebuilds the agent on it. Both delegate to the registered factory and return an `AgentHandle` — the only object that can tear that agent down. See [`AgentFactory`](src/index.ts) for publication and failure-cleanup timing. Set `parentAgent` in either operation's options to make the result a runtime child; omit it for a runtime root. `get(id)`, `list()`, and `roots()` find live agents, and `isOwnedBy(id, parent)` tests that exact live relation.
+`ctx.agents.create()` builds a fresh agent and session under one identity; `ctx.agents.resume()` loads a persisted session and rebuilds the agent on it. Both delegate to the registered factory and return an `AgentHandle` — the only object that can tear that agent down. See [`AgentFactory`](src/index.ts) for publication and failure-cleanup timing. `get(id)` and `list()` find live agents. The [subagent service](../../subagent/subagent/README.md) owns delegated execution and runtime tree membership.
 
 ```text
 const handle = await ctx.agents.create({

package/README.zh.md

@@ -29,7 +29,7 @@ kind: "package-reference"
 
 ### 创建或恢复 agent
 
-`ctx.agents.create()` 在一个身份下构建全新 agent 与会话；`ctx.agents.resume()` 加载持久化会话并在此基础上重建 agent。两者都委托给已注册工厂，并返回 `AgentHandle`——唯一能拆除该 agent 的对象。发布和失败清理的时序见 [`AgentFactory`](src/index.ts)。在任一操作的 options 中设置 `parentAgent`，可使结果成为运行时子级；省略它则得到运行时根级。`get(id)`、`list()` 与 `roots()` 用于查找实时 agent；`isOwnedBy(id, parent)` 用于检验这项确切的实时所有权关系。
+`ctx.agents.create()` 在一个身份下构建全新 agent 与会话；`ctx.agents.resume()` 加载持久化会话并在此基础上重建 agent。两者都委托给已注册工厂，并返回 `AgentHandle`——唯一能拆除该 agent 的对象。发布和失败清理的时序见 [`AgentFactory`](src/index.ts)。`get(id)` 与 `list()` 用于查找实时 agent。[subagent 服务](../../subagent/subagent/README.zh.md) 拥有委派执行和运行时树成员关系。
 
 ```text
 const handle = await ctx.agents.create({

package/lib/index.js

@@ -662,7 +662,7 @@ var AgentRegistry = class extends Service {
 	* agent): this constructs the agent and its session. Rejects if no factory is
 	* registered or creation/setup fails. The resolved {@link AgentHandle} lets
 	* the owner tear down exactly this agent.
-	* @param options - shared identity, optional live parent, session seed/metadata, and agent options.
+	* @param options - shared identity, session seed/metadata, and agent options.
 	* @returns the handle after setup, rollback-covered publication, and loop start complete.
 	*/
 	async create(options) {
@@ -675,7 +675,7 @@ var AgentRegistry = class extends Service {
 	* Load a persisted session and resume an agent on it through the registered
 	* factory. Rejects if no factory is registered; the factory rejects if
 	* session persistence is not configured or persistence/setup fails.
-	* @param options - persisted identity, optional live parent, configuration, and setup.
+	* @param options - persisted identity, configuration, and setup.
 	* @returns the handle after setup, rollback-covered publication, and loop start complete.
 	*/
 	async resume(options) {
@@ -691,8 +691,7 @@ var AgentRegistry = class extends Service {
 	* (`scopeTarget(agent, agent)`): the subject is the agent in hand, so the
 	* emits are scope-filtered regardless of which context invoked `register`
 	* (calling through `agent.ctx` scopes EFFECTS; dispatch scoping always
-	* requires passing the carrier). The entry is a runtime root; factory-backed
-	* creation uses `options.parentAgent` for child ownership. Await the registration before using the agent.
+	* requires passing the carrier). Await registration before using the agent.
 	* @param agent - the already-constructed agent to record in the store.
 	* @returns the awaitable Cordis effect disposer (single-shot; a repeat call
 	*   returns undefined without awaiting an in-flight teardown). Exact
@@ -705,7 +704,7 @@ var AgentRegistry = class extends Service {
 	*/
 	register(agent) {
 		return this.ctx.effect(async function* () {
-			yield this.enter(agent, void 0);
+			yield this.enter(agent);
 			await this.announce(agent, "startup");
 		}.bind(this), "agents.register()");
 	}
@@ -716,15 +715,12 @@ var AgentRegistry = class extends Service {
 	* returned detach closure into its pre-installed composite teardown before
 	* calling {@link announce}. Ordinary callers use {@link register}.
 	* @param agent - the prepared, unpublished agent.
-	* @param owner - explicitly supplied live runtime owner, or
-	*   undefined for a top-level runtime root. This is runtime ownership, not
-	*   the resumed session's durable parent lineage.
 	* @returns an idempotent closure that removes this exact entry and emits
 	*   `agent/disposed` with listener failures contained. When called from a
 	*   `agent/created` listener, removal and disposal wait until the serial
 	*   creation dispatch settles.
 	*/
-	enter(agent, owner) {
+	enter(agent) {
 		const id = agent.id;
 		if (id !== agent.session.id) throw new Error(`agent id "${id}" does not match session id "${agent.session.id}"`);
 		const carrier = scopeTarget(agent, agent);
@@ -732,7 +728,6 @@ var AgentRegistry = class extends Service {
 		const entry = {
 			id,
 			agent,
-			owner,
 			carrier,
 			announced: false,
 			announcing: false,
@@ -812,32 +807,12 @@ var AgentRegistry = class extends Service {
 		return this.store.get(id)?.agent;
 	}
 	/**
-	* Test whether a live agent was created through one exact parent agent's
-	* scoped context. Runtime ownership is independent of durable session
-	* lineage and remains unambiguous when unrelated providers reuse an id.
-	* @param id - the candidate child agent's shared agent/session id.
-	* @param owner - the expected runtime creator agent.
-	* @returns true only while the exact child entry is live under that owner.
-	*/
-	isOwnedBy(id, owner) {
-		return this.store.get(id)?.owner === owner;
-	}
-	/**
 	* All live agents, in registration order.
 	* @returns a fresh array; mutating it does not affect the registry.
 	*/
 	list() {
 		return [...this.store.values()].map((entry) => entry.agent);
 	}
-	/**
-	* All live top-level agents in registration order. A top-level agent was
-	* created without an owning agent context; durable session lineage does not
-	* affect this runtime relation, so a resumed fork may still be a root.
-	* @returns a fresh array; mutating it does not affect the registry.
-	*/
-	roots() {
-		return [...this.store.values()].filter((entry) => entry.owner === void 0).map((entry) => entry.agent);
-	}
 	/** Reject new initiator boundaries while inherited continuations drain. */
 	closeInitiators() {
 		if (this.initiatorState === "active") this.initiatorState = "closing";

package/lib/types/index.d.ts

@@ -50,8 +50,6 @@ export type AgentSetup = (agentCtx: Context, agent: Agent) => AgentSetupCommit |
 export interface CreateAgentOptions {
     /** The live agent/session identity. */
     readonly sessionId: SessionId;
-    /** Live parent Agent for runtime ownership; omit for a root Agent. */
-    readonly parentAgent?: Agent;
     /**
      * Session creation metadata: validated absolute `cwd`, `parentSession`
      * fork lineage, the `isSeeded` fork marker, the coarse `origin`
@@ -112,8 +110,6 @@ export interface CreateAgentOptions {
 export interface ResumeAgentOptions {
     /** The persisted session id to load and use as the live agent/session identity. */
     readonly resumeSessionId: SessionId;
-    /** Live parent Agent for runtime ownership; omit for a root Agent. */
-    readonly parentAgent?: Agent;
     /** Route fallback and output controls; see {@link AgentOptions} for live accessor semantics. */
     readonly agentOptions?: AgentOptions;
     /** Optional creation-only cancellation signal for persistence load/setup; detached before return. */
@@ -172,7 +168,7 @@ export interface AgentFactory {
      * transaction and resulting lifecycle to that owner; it must not infer
      * ownership from the factory object's registration context.
      * @param ownerCtx - caller-bound context that owns the transaction and live handle.
-     * @param options - agent/session identity, configuration, optional live parent, and setup.
+     * @param options - agent/session identity, configuration, and setup.
      * @returns the owned handle after setup and both creation announcements complete.
      */
     createAgent(ownerCtx: Context, options: CreateAgentOptions): Promise<AgentHandle>;
@@ -184,7 +180,7 @@ export interface AgentFactory {
      * Initialization cleanup and publication follow the same timing as
      * {@link createAgent}.
      * @param ownerCtx - caller-bound context that owns load, setup, and the live handle.
-     * @param options - persisted identity, configuration, optional live parent, and setup.
+     * @param options - persisted identity, configuration, and setup.
      * @returns the owned handle after setup, both announcements, and loop start complete.
      */
     resume(ownerCtx: Context, options: ResumeAgentOptions): Promise<AgentHandle>;
@@ -287,7 +283,7 @@ export declare class AgentRegistry extends Service {
      * agent): this constructs the agent and its session. Rejects if no factory is
      * registered or creation/setup fails. The resolved {@link AgentHandle} lets
      * the owner tear down exactly this agent.
-     * @param options - shared identity, optional live parent, session seed/metadata, and agent options.
+     * @param options - shared identity, session seed/metadata, and agent options.
      * @returns the handle after setup, rollback-covered publication, and loop start complete.
      */
     create(options: CreateAgentOptions): Promise<AgentHandle>;
@@ -295,7 +291,7 @@ export declare class AgentRegistry extends Service {
      * Load a persisted session and resume an agent on it through the registered
      * factory. Rejects if no factory is registered; the factory rejects if
      * session persistence is not configured or persistence/setup fails.
-     * @param options - persisted identity, optional live parent, configuration, and setup.
+     * @param options - persisted identity, configuration, and setup.
      * @returns the handle after setup, rollback-covered publication, and loop start complete.
      */
     resume(options: ResumeAgentOptions): Promise<AgentHandle>;
@@ -306,8 +302,7 @@ export declare class AgentRegistry extends Service {
      * (`scopeTarget(agent, agent)`): the subject is the agent in hand, so the
      * emits are scope-filtered regardless of which context invoked `register`
      * (calling through `agent.ctx` scopes EFFECTS; dispatch scoping always
-     * requires passing the carrier). The entry is a runtime root; factory-backed
-     * creation uses `options.parentAgent` for child ownership. Await the registration before using the agent.
+     * requires passing the carrier). Await registration before using the agent.
      * @param agent - the already-constructed agent to record in the store.
      * @returns the awaitable Cordis effect disposer (single-shot; a repeat call
      *   returns undefined without awaiting an in-flight teardown). Exact
@@ -326,15 +321,12 @@ export declare class AgentRegistry extends Service {
      * returned detach closure into its pre-installed composite teardown before
      * calling {@link announce}. Ordinary callers use {@link register}.
      * @param agent - the prepared, unpublished agent.
-     * @param owner - explicitly supplied live runtime owner, or
-     *   undefined for a top-level runtime root. This is runtime ownership, not
-     *   the resumed session's durable parent lineage.
      * @returns an idempotent closure that removes this exact entry and emits
      *   `agent/disposed` with listener failures contained. When called from a
      *   `agent/created` listener, removal and disposal wait until the serial
      *   creation dispatch settles.
      */
-    enter(agent: Agent, owner: Agent | undefined): () => void;
+    enter(agent: Agent): () => void;
     /** Remove one exact entered agent and emit its paired disposal when announced. */
     private detachEntered;
     /** Emit the paired disposal edge through the entry's stable carrier. */
@@ -356,27 +348,11 @@ export declare class AgentRegistry extends Service {
      * @returns the agent, or undefined when no live agent has that id.
      */
     get(id: SessionId): Agent | undefined;
-    /**
-     * Test whether a live agent was created through one exact parent agent's
-     * scoped context. Runtime ownership is independent of durable session
-     * lineage and remains unambiguous when unrelated providers reuse an id.
-     * @param id - the candidate child agent's shared agent/session id.
-     * @param owner - the expected runtime creator agent.
-     * @returns true only while the exact child entry is live under that owner.
-     */
-    isOwnedBy(id: SessionId, owner: Agent): boolean;
     /**
      * All live agents, in registration order.
      * @returns a fresh array; mutating it does not affect the registry.
      */
     list(): Agent[];
-    /**
-     * All live top-level agents in registration order. A top-level agent was
-     * created without an owning agent context; durable session lineage does not
-     * affect this runtime relation, so a resumed fork may still be a root.
-     * @returns a fresh array; mutating it does not affect the registry.
-     */
-    roots(): Agent[];
     /** Reject new initiator boundaries while inherited continuations drain. */
     private closeInitiators;
     /** Wait for returned-Promise boundaries, then invalidate retained references. */

package/lib/types/index.js

@@ -185,7 +185,7 @@ export class AgentRegistry extends Service {
      * agent): this constructs the agent and its session. Rejects if no factory is
      * registered or creation/setup fails. The resolved {@link AgentHandle} lets
      * the owner tear down exactly this agent.
-     * @param options - shared identity, optional live parent, session seed/metadata, and agent options.
+     * @param options - shared identity, session seed/metadata, and agent options.
      * @returns the handle after setup, rollback-covered publication, and loop start complete.
      */
     async create(options) {
@@ -203,7 +203,7 @@ export class AgentRegistry extends Service {
      * Load a persisted session and resume an agent on it through the registered
      * factory. Rejects if no factory is registered; the factory rejects if
      * session persistence is not configured or persistence/setup fails.
-     * @param options - persisted identity, optional live parent, configuration, and setup.
+     * @param options - persisted identity, configuration, and setup.
      * @returns the handle after setup, rollback-covered publication, and loop start complete.
      */
     async resume(options) {
@@ -220,8 +220,7 @@ export class AgentRegistry extends Service {
      * (`scopeTarget(agent, agent)`): the subject is the agent in hand, so the
      * emits are scope-filtered regardless of which context invoked `register`
      * (calling through `agent.ctx` scopes EFFECTS; dispatch scoping always
-     * requires passing the carrier). The entry is a runtime root; factory-backed
-     * creation uses `options.parentAgent` for child ownership. Await the registration before using the agent.
+     * requires passing the carrier). Await registration before using the agent.
      * @param agent - the already-constructed agent to record in the store.
      * @returns the awaitable Cordis effect disposer (single-shot; a repeat call
      *   returns undefined without awaiting an in-flight teardown). Exact
@@ -234,7 +233,7 @@ export class AgentRegistry extends Service {
      */
     register(agent) {
         return this.ctx.effect(async function* () {
-            yield this.enter(agent, undefined);
+            yield this.enter(agent);
             await this.announce(agent, 'startup');
         }.bind(this), 'agents.register()');
     }
@@ -245,15 +244,12 @@ export class AgentRegistry extends Service {
      * returned detach closure into its pre-installed composite teardown before
      * calling {@link announce}. Ordinary callers use {@link register}.
      * @param agent - the prepared, unpublished agent.
-     * @param owner - explicitly supplied live runtime owner, or
-     *   undefined for a top-level runtime root. This is runtime ownership, not
-     *   the resumed session's durable parent lineage.
      * @returns an idempotent closure that removes this exact entry and emits
      *   `agent/disposed` with listener failures contained. When called from a
      *   `agent/created` listener, removal and disposal wait until the serial
      *   creation dispatch settles.
      */
-    enter(agent, owner) {
+    enter(agent) {
         const id = agent.id;
         if (id !== agent.session.id) {
             throw new Error(`agent id "${id}" does not match session id "${agent.session.id}"`);
@@ -266,7 +262,6 @@ export class AgentRegistry extends Service {
         const entry = {
             id,
             agent,
-            owner,
             carrier,
             announced: false,
             announcing: false,
@@ -366,17 +361,6 @@ export class AgentRegistry extends Service {
     get(id) {
         return this.store.get(id)?.agent;
     }
-    /**
-     * Test whether a live agent was created through one exact parent agent's
-     * scoped context. Runtime ownership is independent of durable session
-     * lineage and remains unambiguous when unrelated providers reuse an id.
-     * @param id - the candidate child agent's shared agent/session id.
-     * @param owner - the expected runtime creator agent.
-     * @returns true only while the exact child entry is live under that owner.
-     */
-    isOwnedBy(id, owner) {
-        return this.store.get(id)?.owner === owner;
-    }
     /**
      * All live agents, in registration order.
      * @returns a fresh array; mutating it does not affect the registry.
@@ -384,17 +368,6 @@ export class AgentRegistry extends Service {
     list() {
         return [...this.store.values()].map(entry => entry.agent);
     }
-    /**
-     * All live top-level agents in registration order. A top-level agent was
-     * created without an owning agent context; durable session lineage does not
-     * affect this runtime relation, so a resumed fork may still be a root.
-     * @returns a fresh array; mutating it does not affect the registry.
-     */
-    roots() {
-        return [...this.store.values()]
-            .filter(entry => entry.owner === undefined)
-            .map(entry => entry.agent);
-    }
     /** Reject new initiator boundaries while inherited continuations drain. */
     closeInitiators() {
         if (this.initiatorState === 'active')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fishwithcat/dsh-agent",
   "description": "Agent interface, registry, initiator scope, and event vocabulary for the DeepSeek Harness",
-  "version": "0.2.2-alpha.2",
+  "version": "0.2.2-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -34,15 +34,15 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-scope": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-util-values": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-workspace": "0.2.2-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.6-alpha.1"
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-scope": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-workspace": "0.2.2-alpha.3",
+    "@deepseek-ai/cordis": "~4.0.6-alpha.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-workspace": {
@@ -50,19 +50,19 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-scope": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-typert-registry": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-util-values": "0.2.2-alpha.2",
-    "@deepseek-ai/dsh-workspace": "0.2.2-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.6-alpha.1"
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-scope": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-typert-registry": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.2-alpha.3",
+    "@deepseek-ai/dsh-workspace": "0.2.2-alpha.3",
+    "@deepseek-ai/cordis": "~4.0.6-alpha.2"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-brand": "0.2.2-alpha.3",
     "zod": "4.4.3"
   }
 }