@zq-silk/yui 2.22.0 → 2.23.0

package/dist/execution/codexThreadNaming.js

@@ -2,52 +2,64 @@ import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import { codexClientInitialization } from "../runtime/codexAppServerRuntime.js";
 const DEFAULT_TIMEOUT_MS = 1_000;
-export async function setCodexThreadName(request) {
-    const timeoutMs = threadNameTimeout(request.timeoutMs);
-    const client = await CodexNamingClient.start(request.command, request.environment, request.baseArgs ?? [], timeoutMs);
-    try {
-        await withTimeout(client.request("thread/name/set", {
-            threadId: requiredText(request.threadId, "Codex thread id"),
-            name: requiredThreadName(request.name)
-        }), timeoutMs, "Timed out setting Codex thread name.");
-    }
-    finally {
-        client.close();
-    }
-}
-class CodexNamingClient {
+export class CodexNamingClient {
     child;
+    accountHome;
+    exited;
     #pending = new Map();
     #stderr = [];
     #nextId = 1;
     #closed = false;
-    constructor(child) {
+    #deadline;
+    constructor(child, timeoutMs) {
         this.child = child;
+        this.exited = new Promise(resolve => child.once("close", () => resolve()));
+        this.#deadline = setTimeout(() => {
+            this.#failAll(new Error("Native title metadata process deadline exceeded; effect may be unknown."));
+            this.close("SIGKILL");
+        }, timeoutMs);
         const output = createInterface({ input: child.stdout });
-        output.on("line", (line) => { this.#receive(line); });
+        output.on("line", (line) => {
+            try {
+                if (Buffer.byteLength(line) > 1_048_576)
+                    throw new Error("Native title reply exceeds its bound.");
+                this.#receive(line);
+            }
+            catch (error) {
+                this.#failAll(error instanceof Error ? error : new Error(String(error)));
+                this.close();
+            }
+        });
+        child.stdout.on("error", error => { this.#failAll(error); this.close(); });
         child.stderr.setEncoding("utf8");
         child.stderr.on("data", (chunk) => {
             this.#stderr.push(chunk);
             if (this.#stderr.join("").length > 16_384)
                 this.#stderr.shift();
         });
-        child.on("error", (error) => { this.#failAll(error); });
+        child.on("error", (error) => { this.#failAll(error); this.close(); });
+        child.stdin.on("error", (error) => { this.#failAll(error); this.close(); });
         child.on("exit", (code, signal) => {
+            clearTimeout(this.#deadline);
             if (this.#closed)
                 return;
+            this.#closed = true;
             const detail = this.#stderr.join("").trim();
             this.#failAll(new Error(`Codex App Server exited (${code ?? signal ?? "unknown"})${detail.length === 0 ? "" : `: ${detail}`}`));
         });
     }
     static async start(command, environment, baseArgs, timeoutMs) {
-        const client = new CodexNamingClient(spawn(command, [...baseArgs, "app-server", "--stdio"], { env: environment, stdio: ["pipe", "pipe", "pipe"] }));
+        const deadlineMs = threadNameTimeout(timeoutMs);
+        const client = new CodexNamingClient(spawn(command, [...baseArgs, "app-server", "--listen", "stdio://"], { env: environment, stdio: ["pipe", "pipe", "pipe"] }), deadlineMs);
         try {
-            await withTimeout(client.request("initialize", codexClientInitialization()), timeoutMs, "Timed out initializing Codex App Server for thread naming.");
+            const initialized = await withTimeout(client.request("initialize", codexClientInitialization()), timeoutMs, "Timed out initializing Codex App Server for thread naming.");
+            client.accountHome = typeof initialized.codexHome === "string" ? initialized.codexHome : undefined;
             client.notify("initialized", {});
             return client;
         }
         catch (error) {
             client.close();
+            await client.exited;
             throw error;
         }
     }
@@ -63,11 +75,19 @@ class CodexNamingClient {
     notify(method, params) {
         this.#write({ method, params });
     }
-    close() {
+    close(signal = "SIGTERM") {
         if (this.#closed)
             return;
         this.#closed = true;
-        this.child.kill("SIGTERM");
+        clearTimeout(this.#deadline);
+        this.child.kill(signal);
+        // An owned metadata process must not survive a lost reply or ignored TERM.
+        const reap = setTimeout(() => {
+            if (this.child.exitCode === null && this.child.signalCode === null)
+                this.child.kill("SIGKILL");
+        }, 250);
+        reap.unref();
+        this.child.once("exit", () => clearTimeout(reap));
         this.#failAll(new Error("Codex App Server closed."));
     }
     #write(value) {
@@ -94,13 +114,20 @@ class CodexNamingClient {
             }
             return;
         }
-        this.#pending.delete(message.id);
-        if (message.error !== undefined) {
-            const error = object(message.error, "Codex App Server error");
-            pending.reject(new Error(typeof error.message === "string" ? error.message : "Codex App Server request failed."));
+        try {
+            if (message.error !== undefined) {
+                const error = object(message.error, "Codex App Server error");
+                pending.reject(new Error(typeof error.message === "string" ? error.message : "Codex App Server request failed."));
+            }
+            else {
+                pending.resolve(object(message.result, "Codex App Server result"));
+            }
+        }
+        catch (error) {
+            pending.reject(error instanceof Error ? error : new Error(String(error)));
         }
-        else {
-            pending.resolve(object(message.result, "Codex App Server result"));
+        finally {
+            this.#pending.delete(message.id);
         }
     }
     #failAll(error) {
@@ -115,22 +142,6 @@ function object(value, label) {
     }
     return value;
 }
-function requiredText(value, label) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new Error(`${label} is invalid.`);
-    }
-    return value;
-}
-function requiredThreadName(value) {
-    if (typeof value !== "string" || value.includes("\0")) {
-        throw new Error("Codex thread name is invalid.");
-    }
-    const normalized = value.trim();
-    if (normalized.length === 0 || normalized.length > 1_024) {
-        throw new Error("Codex thread name is invalid.");
-    }
-    return normalized;
-}
 function threadNameTimeout(value) {
     if (value === undefined)
         return DEFAULT_TIMEOUT_MS;

package/dist/executor/fileRoleLaunchPlanner.js

@@ -17,7 +17,7 @@ import { managedRuntimeAdmission } from "../runtime/agentDriver.js";
 import { builtinAgentEndpointImplementation, validateAgentEndpointImplementation } from "../runtime/agentEndpointIdentity.js";
 import { builtinAgentDriverRegistry, builtinDriverIdForAdapter } from "../runtime/builtinAgentDrivers.js";
 import { assertProviderConversationReplaceable } from "../runtime/providerRuntimeIdentity.js";
-import { globalRoleSessionTitle, resolveTaskRoleSessionTitle } from "../runtime/sessionTitle.js";
+import { globalRoleSessionTitle, taskRoleSessionTitle, resolveTaskRoleSessionTitle } from "../runtime/sessionTitle.js";
 import { parseTaskRuntimeIsolationDescriptor, taskRuntimeIsolationEnvironment } from "../runtime/taskRuntimeIsolation.js";
 import { planningRuntimeCwd } from "../storage/homeLayout.js";
 import { resolveAgentAdapter } from "./agentAdapter.js";
@@ -225,7 +225,11 @@ export class FileRoleLaunchPlanner {
             instanceCode: role.instanceCode,
             generatedTitle: existing?.generatedTitle
         }), input.mode === "resume" && compatibleExisting ? existing.nativeSessionId : undefined, effective, {
-            purpose
+            purpose,
+            nativeGeneratedTitle: taskRoleSessionTitle(task, role.name, {
+                executionAuthority: (input.mode === "resume" ? existing?.effective : effective)?.executionAuthority,
+                instanceCode: role.instanceCode
+            })
         });
     }
     planGlobalRole(input) {
@@ -258,7 +262,10 @@ export class FileRoleLaunchPlanner {
             : existing?.generatedTitle !== undefined && existing.title === existing.generatedTitle
                 ? globalRoleSessionTitle(role.name, new Date(existing.createdAt), this.store.getConfig().timeZone, role.instanceCode)
                     ?? `Yui ${role.name}`
-                : undefined, input.mode === "resume" && compatibleExisting ? existing.nativeSessionId : undefined, effective, { purpose: "execution" });
+                : undefined, input.mode === "resume" && compatibleExisting ? existing.nativeSessionId : undefined, effective, { purpose: "execution",
+            nativeGeneratedTitle: globalRoleSessionTitle(role.name, input.mode === "resume" && existing !== undefined ? new Date(existing.createdAt) : this.#now(), this.store.getConfig().timeZone, role.instanceCode)
+                ?? (input.mode === "resume" ? `Yui ${role.name}` : undefined)
+        });
     }
     #compile(role, input, owner, sessionTitle, knownNativeSessionId, effective, sessionPolicy) {
         const launchRole = effectiveRoleForLaunch(role, effective);
@@ -570,6 +577,14 @@ export class FileRoleLaunchPlanner {
                 YUI_DRIVER_ID: driver.id,
                 YUI_WORKSPACE: effectiveWorkspace,
                 YUI_SESSION_MANIFEST: sessionContext.sessionManifestPath,
+                // A proposal only. The independent metadata lane must prove native
+                // ownership; planning never reads/waits on title effects.
+                ...(configured.adapterId !== "codex" || sessionPolicy.nativeGeneratedTitle === undefined ? {} : {
+                    YUI_NATIVE_TITLE_PROPOSAL: sessionPolicy.nativeGeneratedTitle
+                }),
+                ...(configured.adapterId !== "codex" || input.mode !== "resume" || existingSession?.title === undefined ? {} : {
+                    YUI_NATIVE_TITLE_LOCAL: existingSession.title
+                }),
                 ...(configured.adapterId === "codex"
                     ? { YUI_AGENT_BASE_ARGS: JSON.stringify(configured.baseArgs) }
                     : {}),

package/dist/runtime/agentEndpoint.js

@@ -1,3 +1,4 @@
+import { isDeepStrictEqual } from "node:util";
 import { builtinAgentEndpointImplementation, requireBuiltinAgentEndpointImplementation } from "./agentEndpointIdentity.js";
 import { builtinAgentDriverRegistry } from "./builtinAgentDrivers.js";
 import { CodexPreSubmissionError } from "./codexAppServerRuntime.js";
@@ -80,6 +81,12 @@ function freezeConfiguration(value) {
 class BuiltinAgentEndpoint {
     driver;
     configuration;
+    get contextEpoch() { return this.driver.contextEpoch; }
+    async checkQuiescent() {
+        if (!this.driver.checkQuiescent)
+            throw new Error("This native Endpoint cannot prove background quiescence.");
+        return this.driver.checkQuiescent();
+    }
     get nativeAccess() { return this.driver.nativeAccess; }
     get appliedGeneratedTitle() { return this.driver.appliedGeneratedTitle; }
     get ownedProcessId() { return this.driver.ownedProcessId; }
@@ -147,6 +154,7 @@ class BuiltinAgentEndpoint {
         const previous = this.#attempts.get(input.attemptId);
         if (previous !== undefined) {
             if (previous.input.inputRef !== input.inputRef || previous.input.boundedText !== input.boundedText
+                || !isDeepStrictEqual(previous.input.additionalContext, input.additionalContext)
                 || previous.operation !== operation) {
                 throw new Error("Endpoint attempt identity cannot be reused for different input or operation.");
             }
@@ -160,7 +168,9 @@ class BuiltinAgentEndpoint {
             return { status: "not-submitted", error: new ProviderTurnRejectedError("Endpoint is detached.", input.attemptId) };
         }
         const attempt = {
-            input: Object.freeze({ ...input }),
+            input: Object.freeze({ ...input, ...(input.additionalContext === undefined ? {} : {
+                    additionalContext: structuredClone(input.additionalContext)
+                }) }),
             operation,
             disposition: { status: "pending", reason: "submitting" }
         };

package/dist/runtime/agentEndpointIdentity.js

@@ -35,6 +35,8 @@ const ENDPOINT_CHECKOUT_MODULES = Object.freeze([
     "acpProtocol.js",
     "acpSessionConfiguration.js",
     "agentRunConfiguration.js",
+    "contextRecovery.js",
+    "codexNativeAccess.js",
     "jsonLineChannel.js"
 ]);
 function resolveEndpointGeneration() {