pi-fabric 0.92.3 → 0.92.5

package/dist/agents/service-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-provider.d.ts","sourceRoot":"","sources":["../../src/agents/service-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAsB,wBAAwB,EAAE,kBAAkB,EAAE,sBAAsB,EAA0C,MAAM,oBAAoB,CAAC;AAE3K,0FAA0F;AAC1F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAgBzG;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,YAAY,GAAE,wBAA6B,GAAG,kBAAkB,CAc1I;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAc/E"}
+{"version":3,"file":"service-provider.d.ts","sourceRoot":"","sources":["../../src/agents/service-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAsB,wBAAwB,EAAE,kBAAkB,EAAE,sBAAsB,EAA8D,MAAM,oBAAoB,CAAC;AAE/L,0FAA0F;AAC1F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAuBzG;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,YAAY,GAAE,wBAA6B,GAAG,kBAAkB,CAqB1I;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAc/E"}

package/dist/agents/service-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-schema.d.ts","sourceRoot":"","sources":["../../src/agents/service-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAwB5G,wBAAgB,uBAAuB,CAAC,YAAY,GAAE,wBAA6B,GAAG,sBAAsB,EAAE,CAW7G;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASpH;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,CAO5F"}
+{"version":3,"file":"service-schema.d.ts","sourceRoot":"","sources":["../../src/agents/service-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAyB5G,wBAAgB,uBAAuB,CAAC,YAAY,GAAE,wBAA6B,GAAG,sBAAsB,EAAE,CAsB7G;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASpH;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,CAS5F"}

package/dist/agents/service-types.d.ts

@@ -4,6 +4,7 @@ export type AgentServiceRequest = Pick<AgentRunRequest, "task" | "name" | "model
     kernel?: "typescript" | "inherit";
     extensions?: true;
     worktree?: false;
+    residency?: "session" | "durable";
 };
 export type AgentServiceStatus = AgentRunRecord["status"] | "paused";
 export type AgentServiceRecord = Omit<AgentRunRecord, "status" | "transport" | "cwd"> & {
@@ -66,23 +67,73 @@ export interface AgentExecutionPort {
     steer?(request: AgentControlRequest & {
         message: string;
     }): Promise<void>;
+    followUp?(request: AgentControlRequest & {
+        message: string;
+    }): Promise<void>;
     compact?(request: AgentControlRequest & {
         instructions?: string;
     }): Promise<void>;
     cleanup?(request: AgentControlRequest): Promise<void>;
 }
-export type AgentServiceAction = "run" | "spawn" | "wait" | "status" | "list" | "stop" | "steer" | "compact" | "resume";
+/** Host-authored session/peer identity. Same shape the native mesh publishes for roots. */
+export type AgentSessionKind = "root" | "agent" | "actor";
+export type AgentSessionCapability = "steer" | "followUp" | "stop" | "ask";
+export interface AgentSessionRecord {
+    id: string;
+    name: string;
+    kind: AgentSessionKind;
+    status: string;
+    capabilities: AgentSessionCapability[];
+}
+export interface AgentTopologyDeliverRequest {
+    callerId: string;
+    id: string;
+    operation: "steer" | "followUp";
+    message: string;
+    signal?: AbortSignal;
+}
+export interface AgentTopologyCreateRequest {
+    callerId: string;
+    name: string;
+    instructions?: string;
+    task?: string;
+    signal?: AbortSignal;
+}
+export interface AgentTopologyRemoveRequest {
+    callerId: string;
+    id: string;
+    name?: string;
+    signal?: AbortSignal;
+}
+export interface AgentTopologyDispatchRequest {
+    callerId: string;
+    request: AgentServiceRequest;
+    signal?: AbortSignal;
+}
+/** Host directory of live session agents and peers. Child one-shots stay on AgentExecutionPort. */
+export interface AgentTopologyPort {
+    self(callerId: string): AgentSessionRecord | Promise<AgentSessionRecord>;
+    sessions(): AgentSessionRecord[] | Promise<AgentSessionRecord[]>;
+    peers(callerId: string): AgentSessionRecord[] | Promise<AgentSessionRecord[]>;
+    deliver(request: AgentTopologyDeliverRequest): Promise<AgentSessionRecord>;
+    create?(request: AgentTopologyCreateRequest): Promise<AgentSessionRecord>;
+    remove?(request: AgentTopologyRemoveRequest): Promise<AgentSessionRecord>;
+    dispatch?(request: AgentTopologyDispatchRequest): Promise<AgentSessionRecord>;
+}
+export type AgentServiceAction = "run" | "spawn" | "wait" | "status" | "list" | "stop" | "steer" | "compact" | "resume" | "followUp" | "sessions" | "peers" | "self" | "members" | "create" | "remove";
 export interface AgentServiceCapabilities {
     steer?: boolean;
     compact?: boolean;
     resume?: boolean;
+    followUp?: boolean;
+    topology?: boolean;
 }
 export interface AgentServiceEvent {
     version: 1;
     sequence: number;
     type: "admitted" | "running" | "progress" | "checkpoint" | "settled" | "control";
     record: AgentServiceRecord;
-    control?: "stop" | "steer" | "compact";
+    control?: "stop" | "steer" | "compact" | "followUp";
 }
 export interface AgentServiceSnapshot {
     version: 1;
@@ -107,6 +158,7 @@ export interface AgentServiceOptions {
     assertAuthority?(callerId: string, boundary?: AgentAuthorityBoundary): void | Promise<void>;
     onEvent?(event: AgentServiceEvent): void | Promise<void>;
     snapshot?: AgentServiceSnapshot;
+    topology?: AgentTopologyPort;
     /** Trusted host only: a new root turn rebases lineage and resets admission, never generations. */
     restorePolicy?: "preserve" | "new-root";
 }
@@ -120,8 +172,19 @@ export interface AgentServiceClient {
     status(id: string): Promise<AgentPublicRecord>;
     list(): Promise<AgentPublicRecord[]>;
     stop(id: string): Promise<AgentPublicRecord>;
-    steer(id: string, message: string): Promise<AgentPublicRecord>;
+    steer(id: string, message: string): Promise<AgentPublicRecord | AgentSessionRecord>;
     compact(id: string, instructions?: string): Promise<AgentPublicRecord>;
     resume(id: string, task?: string, signal?: AbortSignal): Promise<AgentPublicRecord>;
+    followUp(id: string, message: string): Promise<AgentPublicRecord | AgentSessionRecord>;
+    sessions(): Promise<AgentSessionRecord[]>;
+    peers(): Promise<AgentSessionRecord[]>;
+    self(): Promise<AgentSessionRecord>;
+    members(): Promise<AgentSessionRecord[]>;
+    create(request: {
+        name: string;
+        instructions?: string;
+        task?: string;
+    }, signal?: AbortSignal): Promise<AgentSessionRecord>;
+    remove(id: string, name?: string, signal?: AbortSignal): Promise<AgentSessionRecord>;
 }
 //# sourceMappingURL=service-types.d.ts.map

package/dist/agents/service-types.d.ts.map

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

package/dist/agents/service.d.ts

@@ -1,4 +1,4 @@
-import type { AgentPublicRecord, AgentServiceCapabilities, AgentServiceOptions, AgentServiceRequest, AgentServiceSnapshot } from "./service-types.js";
+import type { AgentPublicRecord, AgentServiceCapabilities, AgentServiceOptions, AgentServiceRequest, AgentSessionRecord, AgentServiceSnapshot } from "./service-types.js";
 /** Portable one-shot agent authority. The execution port runs one participant, never a tree. */
 export declare class AgentService {
     #private;
@@ -6,12 +6,23 @@ export declare class AgentService {
     constructor(options: AgentServiceOptions);
     snapshot(): AgentServiceSnapshot;
     run(callerId: string, request: AgentServiceRequest, signal?: AbortSignal): Promise<AgentPublicRecord>;
-    spawn(callerId: string, request: AgentServiceRequest, signal?: AbortSignal): Promise<AgentPublicRecord>;
+    spawn(callerId: string, request: AgentServiceRequest, signal?: AbortSignal): Promise<AgentPublicRecord | AgentSessionRecord>;
     wait(callerId: string, id: string, signal?: AbortSignal): Promise<AgentPublicRecord>;
     status(callerId: string, id: string): Promise<AgentPublicRecord>;
     list(callerId: string): Promise<AgentPublicRecord[]>;
     stop(callerId: string, id: string): Promise<AgentPublicRecord>;
-    steer(callerId: string, id: string, message: string): Promise<AgentPublicRecord>;
+    steer(callerId: string, id: string, message: string): Promise<AgentPublicRecord | AgentSessionRecord>;
+    followUp(callerId: string, id: string, message: string): Promise<AgentPublicRecord | AgentSessionRecord>;
+    sessions(callerId: string): Promise<AgentSessionRecord[]>;
+    peers(callerId: string): Promise<AgentSessionRecord[]>;
+    self(callerId: string): Promise<AgentSessionRecord>;
+    create(callerId: string, request: {
+        name: string;
+        instructions?: string;
+        task?: string;
+    }, signal?: AbortSignal): Promise<AgentSessionRecord>;
+    remove(callerId: string, id: string, name?: string, signal?: AbortSignal): Promise<AgentSessionRecord>;
+    members(callerId: string): Promise<AgentSessionRecord[]>;
     compact(callerId: string, id: string, instructions?: string): Promise<AgentPublicRecord>;
     resume(callerId: string, id: string, task?: string, signal?: AbortSignal): Promise<AgentPublicRecord>;
     /** Natural root completion waits for all background descendants without fencing live parents. */

package/dist/agents/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/agents/service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA0B,iBAAiB,EAAoE,wBAAwB,EAAqB,mBAAmB,EAAsB,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAyBvR,gGAAgG;AAChG,qBAAa,YAAY;;IAWvB,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;gBAEpC,OAAO,EAAE,mBAAmB;IAWxC,QAAQ,IAAI,oBAAoB;IAK1B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKrG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIvG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASpF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKhE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKpD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO9D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMhF,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKxF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAa3G,iGAAiG;IAC3F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,8FAA8F;IAC9F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAqRvB"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/agents/service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA0B,iBAAiB,EAAoE,wBAAwB,EAAqB,mBAAmB,EAAsB,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAyB3S,gGAAgG;AAChG,qBAAa,YAAY;;IAWvB,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;gBAEpC,OAAO,EAAE,mBAAmB;IAiBxC,QAAQ,IAAI,oBAAoB;IAK1B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKrG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,kBAAkB,CAAC;IAa5H,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASpF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKhE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKpD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAO9D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,kBAAkB,CAAC;IAUrG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,kBAAkB,CAAC;IAgBxG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKzD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKtD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAanD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAU5I,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUtG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkBxD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKxF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAa3G,iGAAiG;IAC3F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,8FAA8F;IAC9F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAwSvB"}

package/dist/agents.js

@@ -42,18 +42,30 @@ Object.assign(properties, {
   systemPrompt: { type: "string" }
 });
 var runSchema = { type: "object", properties, required: ["task"], additionalProperties: false };
+var spawnSchema = { type: "object", properties: { ...properties, residency: { type: "string", enum: ["session", "durable"] } }, required: ["task"], additionalProperties: false };
 var id = { type: "string", minLength: 1 };
 var object = (properties2, required = []) => ({ type: "object", properties: properties2, required, additionalProperties: false });
 function agentServiceDescriptors(capabilities = {}) {
   const descriptors2 = [
     { ...run, description: "Run one host-authorized Pi child and wait for its result or pause", inputSchema: runSchema },
-    { ...native("spawn"), description: "Admit one host-authorized Pi child and return its record", inputSchema: runSchema },
+    { ...native("spawn"), description: "Admit one host-authorized Pi child, or residency durable for an independent host worker", inputSchema: spawnSchema },
     ...["wait", "status", "stop"].map((name) => ({ ...native(name), inputSchema: object({ id }, ["id"]) })),
     { ...native("list"), description: "List only the authenticated caller's direct children", inputSchema: object({}) }
   ];
   if (capabilities.steer) descriptors2.push({ ...native("steer"), inputSchema: object({ id, message: { type: "string", minLength: 1 } }, ["id", "message"]) });
+  if (capabilities.followUp) descriptors2.push({ ...native("followUp"), inputSchema: object({ id, message: { type: "string", minLength: 1 } }, ["id", "message"]) });
   if (capabilities.compact) descriptors2.push({ ...native("compact"), inputSchema: object({ id, instructions: { type: "string" } }, ["id"]) });
   if (capabilities.resume) descriptors2.push({ name: "resume", description: "Continue a paused, completed or failed direct child from its host checkpoint and wait for result or pause", risk: "agent", inputSchema: object({ id, task: { type: "string", minLength: 1 } }, ["id"]) });
+  if (capabilities.topology) {
+    descriptors2.push(
+      { ...native("sessions"), inputSchema: object({}) },
+      { ...native("peers"), inputSchema: object({}) },
+      { ...native("self"), inputSchema: object({}) },
+      { ...native("members"), inputSchema: object({}) },
+      { ...native("create"), description: "Create a lasting session peer in this project", inputSchema: object({ name: { type: "string", minLength: 1 }, instructions: { type: "string" }, task: { type: "string" } }, ["name"]) },
+      { ...native("remove"), description: "Stop and remove a lasting session peer created in this project", inputSchema: object({ id: { type: "string", minLength: 1 }, name: { type: "string" } }, ["id"]) }
+    );
+  }
   return descriptors2;
 }
 var descriptors = agentServiceDescriptors({ steer: true, compact: true, resume: true });
@@ -69,10 +81,12 @@ function agentServiceArgs(action, input) {
   return args;
 }
 function normalizeAgentServiceRequest(input) {
-  const args = agentServiceArgs("run", input);
+  const { residency, ...rest } = input;
+  const args = agentServiceArgs("run", rest);
   const request = normalizeAgentRunRequest(args, { runner: "pi", timeoutMs: 0 });
   if (args.images !== void 0) request.images = structuredClone(args.images);
   if (args.systemPrompt !== void 0) request.systemPrompt = args.systemPrompt;
+  if (residency === "session" || residency === "durable") request.residency = residency;
   assertAgentTask(request);
   return structuredClone(request);
 }
@@ -105,7 +119,13 @@ var AgentService = class {
     }
     this.#options = { ...options, port: options.port };
     this.#admission = new AgentAdmission(options.maxConcurrent ?? 4, options.maxStarts ?? 8, options.maxDepth ?? 3);
-    this.capabilities = Object.freeze({ steer: Boolean(options.port.steer), compact: Boolean(options.port.compact), resume: Boolean(options.port.resume) });
+    this.capabilities = Object.freeze({
+      steer: Boolean(options.port.steer || options.topology),
+      compact: Boolean(options.port.compact),
+      resume: Boolean(options.port.resume),
+      followUp: Boolean(options.port.followUp || options.topology),
+      topology: Boolean(options.topology)
+    });
     if (options.snapshot) this.#restore(options.snapshot);
   }
   snapshot() {
@@ -122,7 +142,16 @@ var AgentService = class {
     return this.wait(callerId, handle.id, signal);
   }
   async spawn(callerId, request, signal) {
-    return this.#start(callerId, normalizeAgentServiceRequest(request), void 0, signal);
+    const normalized = normalizeAgentServiceRequest(request);
+    if (normalized.residency === "durable") {
+      await this.#authorize(callerId);
+      const dispatch = this.#topology().dispatch;
+      if (!dispatch) throw new Error("Durable hosted spawn is unavailable");
+      const record = await dispatch({ callerId, request: normalized, ...signal ? { signal } : {} });
+      await this.#authorize(callerId);
+      return copy(record);
+    }
+    return this.#start(callerId, normalized, void 0, signal);
   }
   async wait(callerId, id2, signal) {
     await this.#authorize(callerId);
@@ -147,9 +176,83 @@ var AgentService = class {
     return publicRecord(result);
   }
   async steer(callerId, id2, message) {
-    if (!this.#options.port.steer) throw new Error("Hosted agents.steer is unsupported");
     if (!message.trim()) throw new Error("Steering message must not be empty");
-    return this.#control(callerId, id2, "steer", (request) => this.#options.port.steer({ ...request, message }));
+    const child = this.#ownedChild(callerId, id2);
+    if (child) {
+      if (!this.#options.port.steer) throw new Error("Hosted agents.steer is unsupported");
+      return this.#control(callerId, child.record.id, "steer", (request) => this.#options.port.steer({ ...request, message }));
+    }
+    return this.#deliver(callerId, id2, "steer", message);
+  }
+  async followUp(callerId, id2, message) {
+    if (!message.trim()) throw new Error("Follow-up message must not be empty");
+    const child = this.#ownedChild(callerId, id2);
+    if (child) {
+      if (!this.#options.port.followUp) throw new Error("Hosted agents.followUp is unsupported");
+      if (child.record.status === "running" && !child.stopping) {
+        return this.#control(callerId, child.record.id, "followUp", (request) => this.#options.port.followUp({ ...request, message }));
+      }
+      await this.#authorize(callerId);
+      await this.#options.port.followUp({ ...this.#identity(child), message });
+      await this.#authorize(callerId);
+      return publicRecord(child.record);
+    }
+    return this.#deliver(callerId, id2, "followUp", message);
+  }
+  async sessions(callerId) {
+    await this.#authorize(callerId);
+    return copy(await this.#topology().sessions());
+  }
+  async peers(callerId) {
+    await this.#authorize(callerId);
+    return copy(await this.#topology().peers(callerId));
+  }
+  async self(callerId) {
+    await this.#authorize(callerId);
+    if (this.#options.topology) return copy(await this.#options.topology.self(callerId));
+    const child = callerId === this.#options.rootId ? void 0 : this.#entries.get(callerId);
+    return {
+      id: callerId,
+      name: child?.record.name ?? "main",
+      kind: callerId === this.#options.rootId ? "root" : "agent",
+      status: child?.record.status ?? "running",
+      capabilities: callerId === this.#options.rootId ? ["steer", "followUp", "stop"] : ["steer", "followUp", "stop"]
+    };
+  }
+  async create(callerId, request, signal) {
+    if (!request.name.trim()) throw new Error("Peer name is required");
+    await this.#authorize(callerId);
+    const create = this.#topology().create;
+    if (!create) throw new Error("Hosted agents.create is unavailable");
+    const record = await create({ callerId, name: request.name.trim(), ...request.instructions ? { instructions: request.instructions } : {}, ...request.task ? { task: request.task } : {}, ...signal ? { signal } : {} });
+    await this.#authorize(callerId);
+    return copy(record);
+  }
+  async remove(callerId, id2, name, signal) {
+    if (!id2.trim()) throw new Error("Peer id is required");
+    await this.#authorize(callerId);
+    const remove = this.#topology().remove;
+    if (!remove) throw new Error("Hosted agents.remove is unavailable");
+    const record = await remove({ callerId, id: id2, ...name ? { name } : {}, ...signal ? { signal } : {} });
+    await this.#authorize(callerId);
+    return copy(record);
+  }
+  async members(callerId) {
+    await this.#authorize(callerId);
+    const sessions = this.#options.topology ? copy(await this.#options.topology.sessions()) : [];
+    const seen = new Set(sessions.map((item) => item.id));
+    const children = [];
+    for (const entry of this.#entries.values()) {
+      if (seen.has(entry.record.id)) continue;
+      children.push({
+        id: entry.record.id,
+        name: entry.record.name,
+        kind: "agent",
+        status: entry.record.status,
+        capabilities: ["steer", "followUp", "stop"]
+      });
+    }
+    return [...sessions, ...children];
   }
   async compact(callerId, id2, instructions) {
     if (!this.#options.port.compact) throw new Error("Hosted agents.compact is unsupported");
@@ -477,10 +580,26 @@ var AgentService = class {
     if (this.#suspended && !boundary?.checkpoint) throw new Error("Agent service is paused");
   }
   #child(callerId, id2) {
-    const entry = this.#entries.get(id2);
-    if (!entry || entry.record.parentId !== callerId) throw new Error(`Unknown direct child agent: ${id2}`);
+    const entry = this.#ownedChild(callerId, id2);
+    if (!entry) throw new Error(`Unknown direct child agent: ${id2}`);
     return entry;
   }
+  #ownedChild(callerId, id2) {
+    const entry = this.#entries.get(id2);
+    return entry && entry.record.parentId === callerId ? entry : void 0;
+  }
+  #topology() {
+    if (!this.#options.topology) throw new Error("Hosted agent topology is unavailable");
+    return this.#options.topology;
+  }
+  async #deliver(callerId, id2, operation, message) {
+    const topology = this.#topology();
+    await this.#authorize(callerId);
+    const target = id2 === "main" ? this.#options.rootId : id2;
+    const record = await topology.deliver({ callerId, id: target, operation, message });
+    await this.#authorize(callerId);
+    return copy(record);
+  }
   #depth(callerId) {
     if (this.#closing.signal.aborted) throw new Error("Agent service is closed");
     if (this.#suspended) throw new Error("Agent service is paused");
@@ -560,10 +679,24 @@ function createAgentServiceHandler(service, callerId) {
         return service.stop(callerId, args.id);
       case "steer":
         return service.steer(callerId, args.id, args.message);
+      case "followUp":
+        return service.followUp(callerId, args.id, args.message);
       case "compact":
         return service.compact(callerId, args.id, args.instructions);
       case "resume":
         return service.resume(callerId, args.id, args.task, signal);
+      case "sessions":
+        return service.sessions(callerId);
+      case "peers":
+        return service.peers(callerId);
+      case "self":
+        return service.self(callerId);
+      case "members":
+        return service.members(callerId);
+      case "create":
+        return service.create(callerId, args, signal);
+      case "remove":
+        return service.remove(callerId, args.id, args.name, signal);
       default:
         throw new Error(`Unsupported hosted agents action: ${String(action)}`);
     }
@@ -582,7 +715,14 @@ function createAgentServiceClient(dispatch, capabilities = {}) {
     stop: (id2) => record("stop", { id: id2 }),
     steer: (id2, message) => record("steer", { id: id2, message }),
     compact: (id2, instructions) => record("compact", { id: id2, ...instructions !== void 0 ? { instructions } : {} }),
-    resume: (id2, task, signal) => record("resume", { id: id2, ...task !== void 0 ? { task } : {} }, signal)
+    resume: (id2, task, signal) => record("resume", { id: id2, ...task !== void 0 ? { task } : {} }, signal),
+    followUp: (id2, message) => record("followUp", { id: id2, message }),
+    sessions: () => dispatch("sessions", {}),
+    peers: () => dispatch("peers", {}),
+    self: () => dispatch("self", {}),
+    members: () => dispatch("members", {}),
+    create: (request, signal) => dispatch("create", request, signal),
+    remove: (id2, name, signal) => dispatch("remove", { id: id2, ...name !== void 0 ? { name } : {} }, signal)
   };
 }
 function createAgentsProvider(client) {