orchestrar 0.1.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Darko Luketic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/orchestrator.js

@@ -4,6 +4,8 @@ const fs = require("node:fs/promises");
 const path = require("node:path");
 const DEFAULT_MODEL = "github-copilot/gpt-5.2-codex";
 const COMMIT_MODEL = "github-copilot/gpt-5-mini";
+const DEFAULT_AGENT = "build-gpt-5.2-codex";
+const COMMIT_AGENT = "build";
 const DEFAULT_REVIEW_COMMAND_NAME = "review-uncommited";
 const DEFAULT_REVIEW_COMMAND_ARGUMENTS = "";
 const DEFAULT_REVIEW_TIMEOUT_MS = 60 * 60 * 1000;
@@ -45,7 +47,7 @@ async function runWorkInstance(createOpencode, docs, root) {
       "session.create"
     );
 
-    const sessionID = session.id;
+    const sessionID = extractSessionID(session, "session.create (work instance)");
     const promptPaths = buildPromptPaths(docs, root);
 
     await sendPrompt(
@@ -83,13 +85,14 @@ async function runCommitInstance(createOpencode, root) {
       "session.create"
     );
 
-    const sessionID = session.id;
+    const sessionID = extractSessionID(session, "session.create (commit instance)");
     await sendPrompt(
       client,
       sessionID,
       buildCommitPrompt(),
       root,
-      COMMIT_MODEL
+      COMMIT_MODEL,
+      COMMIT_AGENT
     );
     await waitForSessionIdle(client, sessionID, root);
   } finally {
@@ -153,7 +156,7 @@ async function runReviewCommand(createOpencode, root) {
       "session.create"
     );
 
-    const sessionID = session.id;
+    const sessionID = extractSessionID(session, "session.create (review instance)");
     const commandResult = await unwrap(
       client.session.command({
         path: { id: sessionID },
@@ -161,6 +164,7 @@ async function runReviewCommand(createOpencode, root) {
         body: {
           command: commandName,
           arguments: commandArguments,
+          agent: DEFAULT_AGENT,
           model: DEFAULT_MODEL,
         },
       }),
@@ -197,7 +201,8 @@ async function sendPrompt(
   sessionID,
   text,
   root,
-  modelSpec = DEFAULT_MODEL
+  modelSpec = DEFAULT_MODEL,
+  agentSpec = DEFAULT_AGENT
 ) {
   const model = parseModelSpec(modelSpec);
   await unwrap(
@@ -205,6 +210,7 @@ async function sendPrompt(
       path: { id: sessionID },
       query: { directory: root },
       body: {
+        agent: agentSpec,
         model,
         parts: [{ type: "text", text }],
       },
@@ -233,7 +239,11 @@ async function waitForSessionIdle(client, sessionID, root, timeoutOverrideMs) {
     );
     const status = statusMap?.[sessionID];
     if (!status) {
-      throw new Error(`Session status missing for ${sessionID}.`);
+      const knownSessions = statusMap ? Object.keys(statusMap) : [];
+      const knownList = knownSessions.length ? knownSessions.join(", ") : "none";
+      throw new Error(
+        `Session status missing for ${sessionID}. Known sessions: ${knownList}.`
+      );
     }
     if (status.type === "idle") {
       return;
@@ -446,6 +456,46 @@ function unwrap(result, label) {
   return result;
 }
 
+function extractSessionID(session, context) {
+  if (!session || typeof session !== "object") {
+    throw new Error(`${context} did not return a session object.`);
+  }
+
+  const candidates = [
+    session.id,
+    session.sessionID,
+    session.info?.id,
+    session.info?.sessionID,
+    session.properties?.id,
+    session.properties?.sessionID,
+    session.properties?.info?.id,
+    session.properties?.info?.sessionID,
+    session.slug,
+  ];
+
+  for (const candidate of candidates) {
+    if (typeof candidate === "string" && candidate.trim()) {
+      return candidate;
+    }
+  }
+
+  throw new Error(
+    `${context} returned a session without an id. Response: ${safeStringify(session)}`
+  );
+}
+
+function safeStringify(value, maxLength = 1000) {
+  try {
+    const json = JSON.stringify(value);
+    if (typeof json === "string" && json.length > 0) {
+      return json.length > maxLength ? `${json.slice(0, maxLength)}...` : json;
+    }
+  } catch (error) {
+    // fall through to String()
+  }
+  return String(value);
+}
+
 function formatError(error) {
   if (!error) {
     return "Unknown error";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchestrar",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "OpenCode milestone orchestrator",
   "license": "MIT",
   "type": "commonjs",