@uipath/codedagent-tool 1.0.4 → 1.195.0

package/dist/services/codedagent-init-service.d.ts

@@ -0,0 +1,38 @@
+import { type RunUipathPythonCommandFailureReason } from "@uipath/uipath-python-bridge";
+/** Pass-through of the bridge's {@link RunUipathPythonCommandFailureReason} — keeps both consumers in lockstep on one taxonomy. */
+export type CodedagentInitFailureReason = RunUipathPythonCommandFailureReason;
+export interface CodedagentInitOptions {
+    /** Working dir for the Python spawn. Required — `uipath init` writes `.uipath/` + `uipath.json` under cwd. */
+    cwd: string;
+    /** Extra args forwarded after `init`. Matches `uip codedagent init <args...>`. */
+    args?: string[];
+    /** Cancel the spawn from the host (e.g. the user dismisses a progress UI). */
+    signal?: AbortSignal;
+}
+export interface CodedagentInitSuccess {
+    ok: true;
+    /** Absolute path to the Python `uipath` executable invoked (resolved from the cache). Useful for "[ok] ran <path>" logging. */
+    pythonExePath: string;
+    /** Captured stdout from the Python process (empty when the binary writes only to its own stdio). */
+    stdout: string;
+}
+export interface CodedagentInitFailure {
+    ok: false;
+    reason: CodedagentInitFailureReason;
+    /** Short single-line summary suitable for top-level surfacing. */
+    message: string;
+    /** Remediation guidance. For `python_not_configured` / `uipath_exe_missing` this is `"Run 'uip codedagent setup' first to configure environment."`. */
+    instructions: string;
+    /** Recommended exit code. `1` default; `3` for `command_disabled`; Python's exit code for `command_failed`. */
+    exitCode: number;
+    /** Captured stderr — populated for `spawn_failed` / `command_failed` so callers can show the user the real error without re-spawning. */
+    stderr?: string;
+}
+export type CodedagentInitResult = CodedagentInitSuccess | CodedagentInitFailure;
+/**
+ * Programmatic core of `uip codedagent init`. Thin adapter over {@link runUipathPythonCommand} —
+ * shares the same cache/auth/preflight pipeline with the CLI path. Library-friendly:
+ * `stdio: "pipe"` captures Python's output into the result; does not touch
+ * `OutputFormatter`/`processContext`.
+ */
+export declare function codedagentInitAsync(options: CodedagentInitOptions): Promise<CodedagentInitResult>;