@yanlinglabs/winter-agent-runtime 0.0.38 → 0.0.39

package/dist/embedded-worker.js

@@ -1,4 +1,4 @@
-import"./index-5xe59vkt.js";
+import"./index-dh2xed37.js";
 import {
   liveProcessGroups,
   onProcessGroupChange
@@ -6,10 +6,10 @@ import {
 import"./index-mwew595z.js";
 import"./index-2wgfv0pa.js";
 import"./index-bef62z3r.js";
-import"./index-z3970wsj.js";
+import"./index-es0skt5n.js";
 import {
   runEmbeddedSession2
-} from "./index-8x4yjdg7.js";
+} from "./index-b08mghw8.js";
 import {
   Queue
 } from "./index-97t2rmtf.js";

package/dist/embedded.js

@@ -1,8 +1,8 @@
 import {
   runEmbeddedSession2
-} from "./index-8x4yjdg7.js";
-import"./index-z3970wsj.js";
-import"./index-5xe59vkt.js";
+} from "./index-b08mghw8.js";
+import"./index-es0skt5n.js";
+import"./index-dh2xed37.js";
 import"./index-2wgfv0pa.js";
 import"./index-bef62z3r.js";
 import"./index-1hef2gff.js";

package/dist/{index-8x4yjdg7.js → index-b08mghw8.js}

@@ -9,14 +9,14 @@ import {
   resolveEngineSession2,
   resolveProductionWinterHome2,
   resolveProductionStoreHome
-} from "./index-5xe59vkt.js";
+} from "./index-dh2xed37.js";
 import {
   registerDefaultChildEngineFactory,
   loadResumedChain,
   buildProductionWiring,
   withAutoSkillPermissions,
   restoreChildRoster
-} from "./index-z3970wsj.js";
+} from "./index-es0skt5n.js";
 
 // src/embedded.ts
 import { splitFrames, encodeFrame } from "@yanlinglabs/winter-agent-sdk";

package/dist/{index-5xe59vkt.js → index-dh2xed37.js}

@@ -5155,7 +5155,25 @@ function createDefaultMessagingRuntime(opts = {}) {
     subscribers,
     now
   });
-  return { seam, adapter, notifications, loopGuard: createLoopGuard(), subscribers, now, peers, classifyDeliveryError };
+  const hostPorts = new Map;
+  return {
+    seam,
+    adapter,
+    notifications,
+    loopGuard: createLoopGuard(),
+    subscribers,
+    now,
+    peers,
+    classifyDeliveryError,
+    hostMessaging: (sessionId) => hostPorts.get(sessionId),
+    registerHostMessagingPort(sessionId, port) {
+      hostPorts.set(sessionId, port);
+      return () => {
+        if (hostPorts.get(sessionId) === port)
+          hostPorts.delete(sessionId);
+      };
+    }
+  };
 }
 function getDefaultMessagingRuntime() {
   const runtime = getMessagingRuntime();
@@ -7394,6 +7412,40 @@ function transformChildFrame(frame, correlation, forwardSubagentText) {
 }
 var SESSION_LEVEL_SYSTEM_SUBTYPES = new Set(["task_started", "task_progress", "task_notification", "task_updated", "background_tasks_changed"]);
 
+// src/messaging/host-port.ts
+import { HOST_MESSAGE_LIST_SUBTYPE, HOST_MESSAGE_SEND_SUBTYPE, HOST_SESSION_STOP_SUBTYPE } from "@yanlinglabs/winter-agent-sdk";
+import { isHostMessageSendAnswer, isHostSessionStopAnswer, normaliseHostMessageListAnswer } from "@yanlinglabs/winter-agent-sdk/messaging";
+var HOST_MESSAGE_SEND_TIMEOUT_MS = 180000;
+var HOST_MESSAGE_LIST_TIMEOUT_MS = 15000;
+var HOST_SESSION_STOP_TIMEOUT_MS = 30000;
+
+class HostMessagingAnswerError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "HostMessagingAnswerError";
+  }
+}
+function createHostMessagingPort(sender) {
+  return {
+    async send(request, opts) {
+      const answer = await sender.request(HOST_MESSAGE_SEND_SUBTYPE, request, { timeoutMs: HOST_MESSAGE_SEND_TIMEOUT_MS, ...opts?.signal !== undefined ? { signal: opts.signal } : {} });
+      if (!isHostMessageSendAnswer(answer))
+        throw new HostMessagingAnswerError("the host answered host_message_send with a malformed outcome");
+      return answer;
+    },
+    async list(request, opts) {
+      const answer = await sender.request(HOST_MESSAGE_LIST_SUBTYPE, request, { timeoutMs: HOST_MESSAGE_LIST_TIMEOUT_MS, ...opts?.signal !== undefined ? { signal: opts.signal } : {} });
+      return normaliseHostMessageListAnswer(answer) ?? { sessions: [] };
+    },
+    async stop(request, opts) {
+      const answer = await sender.request(HOST_SESSION_STOP_SUBTYPE, request, { timeoutMs: HOST_SESSION_STOP_TIMEOUT_MS, ...opts?.signal !== undefined ? { signal: opts.signal } : {} });
+      if (!isHostSessionStopAnswer(answer))
+        throw new HostMessagingAnswerError("the host answered host_session_stop with a malformed answer");
+      return answer;
+    }
+  };
+}
+
 // src/permissions/ruleset.ts
 import {
   readFileSync as readFileSync6,
@@ -18802,6 +18854,7 @@ replaceExecutor("TaskOutput", taskOutputExecutor);
 
 // src/tools/impl/task-stop.ts
 import { randomUUID as randomUUID15 } from "node:crypto";
+import { boundedHostNote } from "@yanlinglabs/winter-agent-sdk/messaging";
 function parseTaskStopInput(input) {
   if (typeof input !== "object" || input === null)
     return { error: "TaskStop: input must be an object" };
@@ -18831,6 +18884,9 @@ var taskStopExecutor = {
     const id = parsed.task_id ?? parsed.shell_id;
     const task = getTask(id);
     if (!task) {
+      const host = getMessagingRuntime()?.hostMessaging?.(ctx.sessionId);
+      if (host !== undefined)
+        return stopHostSession(host, id, ctx.agentId, ctx.signal);
       return { output: `Error: TaskStop: unknown task_id "${id}"`, isError: true };
     }
     if (task.status !== "running") {
@@ -18852,6 +18908,24 @@ var taskStopExecutor = {
     return { output: formatResult(`stopped task ${id}`, id, task.kind, task.command) };
   }
 };
+var HOST_SESSION_TASK_TYPE = "session";
+async function stopHostSession(host, id, agentId, signal) {
+  let answer;
+  try {
+    answer = await host.stop({ id, ...agentId !== undefined ? { fromAgentId: agentId } : {} }, signal !== undefined ? { signal } : {});
+  } catch (err) {
+    return { output: `Error: TaskStop: the host did not answer the stop for "${id}" (${err instanceof Error ? err.name : "error"}); it may or may not have stopped`, isError: true };
+  }
+  const note = boundedHostNote(answer.note);
+  const withNote = (message) => note === undefined ? message : `${message}. ${note}`;
+  if (answer.status === "stopped")
+    return { output: JSON.stringify({ message: withNote(`stopped session ${id}: its running turn was interrupted`), task_id: id, task_type: HOST_SESSION_TASK_TYPE }) };
+  if (answer.status === "not_running")
+    return { output: JSON.stringify({ message: withNote(`session ${id} has no turn running -- nothing to stop`), task_id: id, task_type: HOST_SESSION_TASK_TYPE }) };
+  if (answer.status === "not_found")
+    return { output: `Error: TaskStop: unknown task_id "${id}" (${answer.reason ?? "not found"})`, isError: true };
+  return { output: `Error: TaskStop: ${answer.reason ?? answer.status}`, isError: true };
+}
 replaceExecutor("TaskStop", taskStopExecutor);
 
 // src/tools/impl/todo-write.ts
@@ -19448,7 +19522,8 @@ function callerContextFrom(ctx) {
   return {
     sessionId: ctx.sessionId,
     ...ctx.agentId !== undefined ? { agentId: ctx.agentId } : {},
-    ...ctx.toolUseId !== undefined ? { toolUseId: ctx.toolUseId } : {}
+    ...ctx.toolUseId !== undefined ? { toolUseId: ctx.toolUseId } : {},
+    ...ctx.signal !== undefined ? { signal: ctx.signal } : {}
   };
 }
 
@@ -23233,6 +23308,7 @@ ${escapeAttributionText(msg.body)}
   opts.onChildRosterReady?.(() => childRoster);
   opts.onForegroundChildrenReady?.(() => [...foregroundChildren]);
   const removeChildRosterSource = ensureDefaultMessagingRuntimeRegistered().addChildRosterSource(() => childRoster);
+  const removeHostMessagingPort = config.hostMessaging === true && config.agentId === undefined ? getDefaultMessagingRuntime()?.registerHostMessagingPort?.(config.sessionId, createHostMessagingPort(bridge)) : undefined;
   const sandboxSettingsForSession = config.sandbox ?? DEFAULT_SANDBOX_SETTINGS;
   const bashPostureFor = (call, dangerouslyDisableSandbox) => {
     const command = call.input["command"];
@@ -26439,6 +26515,7 @@ ${reason}` : ""}` : `${promptStop.hookName} hook stopped continuation${reason.le
   if (config.agentId === undefined)
     clearNotificationQueue(config.sessionId);
   removeChildRosterSource();
+  removeHostMessagingPort?.();
   facetSelfPeer?.();
   facetNoticeForwarder?.();
   disposeSessionMcpLifecycle?.();
@@ -27598,7 +27675,7 @@ class TranscriptWriter2 {
     return entries;
   }
 }
-var RUNTIME_ENGINE_VERSION2 = "0.0.38";
+var RUNTIME_ENGINE_VERSION2 = "0.0.39";
 function withPermissionJournal(writer, location) {
   return {
     transcriptPath: join26(location.winterHome, "projects", location.projectKey, `${location.sessionId}.jsonl`),

package/dist/{index-z3970wsj.js → index-es0skt5n.js}

@@ -85,7 +85,7 @@ import {
   providerCredentialRef2,
   createModelClassifier2,
   selectClassifierRoute2
-} from "./index-5xe59vkt.js";
+} from "./index-dh2xed37.js";
 import {
   createKeychainCredentialStore,
   createKeychainSecretReader,

package/dist/index.js

@@ -55,7 +55,7 @@ import {
   DEFAULT_CLASSIFIER_TIMEOUT_MS2,
   createModelClassifier2,
   selectClassifierRoute2
-} from "./index-5xe59vkt.js";
+} from "./index-dh2xed37.js";
 import"./index-1hef2gff.js";
 import"./index-mwew595z.js";
 import"./index-2wgfv0pa.js";

package/dist/messaging/host-port.d.ts

@@ -0,0 +1,19 @@
+import { type HostMessagingPort } from "@yanlinglabs/winter-agent-sdk/messaging";
+import type { RpcBridge } from "../rpc/bridge.js";
+/**
+ * How long one delivery may take. Generous on purpose: a host may RESUME a finished session for the
+ * message (start its runtime, replay its transcript, connect its MCP servers) before it can answer. A
+ * timeout is `delivery_uncertain`, never `not_found` -- by then the host may well have delivered.
+ */
+export declare const HOST_MESSAGE_SEND_TIMEOUT_MS = 180000;
+/** How long a listing may take; a slow one lists nothing more (ListAgents still shows the subagents). */
+export declare const HOST_MESSAGE_LIST_TIMEOUT_MS = 15000;
+/** How long a session stop may take (an interrupt is quick; the host answers once it is requested). */
+export declare const HOST_SESSION_STOP_TIMEOUT_MS = 30000;
+/** Thrown for a malformed send answer, so the router core reports it as `delivery_uncertain`. */
+export declare class HostMessagingAnswerError extends Error {
+    constructor(message: string);
+}
+/** The bridge's own `request`, whose options carry the `signal` the host requests ride. */
+export type HostMessagingSender = Pick<RpcBridge, "request">;
+export declare function createHostMessagingPort(sender: HostMessagingSender): HostMessagingPort;

package/dist/messaging/reference-adapter.d.ts

@@ -1,5 +1,5 @@
 import type { PermissionMode } from "@yanlinglabs/winter-agent-sdk";
-import { type ChildLike, type RuntimeAddress, type DeliveryOutcome, type GlobalAgentMessage, type RuntimeMessagingAdapter, type CrossSessionInbound, type NotificationQueue, type MessagingRouterSeamWithRoster, type MessagingRuntimeDeps, type SubscriberDirectory } from "@yanlinglabs/winter-agent-sdk/messaging";
+import { type ChildLike, type RuntimeAddress, type DeliveryOutcome, type GlobalAgentMessage, type RuntimeMessagingAdapter, type CrossSessionInbound, type NotificationQueue, type MessagingRouterSeamWithRoster, type MessagingRuntimeDeps, type SubscriberDirectory, type HostMessagingPort } from "@yanlinglabs/winter-agent-sdk/messaging";
 export interface PeerSessionHandle {
     readonly address: RuntimeAddress;
     readonly name?: string;
@@ -41,6 +41,13 @@ export interface DefaultMessagingRuntime extends MessagingRuntimeDeps {
     adapter: ReferenceMessagingAdapter;
     peers: PeerDirectory;
     seam: MessagingRouterSeamWithRoster;
+    /**
+     * Host messaging: register `port` as the host line of the OWNING session `sessionId` (a top-level run
+     * whose config says `hostMessaging: true`). Returns the withdrawal, which removes only this exact
+     * registration. Keyed by session, never one process slot: the in-memory leg runs several sessions in
+     * one realm, and each must reach only its own host handler.
+     */
+    registerHostMessagingPort(sessionId: string, port: HostMessagingPort): () => void;
 }
 /**
  * R-7b-4: THIS RUNTIME's answer to "was that throw a policy refusal, or a crash window?"

package/dist/store/dialect.d.ts

@@ -478,7 +478,7 @@ export declare class TranscriptWriter implements SessionPersistence {
     private dialectRecord;
     static readBack(store: SessionStore, key: SessionKey): Promise<SessionStoreEntry[]>;
 }
-export declare const RUNTIME_ENGINE_VERSION = "0.0.38";
+export declare const RUNTIME_ENGINE_VERSION = "0.0.39";
 export interface ResolvedEngineSession {
     config: RuntimeConfig;
     store: SessionPersistence | undefined;

package/dist/testing.js

@@ -3,7 +3,7 @@ import {
   runEngine2,
   echoProvider2,
   resolveEngineSession2
-} from "./index-5xe59vkt.js";
+} from "./index-dh2xed37.js";
 import"./index-1hef2gff.js";
 import"./index-mwew595z.js";
 import"./index-2wgfv0pa.js";
@@ -14,7 +14,7 @@ import {
   buildProductionWiring,
   withAutoSkillPermissions,
   restoreChildRoster
-} from "./index-z3970wsj.js";
+} from "./index-es0skt5n.js";
 import {
   Queue
 } from "./index-97t2rmtf.js";

package/dist/tools/impl/task-stop.d.ts

@@ -8,4 +8,6 @@ declare function parseTaskStopInput(input: unknown): TaskStopInput | {
     error: string;
 };
 declare const taskStopExecutor: ToolExecutor;
+/** `task_type` for a host session in TaskStop's pinned result shape. */
+export declare const HOST_SESSION_TASK_TYPE = "session";
 export { parseTaskStopInput, taskStopExecutor };

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const RUNTIME_VERSION = "0.0.38";
+export declare const RUNTIME_VERSION = "0.0.39";

package/dist/version.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var RUNTIME_VERSION = "0.0.38";
+var RUNTIME_VERSION = "0.0.39";
 export {
   RUNTIME_VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanlinglabs/winter-agent-runtime",
-  "version": "0.0.38",
+  "version": "0.0.39",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -73,9 +73,9 @@
     "@modelcontextprotocol/client": "^2.1.0",
     "ajv": "^8.20.0",
     "ignore": "7.0.5",
-    "@yanlinglabs/winter-agent-sdk": "0.0.38",
-    "@yanlinglabs/winter-provider-runtime": "0.0.38",
-    "@yanlinglabs/winter-provider-catalog": "0.0.38"
+    "@yanlinglabs/winter-agent-sdk": "0.0.39",
+    "@yanlinglabs/winter-provider-catalog": "0.0.39",
+    "@yanlinglabs/winter-provider-runtime": "0.0.39"
   },
   "devDependencies": {
     "@modelcontextprotocol/server": "^2.1.0"