@aixnn/aixautots 0.5.3 → 0.5.4

package/dist/ScriptStudio-DaCqOF5H.d.ts

@@ -0,0 +1,43 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+/** Context handed to host-injected slots (agent / inspector). */
+interface ScriptStudioSlotContext {
+    /** Persisted script id (undefined until first save). */
+    scriptId?: string;
+    /** Currently selected run device id. */
+    deviceId: string | null;
+    /** Resolved platform of the selected device ('android' | 'ios' | …). */
+    platform: 'android' | 'ios';
+    /** Current editor source. */
+    code: string;
+    /** Replace the entire editor source. */
+    setCode: (code: string) => void;
+    /** Append a snippet to the editor source (newline-separated). */
+    insertSnippet: (snippet: string) => void;
+    /** Open the host-injected device inspector (same as the header button). */
+    openInspector: () => void;
+}
+interface ScriptStudioProps {
+    /** Route param: the script to open. Undefined ⇒ a fresh "New Script". */
+    scriptId?: string;
+    /** Called after the first create assigns an id, so the host can switch the
+     *  URL to `/editor/:id` (the SDK does not depend on a router). */
+    onScriptIdChange?: (id: string) => void;
+    /** Host-injected LLM agent panel (right column). Not rendered if omitted. */
+    renderAgentPanel?: (ctx: ScriptStudioSlotContext) => ReactNode;
+    /** Host-injected device inspector (modal/overlay). Not rendered if omitted.
+     *  `open`/`onClose` are driven by the studio's "设备/Inspector" button. */
+    renderInspector?: (ctx: ScriptStudioSlotContext & {
+        open: boolean;
+        onClose: () => void;
+    }) => ReactNode;
+    /** localStorage key for the resizable console height. */
+    consoleHeightStorageKey?: string;
+    /** Extra controls rendered at the right end of the header (e.g. a language
+     *  toggle). The studio itself stays app-chrome-agnostic. */
+    headerExtra?: ReactNode;
+}
+declare function ScriptStudio({ scriptId, onScriptIdChange, renderAgentPanel, renderInspector, consoleHeightStorageKey, headerExtra, }: ScriptStudioProps): react.JSX.Element;
+
+export { type ScriptStudioProps as S, type ScriptStudioSlotContext as a, ScriptStudio as b };

package/dist/agent-runner-V60B0is1.d.ts

@@ -0,0 +1,57 @@
+/**
+ * LLM agent 传输的注入接口。`AgentPanel` 的 UI 与可移植逻辑在 aixautots 内，但「如何
+ * 真正跑一个本地 agent」是宿主特有的（桌面端经 Tauri IPC spawn claude/codex CLI，
+ * 经事件流式回传）——所以这部分由宿主实现 `AgentRunner` 注入，aixautots 不依赖 Tauri。
+ *
+ * 非桌面/无本地 agent 的宿主可传 `available: false`，面板会显示「需在桌面应用中使用」。
+ *
+ * ── 实现是可替换的：Tauri 只是其中一种 ──
+ * 本接口刻意与传输解耦，`AgentPanel` 不知底层是本机还是服务端。已有/可有的实现：
+ *   1) 本机 CLI（现状）：桌面端 `frontend/src/lib/agentRunner.ts` 用 Tauri `invoke`/`listen`
+ *      spawn 本机 claude/codex CLI（密钥/算力在用户机器）。
+ *   2) 服务端 agent：服务器跑 claude/codex CLI（密钥/算力在后端），HTTP 起停 + SSE 流式
+ *      回传。**SDK 已内置实现** `createBackendAgentRunner(client)`（见 `backend-agent-runner.ts`）；
+ *      editor 薄壳按环境切换即可，aixautots 与 AgentPanel 零改动：
+ *        agentRunner={isTauri() ? tauriAgentRunner : createBackendAgentRunner(client)}
+ *      （仅待后端落地 `/api/agent/*` 端点；客户端侧已就绪。）
+ *
+ *   后端端点契约（详见 `backend-agent-runner.ts`）：`POST /api/agent/{start,send,stop}` +
+ *   `GET /api/agent/stream`(SSE)；事件载荷映射到本文件的 `AgentStreamEvent`
+ *   （`stream: 'stdout'|'stderr'|'done'`，done 带最终 `script` 全文）。鉴权复用 user JWT。
+ *   失败可经 `stream:'stderr'` 文本上报，或 `done` 不带 `script` 表示无产出。
+ */
+type AgentKind = 'claude' | 'codex';
+interface AgentStreamEvent {
+    /** 该事件所属脚本 id（面板按当前 scriptId 过滤）。 */
+    scriptId: string;
+    stream: 'stdout' | 'stderr' | 'done';
+    /** stdout/stderr 增量文本。 */
+    chunk?: string;
+    /** done 时回带的最终 script.ts 全文（非空且有变化则替换编辑器）。 */
+    script?: string;
+}
+interface AgentSendRequest {
+    agent: AgentKind;
+    scriptId: string;
+    code: string;
+    deviceId: string;
+    userMsg: string;
+    /** 本轮是否是会话首轮（决定 start vs send 语义，由实现自行处理）。 */
+    isFirst: boolean;
+}
+interface AgentRunner {
+    /** 本机 agent 后端是否可用（如桌面/Tauri 环境）。false 时面板显示提示而不渲染交互。 */
+    available: boolean;
+    /** 可选：从宿主设置读默认 agent / 权限模式（面板挂载时调用）。 */
+    defaults?: () => Promise<{
+        agent?: AgentKind;
+    }>;
+    /** 启动或继续一轮 agent。权限模式等宿主细节由实现内部处理。 */
+    send: (req: AgentSendRequest) => Promise<void>;
+    /** 停止进行中的一轮。 */
+    stop: (scriptId: string) => Promise<void>;
+    /** 订阅流式输出；返回取消订阅函数。面板内部按 scriptId 过滤事件。 */
+    subscribe: (on: (ev: AgentStreamEvent) => void) => () => void;
+}
+
+export type { AgentKind as A, AgentRunner as a, AgentSendRequest as b, AgentStreamEvent as c };

package/dist/automation-queue-CKsueO9z.d.ts

@@ -0,0 +1,72 @@
+import { a as RunEventKind, A as AixConfig, R as ResolvedConfig } from './config-fsx4jlLK.js';
+import { S as Script } from './types-C2WXVcam.js';
+
+interface FlowSubmit {
+    /** Inline flow JSON (XOR scriptId). */
+    flow?: unknown;
+    /** Reference a stored script by id (XOR flow). */
+    scriptId?: string;
+    /** Internal device UUIDs (non-empty). */
+    deviceIds: string[];
+    params?: unknown;
+    mode?: unknown;
+    expiresIn?: number;
+}
+/** A normalized per-device execution event. */
+interface FlowEvent {
+    deviceId: string;
+    event: RunEventKind;
+}
+declare class FlowRun {
+    readonly taskId: string;
+    readonly targets: string[];
+    private readonly socket;
+    private readonly eventListeners;
+    private readonly doneListeners;
+    private readonly finished;
+    private doneFired;
+    private cursor;
+    private constructor();
+    static submit(cfg: AixConfig | ResolvedConfig, body: FlowSubmit): Promise<FlowRun>;
+    on(event: 'event', cb: (e: FlowEvent) => void): () => void;
+    on(event: 'done', cb: () => void): () => void;
+    /** Called (via microtask) when submit() returns targets:[]. */
+    fireDoneIfEmpty(): void;
+    private onMessage;
+    close(): void;
+}
+
+/** 批次派发模式。`'round-robin'` 为默认(行分摊到设备);`'broadcast'` 每行全量。 */
+type QueueMode = 'round-robin' | 'broadcast';
+/** 一个批次的输入。`script` 与 `flow` 二选一(与 `FlowRun`/后端的 flow XOR
+ *  script 约束一致)。`rows` 每项是一组动态参数值(覆写 `flow.variables`);空
+ *  数组等价于「无参数」单组(提交一次,沿用脚本自带 variables)。 */
+interface BatchConfig {
+    /** 引用已存库脚本(XOR flow)。 */
+    script?: Pick<Script, 'id'> & {
+        id: string;
+    };
+    /** 内联 flow JSON(XOR script)。 */
+    flow?: unknown;
+    /** 每行 = 一组动态参数(如不同账户)。空 ⇒ 视作单组空参数,提交一次。 */
+    rows: Array<Record<string, unknown>>;
+    /** 目标设备内部 UUID(非空)。 */
+    deviceIds: string[];
+    /** 派发模式,默认 `'round-robin'`。 */
+    mode?: QueueMode;
+    /** 透传给 `FlowRun.submit` 的任务过期秒数(可选)。 */
+    expiresIn?: number;
+}
+/** 把 rows×mode 展开为多次 `FlowRun.submit`,返回每次提交得到的 task id 顺序数组。
+ *  逐行顺序提交(保留行序);任一行失败即抛出(已提交的行不回滚——它们是独立任务)。 */
+declare function submitBatch(cfg: AixConfig | ResolvedConfig, config: BatchConfig): Promise<string[]>;
+/** 自动化队列的薄封装:绑定一份 config,`submit(batch)` 即提交。无状态——
+ *  追踪/暂停/恢复由 `TasksApi`(`useAutomationQueue`)负责。 */
+declare class AutomationQueue {
+    private readonly cfg;
+    constructor(cfg: AixConfig | ResolvedConfig);
+    /** 展开并提交一个批次,返回 task id 数组。见 [`submitBatch`]。 */
+    submit(config: BatchConfig): Promise<string[]>;
+}
+
+export { AutomationQueue as A, type BatchConfig as B, type FlowEvent as F, type QueueMode as Q, FlowRun as a, type FlowSubmit as b, submitBatch as s };