@zq-silk/yui 2.1.0 → 2.2.0

package/README.md

@@ -42,6 +42,10 @@ not from terminal windows you juggle or details you have to remember.
 
 ## Quick start
 
+For the self-built coding Agent (without a Controller or Yui Home), see
+[`yui agent`](docs/native-agent.md). Its explicit configuration and product state
+are separate from the orchestration setup below.
+
 You need Linux x64 (glibc) or macOS (x64 or Apple Silicon), Git, tmux, and
 Node.js `^20.17.0`, `^22.9.0`, `^24.0.0` or `^26.0.0`. On macOS install tmux with
 `brew install tmux`. For the simplest setup, have Codex CLI or Claude Code CLI

package/dist/cli/commandCatalog.js

@@ -1,5 +1,7 @@
 import { supportedAgentAdapterIds } from "../agent/adapterCatalog.js";
 import { supportedAgentExecutionComponentIds } from "../agent/executionComponents.js";
+import { productConfigurationOptions } from "../nativeAgent/product/config.js";
+import { catalogCommands, catalogCommandOptions } from "../nativeAgent/product/catalog.js";
 import { CONFIG_DEFINITIONS, CONFIG_DOMAINS, configDefinitionsForDomain } from "../config/configCatalog.js";
 function buildNode(input, parentPath = []) {
     const path = [...parentPath, input.name];
@@ -794,8 +796,8 @@ const taskChildren = [
             {
                 name: "dispatch", discovery: { surface: "managed", audiences: ["operator", "leader"] },
                 summary: "Dispatch a work item to its Role.",
-                usage: "yui task work dispatch <task>/<work> [--input <text>] [--lane-role <role> ...]",
-                options: ["--input", "--lane-role"]
+                usage: "yui task work dispatch <task>/<work> [--input <text>] [--context-ref <store/refId@digest> ...] [--lane-role <role> ...]",
+                options: ["--input", "--context-ref", "--lane-role"]
             },
             {
                 name: "synthesize", discovery: { surface: "managed", audiences: ["operator", "leader"] },
@@ -1113,13 +1115,32 @@ export const ROOT_COMMAND = buildNode({
         { id: "general", title: "General", entries: [
                 "help", "version", "update", "upgrade", "setup", "start", "doctor"
             ] },
-        { id: "workflow", title: "Workflow", entries: ["operator", "role", "project", "task"] },
+        { id: "workflow", title: "Workflow", entries: ["agent", "operator", "role", "project", "task"] },
         { id: "configuration", title: "Configuration", entries: ["config"] },
         { id: "operations", title: "Operations", entries: ["web", "controller", "session", "execution", "capability", "job", "jobs", "telemetry", "release"] },
         { id: "resources", title: "Resources", entries: ["resources"] },
         { id: "internal", title: "Internal", entries: ["internal"] }
     ],
     children: [
+        {
+            name: "agent", discovery: { surface: "public", audiences: ["public", "operator"] },
+            summary: "Run the independent coding Agent without a Controller or Yui Home.",
+            sections: [{ id: "product", title: "Independent Agent", entries: ["check-config", "start", "run", ...catalogCommands] }],
+            children: [
+                { name: "check-config", discovery: { surface: "public", audiences: ["public", "operator"] },
+                    summary: "Validate explicit configuration without model requests or state initialization.",
+                    options: productConfigurationOptions, fileOptions: ["--config"] },
+                { name: "start", discovery: { surface: "public", audiences: ["public", "operator"] },
+                    summary: "Open a foreground line UI; select --session ID to resume saved history.",
+                    options: [...productConfigurationOptions, "--session"], fileOptions: ["--config"] },
+                { name: "run", discovery: { surface: "public", audiences: ["public", "operator"] },
+                    summary: "Submit one input and return real result/save evidence as JSON.",
+                    options: [...productConfigurationOptions, "--session", "--input"], fileOptions: ["--config"] },
+                ...catalogCommands.map(name => ({ name, discovery: { surface: "public", audiences: ["public", "operator"] },
+                    summary: "Use the real persistent Session catalog without starting execution.",
+                    options: catalogCommandOptions(name) }))
+            ]
+        },
         {
             name: "role", discovery: { surface: "public", audiences: ["public", "operator"] },
             summary: "Queue input or control an exact current Global Role Turn.",

package/dist/cli/commandDiscovery.js

@@ -5,7 +5,10 @@ import { hasManagedIdentity } from "../runtime/managedIdentity.js";
 export function discoveryAudience(env) {
     if (!hasManagedIdentity(env))
         return "public";
-    if (!env.YUI_ROLE || !env.YUI_NATIVE_SESSION_ID)
+    const nativeSessionId = env.YUI_ADAPTER_ID === "codex"
+        ? env.CODEX_THREAD_ID ?? env.YUI_NATIVE_SESSION_ID : env.YUI_NATIVE_SESSION_ID;
+    if (!env.YUI_ROLE || !nativeSessionId || nativeSessionId.trim() !== nativeSessionId
+        || nativeSessionId.includes("\0"))
         return "unbound";
     if (env.YUI_SESSION_SCOPE === "global")
         return env.YUI_ROLE === "operator" ? "operator" : "global";