qlogicagent 2.20.6 → 2.20.8

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

@@ -1,4 +1,5 @@
-export type { ShellType, PowerShellEdition, ShellSelection, WindowsPowerShellResolution, WindowsPowerShellProbe, BuildCommandOpts, BuiltCommand, ShellProvider, } from "./shell-provider.js";
+export type { ShellType, PowerShellEdition, ShellSelection, WindowsPowerShellResolution, WindowsPowerShellProbe, BuildCommandOpts, BuiltCommand, ShellProvider, ShellCommandCompatibilityCode, ShellCommandCompatibilityIssue, ShellCommandRetryHint, } from "./shell-provider.js";
+export { validateBashCommandCompatibility, validatePowerShellCommandCompatibility, } from "./command-compatibility.js";
 export { isPowerShellToolEnabled, resolveShellSelection, resolveWindowsPowerShell, getDefaultShellType, generateCommandId, } from "./shell-provider.js";
 export { createBashProvider } from "./bash-provider.js";
 export type { BashProviderOptions } from "./bash-provider.js";
@@ -13,5 +14,5 @@ export { TaskOutput, getTaskOutputDir, setTaskOutputDir, getTaskOutputPath, MAX_
 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, runWithCwd, getOriginalCwd, setShellProvider, getShellProvider, getActiveShellInfo, } from "./shell-exec.js";
-export type { ExecOptions } from "./shell-exec.js";
+export { exec, getCwd, setCwd, initCwd, runWithCwd, getOriginalCwd, setShellProvider, getShellProvider, getActiveShellInfo, preflightShellCommand, } from "./shell-exec.js";
+export type { ActiveShellInfo, ExecOptions, ShellCommandPreflightFailure, } from "./shell-exec.js";

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

@@ -1,4 +1,4 @@
-import type { ShellProvider, ShellType } from "./shell-provider.js";
+import type { ShellCommandCompatibilityIssue, ShellProvider, ShellType } from "./shell-provider.js";
 import { type ShellCommand } from "./shell-command.js";
 import type { SandboxConfig } from "./sandbox/sandbox-types.js";
 export type { ExecResult } from "./shell-command.js";
@@ -21,10 +21,6 @@ export interface ExecOptions {
     cwd?: string;
     /** Sandbox context injected by the host; absent = no OS sandbox (degrade). */
     sandbox?: SandboxConfig;
-    /** Late-bound CLI authority for active private runtime PATH entries. */
-    resolveRuntimePathEntries?: () => Promise<string[]>;
-    /** Opaque qlogicagent session identity for this shell call. */
-    sessionId?: string;
 }
 /**
  * Set the shell provider for this session.
@@ -47,13 +43,24 @@ export declare function getShellProvider(): ShellProvider;
  * lightweight turns), and a missing provider is a normal "fall back to
  * detectShellType()" signal, not an error.
  */
-export declare function getActiveShellInfo(): {
+export interface ActiveShellInfo {
     type: ShellType;
     shellPath: string;
     psEdition?: "5.1" | "7+";
     isGitBashOnWindows?: boolean;
-} | undefined;
-export declare function buildShellExecEnvironment(envOverrides: NodeJS.ProcessEnv, resolveRuntimePathEntries?: () => Promise<string[]>, sessionId?: string): Promise<NodeJS.ProcessEnv>;
+}
+export declare function getActiveShellInfo(): ActiveShellInfo | undefined;
+export interface ShellCommandPreflightFailure {
+    shell: ActiveShellInfo;
+    compatibility: ShellCommandCompatibilityIssue;
+}
+/**
+ * Validate a command against the exact provider that `exec()` will spawn.
+ * Returning undefined means either compatible syntax or an unconfigured
+ * provider; startup still remains the authority for provider configuration.
+ */
+export declare function preflightShellCommand(command: string): ShellCommandPreflightFailure | undefined;
+export declare function buildShellExecEnvironment(envOverrides: NodeJS.ProcessEnv): Promise<NodeJS.ProcessEnv>;
 /**
  * Execute a shell command using the configured provider.
  * Creates a new child process for each invocation.

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

@@ -9,6 +9,24 @@ export type ShellType = "bash" | "powershell";
  * Consumed by prompt/guidance layers to tailor syntax advice.
  */
 export type PowerShellEdition = "5.1" | "7+";
+/**
+ * Stable machine-readable reason returned when a command was authored for a
+ * different shell than the provider that will actually execute it.
+ */
+export type ShellCommandCompatibilityCode = "powershell_curl_alias_flags" | "powershell_legacy_chain_operator" | "powershell_posix_null_device" | "powershell_posix_heredoc" | "powershell_posix_stdin_redirection" | "powershell_posix_while_read" | "powershell_cmd_null_redirection" | "powershell_nested_command_string" | "bash_powershell_syntax";
+export interface ShellCommandRetryHint {
+    /** The caller should rewrite the command, not retry it unchanged. */
+    action: "rewrite_for_active_shell";
+    doNotRepeatUnchanged: true;
+    guidance: string;
+    alternatives: string[];
+}
+export interface ShellCommandCompatibilityIssue {
+    code: ShellCommandCompatibilityCode;
+    message: string;
+    incompatibleTokens: string[];
+    retry: ShellCommandRetryHint;
+}
 /**
  * Options passed to `buildExecCommand`.
  */
@@ -62,6 +80,14 @@ export interface ShellProvider {
      * Undefined/false otherwise. Read by prompt guidance for path conventions.
      */
     readonly isGitBashOnWindows?: boolean;
+    /**
+     * Validate syntax against this provider before spawning a process.
+     *
+     * This is intentionally provider-owned: `process.platform`, User-Agent, and
+     * environment guesses cannot distinguish PowerShell 5.1, PowerShell 7+, and
+     * Git Bash running on the same Windows machine.
+     */
+    validateCommandCompatibility?(command: string): ShellCommandCompatibilityIssue | null;
     /**
      * Wrap a raw user command into a full shell command string.
      * Handles:

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

@@ -84,11 +84,13 @@ export interface AcpRequestHandler {
     handleAcpSoloSpecChat(params: Record<string, unknown>): Promise<unknown>;
     handleAcpWorkflowChat(params: Record<string, unknown>): Promise<unknown>;
     handleAcpWorkflowMatchIntent(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpWorkflowPlanCommand(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloSpecJudge(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductCreate(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductPlan(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductConfirm(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductMessage(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpProductMutateDag(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductPause(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductResume(params: Record<string, unknown>): Promise<unknown>;
     handleAcpProductCancel(params: Record<string, unknown>): Promise<unknown>;
@@ -101,7 +103,8 @@ export interface AcpRequestHandler {
     handleAcpGoalUpdateGoal(params: Record<string, unknown>): Promise<unknown>;
     handleAcpGoalStop(params: Record<string, unknown>): Promise<unknown>;
     handleAcpGoalMessage(params: Record<string, unknown>): Promise<unknown>;
-    handleAcpGoalSubscribe(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalRecover(params: Record<string, unknown>): Promise<unknown>;
+    handleAcpGoalDismiss(params: Record<string, unknown>): Promise<unknown>;
 }
 export interface AcpServerConfig {
     verbose?: boolean;

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

@@ -4,5 +4,4 @@ export declare class HostCommunityClient {
     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-request-client.d.ts

@@ -26,6 +26,7 @@ export declare class HostRequestClient {
     private readonly log;
     private disposedReason;
     constructor(transport: HostRequestClientTransport, options?: HostRequestClientOptions);
+    supportsService(service: HostRequestParams["service"]): boolean;
     request(params: HostRequestParams, opts?: HostRequestOptions): Promise<unknown>;
     get pendingCount(): number;
     handleResponse(msg: AcpJsonRpcResponse): boolean;

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

@@ -12,7 +12,7 @@ export declare class HostRunStateClient {
      * 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>;
+    recordEvent(runId: string, event: RunEvent, sessionId: string): Promise<void>;
     checkpoint(runId: string, snapshot: unknown, sessionId: string, checkpointId?: string): Promise<void>;
     get(runId: string, sessionId: string): Promise<RunState>;
     list(projectId: string, sessionId: string, kind?: "solo" | "product" | "goal"): Promise<RunState[]>;