@tomradex/agent 0.17.0 → 0.17.1

package/dist/engine.d.ts

@@ -75,8 +75,64 @@ export interface EngineSetup {
     /** Signing in starts the agent itself, which then asks (`/login`); otherwise the command signs in and returns. */
     signInRuns?: boolean;
     docs?: string;
+    /** The agent's official download page, opened in the system browser beside these commands, for those without the tools they need: one that offers the CLI. */
+    download?: string;
+    /** The agent's desktop app, when it has one: whether installing it puts the CLI where Tomrade finds it. */
+    desktop?: {
+        title: string;
+        shipsCli: boolean;
+    };
     /** Offered on setup screens before it is installed. */
     suggested?: boolean;
+    /** Installs Tomrade runs itself in the background, most reliable first; one that does not fit this machine is skipped. Absent, only the terminal commands remain. */
+    installers?: EngineInstaller[];
+    /** A sign-in command Tomrade runs and watches itself: it opens or prints a browser address and needs no typing. Without it, signing in happens in a terminal while Tomrade polls. */
+    signInRun?: {
+        args: string[];
+    };
+}
+/**
+ * One way Tomrade itself installs the CLI, no terminal and no admin rights.
+ * `npm` runs through the system npm when it answers, else the app's borrowed
+ * one; `script` is the agent's official installer for one platform family;
+ * `brew` is tried only where Homebrew is already installed.
+ */
+export type EngineInstaller = {
+    kind: "npm";
+    package: string;
+} | {
+    kind: "script";
+    url: string;
+    shell: "sh" | "powershell";
+} | {
+    kind: "brew";
+    name: string;
+    cask?: boolean;
+};
+export type EngineSetupStep = "install" | "sign-in";
+/** Why a setup step failed, sorted into a kind a screen can word in the person's language. */
+export interface EngineSetupFailure {
+    kind: "network" | "registry" | "permission" | "disk-full" | "unsupported" | "not-found" | "not-on-path" | "timeout" | "exit" | "cancelled";
+    /** The underlying words, English or the tool's own, for the details view. */
+    message: string;
+}
+/** Where one engine's setup step stands; pushed as it moves. */
+export interface EngineSetupProgress {
+    engineId: string;
+    step: EngineSetupStep;
+    /** `waiting`: a sign-in that needs the person — in the browser, or in the terminal when `terminal` is set. */
+    phase: "running" | "checking" | "waiting" | "done" | "failed";
+    /** Which installer is being tried ("script", "npm", "brew"). */
+    installer?: string;
+    /** The last lines of output, shown on a failure. */
+    output?: string;
+    failure?: EngineSetupFailure;
+    /** The version detection reported once the step was done; absent when the step was already satisfied. */
+    version?: string;
+    /** The sign-in address caught from the agent's output, for the screen to open when the agent did not. */
+    url?: string;
+    /** Signing in needs the agent's own terminal session (`setup.signIn`); Tomrade keeps watching until it is signed in. */
+    terminal?: boolean;
 }
 /**
  * Tomrade's MCP server in the agent's own user-level configuration, so a
@@ -295,6 +351,8 @@ export interface EnginePick {
     freeText?: boolean;
     /** The engine is still asking its agent for the choices; ask again shortly. */
     pending?: boolean;
+    /** The engine asked its agent for the choices and the agent could not answer: why. On the model pick, it cannot run a turn yet. */
+    failed?: string;
 }
 /** One real turn on an engine, asked for by the person: does it answer? */
 export interface EngineTry {

package/dist/index.d.ts

@@ -15,7 +15,7 @@ export { carriedKits, deferredTools, kitLines } from "./kits.js";
 export { type AgentEvent, type Block, type CardAction, type CardView, type ChecklistCard, type FindingCard, type FocusRef, PANEL_SURFACES, type ParkView, type PendingView, type RunStatus, type RunView, type ThreadMessage, type ThreadSummary, type ThreadSurface, type UserInput } from "./thread.js";
 export { type OpenDependency, type RetryState, type TurnInput, type TurnIO, type TurnPurpose, type TurnResult } from "./turn.js";
 export { type FollowUpStart, type GeneralExecution, isSuspended, type Playbook, type PlaybookIndexEntry, type PlaybookSource, type Suspended, type TurnFollowUp, type WorkflowInfo, type WorkflowIO, type WorkflowQuestion, type WorkflowSpec, type WorkflowTransition } from "./workflow.js";
-export { type CliAttempt, type CliCheck, type CliSource, type CommandCheck, type CommandCheckOptions, type Engine, type EngineAvailability, type EngineCapability, type EngineCommands, type EngineDiagnostics, type EngineLocal, type EngineMcpLink, type EngineNeed, type EnginePick, type EngineRegistration, type EngineSetup, type EngineSteering, type EngineTerminal, type EngineTry, type EngineView, type FlatEngineMembers, type LocalCliStatus, type McpLinkView, type McpProjectApproval } from "./engine.js";
+export { type CliAttempt, type CliCheck, type CliSource, type CommandCheck, type CommandCheckOptions, type Engine, type EngineAvailability, type EngineCapability, type EngineCommands, type EngineDiagnostics, type EngineLocal, type EngineMcpLink, type EngineNeed, type EnginePick, type EngineInstaller, type EngineRegistration, type EngineSetup, type EngineSetupFailure, type EngineSetupProgress, type EngineSetupStep, type EngineSteering, type EngineTerminal, type EngineTry, type EngineView, type FlatEngineMembers, type LocalCliStatus, type McpLinkView, type McpProjectApproval } from "./engine.js";
 export { type AgentPolicy, type AgentRequest, type AgentRequestFailure, type AgentRetry, type AgentTurnInfo, type CliHookAnswer, type CliHookCall, type CliHookEvent, type TurnEnding } from "./hooks.js";
 export { flatEngineView, normalizeEngine } from "./engine-shape.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/service.d.ts

@@ -341,7 +341,7 @@ export declare class Agent extends Service implements AgentReader {
      */
     tryEngine(projectId: string, engineId: string, signal?: AbortSignal): Promise<EngineTry>;
     /** The last try, while the engine's settings are the ones it ran with. */
-    private triedWith;
+    triedWith(engineId: string): EngineTry | undefined;
     private runTry;
     deleteThread(projectId: string, threadId: string): boolean;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomradex/agent",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "type": "module",
   "author": "Haoyuan Tang",
   "engines": {
@@ -27,17 +27,17 @@
     "dist"
   ],
   "dependencies": {
-    "@tomradex/contracts": "0.17.0",
-    "@tomradex/db": "0.17.0",
-    "@tomradex/domain": "0.2.24",
-    "@tomradex/fields": "0.17.0",
-    "@tomradex/hub": "0.17.0",
-    "@tomradex/ipc": "0.17.0",
-    "@tomradex/llm": "0.17.0",
-    "@tomradex/oplog": "0.17.0",
-    "@tomradex/settings": "0.17.0",
-    "@tomradex/tools": "0.17.0",
-    "@tomradex/write": "0.17.0",
+    "@tomradex/contracts": "0.17.1",
+    "@tomradex/db": "0.17.1",
+    "@tomradex/domain": "0.2.26",
+    "@tomradex/fields": "0.17.1",
+    "@tomradex/hub": "0.17.1",
+    "@tomradex/ipc": "0.17.1",
+    "@tomradex/llm": "0.17.1",
+    "@tomradex/oplog": "0.17.1",
+    "@tomradex/settings": "0.17.1",
+    "@tomradex/tools": "0.17.1",
+    "@tomradex/write": "0.17.1",
     "cordis": "4.0.0-rc.8",
     "zod": "^4.4.3"
   },