qlogicagent 2.20.2 → 2.20.4

package/dist/types/skills/tools/file-text-snapshot.d.ts

@@ -0,0 +1,24 @@
+export type TextFileEncoding = "utf8" | "utf16le" | "utf16be";
+export type TextFileEol = "\n" | "\r\n" | "\r";
+export interface TextFileFormat {
+    encoding: TextFileEncoding;
+    bom: boolean;
+    eol: TextFileEol;
+}
+export interface TextFileSnapshot {
+    text: string;
+    /** SHA-256 of the exact on-disk bytes, including any BOM. */
+    contentHash: string;
+    format: TextFileFormat;
+}
+export interface TextFileWriteOptions {
+    /** Reject the write if the current on-disk byte hash differs. */
+    expectedHash?: string;
+    /** Atomically fail instead of replacing an existing destination. */
+    createOnly?: boolean;
+    /** Explicit output format, used when moving a file to a new path. */
+    format?: TextFileFormat;
+}
+export type TextFileReadResult = string | TextFileSnapshot;
+export declare function textFromReadResult(result: TextFileReadResult): string;
+export declare function snapshotFromReadResult(result: TextFileReadResult): TextFileSnapshot | undefined;

package/dist/types/skills/tools/lsp-tool.d.ts

@@ -139,7 +139,7 @@ export interface LspToolDeps {
         character?: number;
         newName?: string;
         includeContext?: boolean;
-    }): Promise<LspResult>;
+    }, signal?: AbortSignal): Promise<LspResult>;
     /** Check if file exists and get its size */
     statFile?(filePath: string): Promise<{
         exists: boolean;

package/dist/types/skills/tools/patch-tool.d.ts

@@ -1,4 +1,5 @@
 import type { PortableTool } from "../portable-tool.js";
+import { type TextFileReadResult, type TextFileWriteOptions } from "./file-text-snapshot.js";
 export declare const PATCH_TOOL_NAME: "patch";
 export interface PatchToolParams {
     /** V4A unified diff or simple find-replace */
@@ -28,11 +29,17 @@ export interface PatchResult {
     errors: string[];
 }
 export interface PatchToolDeps {
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    deleteFile(path: string): Promise<void>;
+    readFile(path: string): Promise<TextFileReadResult>;
+    writeFile(path: string, content: string, options?: TextFileWriteOptions): Promise<void | {
+        contentHash: string;
+    }>;
+    deleteFile(path: string, options?: Pick<TextFileWriteOptions, "expectedHash">): Promise<void>;
     fileExists(path: string): Promise<boolean>;
     resolvePath(input: string): string;
+    /** Validate access to a resolved patch target. Null means allowed. */
+    validatePath?(path: string): string | null;
+    /** Reject stale explicit-read observations before parsing/mutating targets. */
+    checkConcurrentModification?(path: string): string | null;
 }
 export type MatchStrategy = "exact" | "line_trimmed" | "whitespace_normalized" | "indentation_flexible" | "escape_normalized" | "trimmed_boundary" | "unicode_normalized" | "block_anchor" | "context_aware";
 interface MatchResult {

package/dist/types/skills/tools/read-tool.d.ts

@@ -4,6 +4,7 @@ export interface ReadToolParams {
     path: string;
     offset?: number;
     limit?: number;
+    includeMetadata?: boolean;
 }
 export declare const READ_TOOL_SCHEMA: {
     readonly type: "object";
@@ -20,6 +21,10 @@ export declare const READ_TOOL_SCHEMA: {
             readonly type: "number";
             readonly description: "Maximum number of lines to read. Default/max: 2000.";
         };
+        readonly includeMetadata: {
+            readonly type: "boolean";
+            readonly description: "Scan to EOF to return an exact totalLines and sha256 contentHash. Default false for low-latency large-file windows.";
+        };
     };
     readonly required: readonly ["path"];
 };
@@ -27,9 +32,26 @@ export type ReadResultType = "text" | "image" | "binary_rejected";
 /** Deps injected by the host runtime for file reading. */
 export interface ReadToolDeps {
     /** Read file content. Return string for text, image path for images, or rejection. */
-    readFile(path: string): Promise<{
+    readFile(path: string, window?: {
+        offset: number;
+        limit: number;
+        maxBytes: number;
+        scanToEnd?: boolean;
+    }): Promise<{
         type: "text";
         text: string;
+    } | {
+        type: "text_window";
+        text: string;
+        totalLines?: number;
+        startLine: number;
+        endLine: number;
+        hasMore: boolean;
+        fileSizeBytes: number;
+        scannedBytes: number;
+        contentHash?: string;
+        metadataComplete: boolean;
+        truncatedByBytes: boolean;
     } | {
         type: "image";
         localPath: string;

package/dist/types/skills/tools/repo-map-tool.d.ts

@@ -0,0 +1,52 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const REPO_MAP_TOOL_NAME: "repo_map";
+export type RepoMapRefreshMode = "full" | "incremental";
+export type RepoMapSymbolKind = "class" | "function" | "interface" | "type" | "enum" | "constant";
+export interface RepoMapSymbol {
+    kind: RepoMapSymbolKind;
+    name: string;
+    line: number;
+}
+export interface RepoMapFile {
+    path: string;
+    symbols: RepoMapSymbol[];
+    /** Conservative import/module specifiers; a lightweight navigation graph, not compiler resolution. */
+    dependencies?: string[];
+}
+export interface RepoMapMetadata {
+    mode: RepoMapRefreshMode;
+    scannedFiles: number;
+    changedFiles: number;
+    generation: number;
+    totalFiles: number;
+    matchedFiles: number;
+    truncated: boolean;
+    partial?: boolean;
+    stale?: boolean;
+    warning?: string;
+}
+export interface RepoMapResult {
+    files: RepoMapFile[];
+    metadata: RepoMapMetadata;
+}
+export interface RepoMapQuery {
+    query?: string;
+    path?: string;
+    maxFiles?: number;
+    forceFull?: boolean;
+}
+export interface RepoMapService {
+    getMap(query?: RepoMapQuery): Promise<RepoMapResult>;
+}
+export interface RepoMapToolParams {
+    query?: string;
+    path?: string;
+    maxFiles?: number;
+    refresh?: boolean;
+}
+export interface RepoMapToolDeps {
+    workspaceRoot: string;
+    repoMap: RepoMapService;
+    maxResultChars?: number;
+}
+export declare function createRepoMapTool(deps: RepoMapToolDeps): PortableTool<RepoMapToolParams>;

package/dist/types/skills/tools/search-tool.d.ts

@@ -62,7 +62,9 @@ export interface SearchContentResult {
 }
 export interface SearchOutput {
     mode: SearchMode;
-    totalMatches: number;
+    totalMatches?: number;
+    returnedMatches: number;
+    totalMatchesKnown: boolean;
     truncated: boolean;
     fileResults?: SearchFileResult[];
     contentResults?: SearchContentResult[];
@@ -78,9 +80,11 @@ export interface SearchToolDeps {
     glob(pattern: string, options: {
         cwd: string;
         limit: number;
+        offset?: number;
     }): Promise<{
         files: string[];
         truncated: boolean;
+        totalMatches?: number;
     }>;
     /**
      * Search file contents using regex.
@@ -105,6 +109,9 @@ export interface SearchToolDeps {
             contextAfter?: string[];
         }>;
         truncated: boolean;
+        /** Exact match count before pagination, omitted if the backend stopped early. */
+        totalMatches?: number;
+        totalMatchesKnown?: boolean;
         /**
          * Optional incompleteness note from the backend (e.g. the search process was
          * killed by timeout/output cap). Appended verbatim to the model-visible
@@ -114,5 +121,7 @@ export interface SearchToolDeps {
     }>;
     /** Resolve relative path to absolute. If omitted, cwd is used. */
     resolvePath?(input: string): string;
+    /** Validate access to the resolved search root. Null means allowed. */
+    validatePath?(path: string): string | null;
 }
 export declare function createSearchTool(deps: SearchToolDeps): PortableTool<SearchToolParams>;

package/dist/types/skills/tools/shell/index.d.ts

@@ -10,9 +10,8 @@ export { getDestructiveCommandWarning, getPowerShellDestructiveCommandWarning, }
 export type { CommandSemanticResult } from "./command-semantics.js";
 export { interpretCommandResult } from "./command-semantics.js";
 export { TaskOutput, getTaskOutputDir, setTaskOutputDir, getTaskOutputPath, MAX_TASK_OUTPUT_BYTES, } from "./task-output.js";
-export type { ProgressCallback } from "./task-output.js";
 export type { ExecResult, ShellCommand } from "./shell-command.js";
 export { wrapSpawn, createAbortedCommand, createFailedCommand, } from "./shell-command.js";
 export { subprocessEnv } from "./subprocess-env.js";
-export { exec, getCwd, setCwd, initCwd, getOriginalCwd, setShellProvider, getShellProvider, getActiveShellInfo, } from "./shell-exec.js";
+export { exec, getCwd, setCwd, initCwd, runWithCwd, getOriginalCwd, setShellProvider, getShellProvider, getActiveShellInfo, } from "./shell-exec.js";
 export type { ExecOptions } from "./shell-exec.js";

package/dist/types/skills/tools/shell/shell-command.d.ts

@@ -1,4 +1,4 @@
-import type { ChildProcess } from "node:child_process";
+import { type ChildProcess } from "node:child_process";
 import { TaskOutput } from "./task-output.js";
 export interface ExecResult {
     stdout: string;

package/dist/types/skills/tools/shell/shell-exec.d.ts

@@ -1,6 +1,5 @@
 import type { ShellProvider, ShellType } from "./shell-provider.js";
 import { type ShellCommand } from "./shell-command.js";
-import { type ProgressCallback } from "./task-output.js";
 import type { SandboxConfig } from "./sandbox/sandbox-types.js";
 export type { ExecResult } from "./shell-command.js";
 export declare function getCwd(): string;
@@ -9,9 +8,10 @@ export declare function setCwd(path: string, relativeTo?: string, opts?: {
 }): boolean;
 export declare function getOriginalCwd(): string;
 export declare function initCwd(cwd: string): void;
+/** Bind shell and relative file-tool CWD state to one async turn. */
+export declare function runWithCwd<T>(cwd: string, action: () => Promise<T>): Promise<T>;
 export interface ExecOptions {
     timeout?: number;
-    onProgress?: ProgressCallback;
     /** When true, `cd` in the command does NOT update the session CWD. */
     preventCwdChanges?: boolean;
     shouldAutoBackground?: boolean;

package/dist/types/skills/tools/shell/task-output.d.ts

@@ -1,5 +1,9 @@
-/** Progress callback — matches cc's signature. */
-export type ProgressCallback = (lastLines: string, allLines: string, totalLines: number, totalBytes: number, isIncomplete: boolean) => void;
+export interface TaskOutputProgressSnapshot {
+    output: string;
+    totalBytes: number;
+    visibleLines: number;
+    truncated: boolean;
+}
 /** Max output file on disk (background tasks). */
 export declare const MAX_TASK_OUTPUT_BYTES: number;
 export declare const MAX_TASK_OUTPUT_BYTES_DISPLAY = "5GB";
@@ -20,7 +24,7 @@ export declare class TaskOutput {
     readonly taskId: string;
     readonly path: string;
     readonly stdoutToFile: boolean;
-    constructor(taskId: string, onProgress: ProgressCallback | null, stdoutToFile?: boolean, maxMemory?: number);
+    constructor(taskId: string, stdoutToFile?: boolean, maxMemory?: number);
     /** Write stdout data (pipe mode). */
     writeStdout(data: string): void;
     /** Write stderr data (pipe mode). */
@@ -36,6 +40,11 @@ export declare class TaskOutput {
      * cleanup), so it is measured before sanitizing.
      */
     getStdout(): Promise<string>;
+    /**
+     * Read a bounded live-output window for progress display. File-mode commands
+     * read only the tail window, so polling cost does not grow with command output.
+     */
+    getProgressSnapshot(maxBytes?: number): Promise<TaskOutputProgressSnapshot>;
     /** Get captured stderr. In file mode stderr is interleaved with stdout. */
     getStderr(): string;
     get outputFileSize(): number;

package/dist/types/skills/tools/subagent-decision-tool.d.ts

@@ -0,0 +1,15 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const SUBAGENT_DECISION_TOOL_NAME: "subagent_decision";
+export type SubagentDecision = "adopted" | "partially_adopted" | "rejected";
+export interface SubagentDecisionToolParams {
+    subagentId: string;
+    decision: SubagentDecision;
+    summary?: string;
+}
+export interface SubagentDecisionToolDeps {
+    readonly currentTurnId?: string;
+    readonly currentSessionId?: string;
+    getActiveProjectRoot?(): string;
+    sendNotification(method: string, params: Record<string, unknown>): void;
+}
+export declare function createSubagentDecisionTool(deps: SubagentDecisionToolDeps): PortableTool<SubagentDecisionToolParams>;

package/dist/types/skills/tools/task-tool.d.ts

@@ -53,6 +53,8 @@ export interface TaskToolParams {
     action: TaskAction;
     id?: number;
     taskId?: string;
+    taskIds?: string[];
+    waitMs?: number;
     title?: string;
     description?: string;
     status?: TaskStatus;
@@ -76,6 +78,20 @@ export declare const TASK_TOOL_SCHEMA: {
             readonly type: "string";
             readonly description: "[output|cancel] Background task id (returned by agent background=true / exec background=true).";
         };
+        readonly taskIds: {
+            readonly type: "array";
+            readonly maxItems: 16;
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "[output] Several background task ids to check together. The wait delay is applied once, then all statuses are refreshed in parallel.";
+        };
+        readonly waitMs: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 10000;
+            readonly description: "[output] Optional one-time wait before refreshing running tasks. A timeout only reports current status; it never cancels or redelegates.";
+        };
         readonly title: {
             readonly type: "string";
             readonly description: "[create|update] Task title (3-7 words, imperative form).";
@@ -113,8 +129,6 @@ export declare const TASK_TOOL_SCHEMA: {
 export interface TaskToolOptions {
     /** Unique agent/session identifier for per-agent task isolation. */
     agentId?: string;
-    /** Enable verification nudge (default: true). */
-    verificationNudge?: boolean;
 }
 export interface TaskToolHooks {
     onTaskCreated?: (task: TaskItem) => void;

package/dist/types/skills/tools/write-tool.d.ts

@@ -1,4 +1,5 @@
 import type { PortableTool } from "../portable-tool.js";
+import type { TextFileWriteOptions } from "./file-text-snapshot.js";
 export declare const WRITE_TOOL_NAME: "write";
 export interface WriteToolParams {
     path: string;
@@ -21,7 +22,7 @@ export declare const WRITE_TOOL_SCHEMA: {
 /** Deps injected by the host runtime for file writing. */
 export interface WriteToolDeps {
     /** Write content to a file. Create parent dirs as needed. */
-    writeFile(path: string, content: string): Promise<void>;
+    writeFile(path: string, content: string, options?: TextFileWriteOptions): Promise<void>;
     /** Check whether the resolved path already exists. */
     fileExists?(path: string): Promise<boolean> | boolean;
     /** Resolve a relative path to absolute. */

package/dist/types/transport/acp-server.d.ts

@@ -80,6 +80,7 @@ export interface AcpRequestHandler {
     handleAcpSoloSubscribe(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloMessage(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloEvaluate(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpSoloDelete(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloSpecChat(params: Record<string, unknown>): Promise<unknown>;
     handleAcpWorkflowChat(params: Record<string, unknown>): Promise<unknown>;
     handleAcpWorkflowMatchIntent(params: Record<string, unknown>): Promise<unknown>;

package/dist/types/transport/host-cloud-auth-client.d.ts

@@ -0,0 +1,10 @@
+import type { HostRequestClient } from "./host-request-client.js";
+export interface HostCloudAuthProbeResult {
+    ok: boolean;
+    status: number;
+}
+export declare class HostCloudAuthClient {
+    private readonly client;
+    constructor(client: Pick<HostRequestClient, "request">);
+    probeSession(): Promise<HostCloudAuthProbeResult>;
+}

package/dist/types/transport/host-community-client.d.ts

@@ -0,0 +1,8 @@
+import type { HostRequestClient } from "./host-request-client.js";
+export declare class HostCommunityClient {
+    private readonly client;
+    constructor(client: Pick<HostRequestClient, "request">);
+    resolveInstall(resourceId: string, version?: string): Promise<unknown>;
+    listResourceVersions(resourceId: string): Promise<unknown>;
+    resolveRuntime(id: string, platform: string): Promise<unknown>;
+}

package/dist/types/transport/host-run-state-client.d.ts

@@ -6,6 +6,12 @@ export declare class HostRunStateClient {
     private readonly requester;
     constructor(requester: HostRunStateRequester);
     open(runId: string, kind: "solo" | "product" | "goal", projectId: string, sessionId: string): Promise<string>;
+    /**
+     * Atomic open + first checkpoint. Prefer this over `open()` then `checkpoint()` whenever the first
+     * snapshot is already in hand: the two-call sequence can leave an addressable run with no checkpoint,
+     * and one such remnant permanently breaks the whole project's run-list projection.
+     */
+    openWithCheckpoint(runId: string, kind: "solo" | "product" | "goal", projectId: string, snapshot: unknown, sessionId: string, checkpointId?: string): Promise<string>;
     recordEvent(runId: string, event: Omit<RunEvent, "member">, sessionId: string): Promise<void>;
     checkpoint(runId: string, snapshot: unknown, sessionId: string, checkpointId?: string): Promise<void>;
     get(runId: string, sessionId: string): Promise<RunState>;

package/dist/types/workflow-host.d.ts

@@ -20,12 +20,19 @@ export { hostExecutors, HOST_BACKED_KINDS } from "./orchestration/workflow/host-
 export type { ExecutorHost } from "./orchestration/workflow/node-schema.js";
 export type { AgentHostRequest, ApprovalHostRequest, ChannelHostRequest, HttpHostRequest, McpHostRequest, MemoryHostRequest, SubworkflowHostRequest, WebhookWaitHostRequest, } from "./orchestration/workflow/node-schema.js";
 export { WorkflowRunHistoryStore } from "./orchestration/workflow/run-history-store.js";
+export type { RecoverableWorkflowRun } from "./orchestration/workflow/run-history-store.js";
+export type { WorkflowTriggerKind } from "./orchestration/workflow/budget-permission-gate.js";
 export { FileRunCheckpoint } from "./orchestration/workflow/run-checkpoint-store.js";
 export type { RunCheckpoint } from "./orchestration/workflow/run-checkpoint-store.js";
 export { WorkflowAuditStore } from "./orchestration/workflow/workflow-audit-store.js";
 export { applyPatch, PatchError } from "./orchestration/workflow/workflow-patch.js";
-export type { PatchEnvelope, WorkflowPatch } from "./orchestration/workflow/workflow-patch.js";
+export type { ApplyResult, PatchEnvelope, WorkflowPatch, WorkflowPatchDiagnostic } from "./orchestration/workflow/workflow-patch.js";
+export { builtinWorkflowCapabilities } from "./orchestration/workflow/builtin-capabilities.js";
+export { buildWorkflowEditContextCapsule } from "./orchestration/workflow/workflow-edit-context.js";
+export type { WorkflowEditContextCapsule, WorkflowRunEvidence } from "./orchestration/workflow/workflow-edit-context.js";
 export { fromWorkflowBundle, toWorkflowBundle } from "./orchestration/workflow/workflow-bundle.js";
 export type { ParsedBundle, WorkflowBundle } from "./orchestration/workflow/workflow-bundle.js";
+export { applyWorkflowTemplateSetup, projectWorkflowTemplateSetup, validateWorkflowTemplateSetup, } from "./orchestration/workflow/workflow-template-setup.js";
+export type { WorkflowTemplateSetupBinding, WorkflowTemplateSetupField, WorkflowTemplateSetupManifest, WorkflowTemplateSetupProjection, WorkflowTemplateSetupState, WorkflowTemplateSetupValue, } from "./orchestration/workflow/workflow-template-setup.js";
 export { renderWorkflow } from "./orchestration/workflow/workflow-render.js";
 export type { WorkflowDef } from "./orchestration/workflow/node-schema.js";