@ricsam/r5dctl 0.0.101 → 0.0.104

package/dist/types/cli.d.ts

@@ -1,4 +1,4 @@
-import { R5dctlClient, type R5dctlConversationForkResponse, type R5dctlConversationHeadResponse, type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationNodeResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlK8sResourceHistory, type R5dctlK8sUsage, type R5dctlK8sWorkload, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessRun, type R5dctlSessionEvent, type R5dctlSessionStartInput, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type R5dctlWorktreeSource, type R5dctlSessionMode, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
+import { R5dctlApiError, R5dctlClient, type R5dctlConversationForkResponse, type R5dctlConversationHeadResponse, type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationNodeResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlK8sResourceHistory, type R5dctlK8sUsage, type R5dctlK8sWorkload, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessLog, type R5dctlProcessRun, type R5dctlBranch, type R5dctlBranchDeleteResponse, type R5dctlBranchDescription, type R5dctlBranchOperation, type R5dctlSessionEvent, type R5dctlSessionStartInput, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type R5dctlWorkingTreeMode, type R5dctlWorktreeSource, type R5dctlSessionMode, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
 export type GlobalOptions = {
     baseUrl?: string;
     json: boolean;
@@ -53,14 +53,17 @@ type R5dctlSessionStartCommand = {
     prompt: string;
     follow: boolean;
     includeTools: boolean;
+    parentSessionId?: string;
 } & ({
     worktree: string;
     newWorktree?: never;
     source?: never;
+    workingTree?: never;
 } | {
     worktree?: never;
     newWorktree: string;
     source: R5dctlWorktreeSource;
+    workingTree: R5dctlWorkingTreeMode;
 });
 export type R5dctlSessionRunCommand = R5dctlSessionStartCommand | {
     kind: "status";
@@ -76,7 +79,42 @@ export type R5dctlSessionRunCommand = R5dctlSessionStartCommand | {
     kind: "stop";
     sessionId: string;
 };
+export type R5dctlBranchCreateArgs = {
+    source: R5dctlWorktreeSource;
+    workingTree: R5dctlWorkingTreeMode;
+    worker?: string;
+};
+export declare function parseBranchCreateArgs(args: string[]): R5dctlBranchCreateArgs;
+export declare function parseBranchDeleteArgs(args: string[]): {
+    confirmed: boolean;
+};
+/** An older server strips unknown routes and answers with this generic 404; a route's own not-found carries a specific message. */
+export declare function isUnsupportedServerRoute(error: unknown): error is R5dctlApiError;
+export declare function createBranchThroughPlatform(client: R5dctlClient, projectRef: string, input: {
+    branchName: string;
+} & R5dctlBranchCreateArgs): Promise<R5dctlBranchOperation>;
+export type R5dctlBranchDeletionOutcome = {
+    kind: "preview";
+    branch: R5dctlBranchDescription;
+} | {
+    kind: "deleted";
+    result: R5dctlBranchDeleteResponse;
+};
+export declare function deleteBranchThroughPlatform(client: R5dctlClient, projectRef: string, branchName: string, options: {
+    confirmed: boolean;
+}): Promise<R5dctlBranchDeletionOutcome>;
+export declare function renderBranchDeletionPreview(branch: R5dctlBranchDescription): string;
+export declare function branchDeletionConfirmationMessage(branch: R5dctlBranchDescription): string;
+export declare function renderBranchDeletion(result: R5dctlBranchDeleteResponse): string;
+/** Operation facts only: no commit hash, because a hash is stale as soon as the branch commits. */
+export declare function renderBranchOperation(operation: R5dctlBranchOperation, projectRef: string): string;
 export declare function parseSessionRunCommand(options: Pick<GlobalOptions, "project" | "branch" | "session">, args: string[]): R5dctlSessionRunCommand;
+export type R5dctlSessionProcessLogArgs = {
+    runId: string;
+    tail?: number;
+    grep?: string;
+};
+export declare function parseSessionProcessLogArgs(args: string[]): R5dctlSessionProcessLogArgs;
 export declare function parseGlobalArgs(argv: string[]): {
     options: GlobalOptions;
     rest: string[];
@@ -137,6 +175,7 @@ export declare function advanceTransientDevicePollBackoff(intervalMs: number, tr
 };
 export declare function handleAuthLogin(client: R5dctlClient, options: GlobalOptions, commandArgs: string[], config: R5dctlConfig): Promise<void>;
 export declare function renderWorkspaceStatus(status: R5dctlWorkspaceStatus): string;
+export declare function renderBranchList(branches: R5dctlBranch[]): string;
 export declare function renderWorkspaceSync(result: R5dctlWorkspaceSyncResult): string;
 export type K8sUsageSummary = {
     cpuMinNanoCores: number | null;
@@ -176,6 +215,11 @@ export declare function renderK8sUsageReport(report: K8sUsageReport): string;
 export declare function formatProcessAge(startedAt: string, nowMs?: number): string;
 export declare function renderProcessList(processes: R5dctlProcessRun[], nowMs?: number): string;
 export declare function renderProcessHistory(processes: R5dctlProcessRun[], nowMs?: number): string;
+/** Streams go to stdout under `==> name <==` headers; the selection summary is returned separately for stderr. */
+export declare function renderProcessLog(log: R5dctlProcessLog): {
+    text: string;
+    summary: string;
+};
 export declare function renderProcessInspection(process: R5dctlProcessInspection): string;
 export type EnvSummaryData = Record<string, {
     description: string;
@@ -191,11 +235,19 @@ export type R5dctlCommandResponse = {
     sessionId?: string;
     sessionUrl?: string;
     branchName?: string;
+    /** Launch-time worktree origin of a new-worktree run; absent or null on an existing worktree. */
+    sourceBranch?: string | null;
+    workingTree?: string | null;
+    /** Launch-time hashes: present in --json output but never rendered. */
     baselineCommit?: string | null;
     workspaceHead?: string | null;
     worker?: string;
     status?: string;
     runStatus?: unknown;
+    /** Worker queue state while a new worktree provisions; older servers and workers omit it. */
+    provisioningQueuePosition?: number;
+    provisioningQueuedAt?: string;
+    /** Legacy fields older servers still send; never rendered because a reported hash goes stale. */
     headCommit?: string | null;
     headCommitError?: string;
     promptDisposition?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.101",
+  "version": "0.0.104",
   "type": "module",
   "main": "./dist/cjs/cli.cjs",
   "module": "./dist/mjs/cli.mjs",
@@ -26,7 +26,7 @@
     "r5dctl": "dist/cjs/main.cjs"
   },
   "dependencies": {
-    "@ricsam/r5d-api": "^0.0.101",
+    "@ricsam/r5d-api": "^0.0.104",
     "dotenv": "^17",
     "qrcode": "^1.5.4",
     "ws": "^8.18.3"