neoctl 0.2.0 → 0.2.2

package/dist/server/event-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-mapper.js","sourceRoot":"","sources":["../../src/server/event-mapper.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO;YACL,GAAG,KAAK;YACR,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC;SACnC,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO;YACL,GAAG,KAAK;YACR,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC;SACnC,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,GAAW,EAAE,KAAiB;IACtF,OAAO;QACL,OAAO;QACP,GAAG;QACH,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC;QACjC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAY;IAClC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;AACJ,CAAC"}

package/dist/server/query-runtime.d.ts

@@ -0,0 +1,29 @@
+import type { QueryEngine } from "../core/query-engine.js";
+import type { RpcQueryEventEnvelope } from "./rpc-types.js";
+export interface QueryRunOptions {
+    queryId: string;
+    text: string;
+    displayText?: string;
+    disconnectPolicy?: "continue" | "cancel";
+    onEvent?: (event: RpcQueryEventEnvelope) => void;
+}
+export type QueryRunState = "running" | "completed" | "cancelled" | "failed";
+export declare class QueryRun {
+    private readonly engine;
+    private readonly options;
+    readonly queryId: string;
+    readonly startedAt: Date;
+    readonly disconnectPolicy: "continue" | "cancel";
+    private readonly controller;
+    private readonly buffer;
+    private state;
+    private seq;
+    private completion?;
+    constructor(engine: QueryEngine, options: QueryRunOptions);
+    start(): Promise<void>;
+    cancel(): void;
+    getState(): QueryRunState;
+    getBufferedEvents(afterSeq?: number): RpcQueryEventEnvelope[];
+    private run;
+    private pushEvent;
+}

package/dist/server/query-runtime.js

@@ -0,0 +1,61 @@
+import { createQueryEventEnvelope } from "./event-mapper.js";
+export class QueryRun {
+    engine;
+    options;
+    queryId;
+    startedAt = new Date();
+    disconnectPolicy;
+    controller = new AbortController();
+    buffer = [];
+    state = "running";
+    seq = 0;
+    completion;
+    constructor(engine, options) {
+        this.engine = engine;
+        this.options = options;
+        this.queryId = options.queryId;
+        this.disconnectPolicy = options.disconnectPolicy ?? "continue";
+    }
+    start() {
+        if (this.completion)
+            return this.completion;
+        this.completion = this.run();
+        return this.completion;
+    }
+    cancel() {
+        if (this.state !== "running")
+            return;
+        this.state = "cancelled";
+        this.controller.abort();
+    }
+    getState() {
+        return this.state;
+    }
+    getBufferedEvents(afterSeq = 0) {
+        return this.buffer.filter((entry) => entry.seq > afterSeq);
+    }
+    async run() {
+        try {
+            for await (const event of this.engine.sendUserText(this.options.text, {
+                abortSignal: this.controller.signal,
+                displayText: this.options.displayText,
+            })) {
+                this.pushEvent(event);
+            }
+            if (this.state === "running")
+                this.state = this.controller.signal.aborted ? "cancelled" : "completed";
+        }
+        catch (error) {
+            this.state = this.controller.signal.aborted ? "cancelled" : "failed";
+            const normalized = error instanceof Error ? error : new Error(String(error));
+            this.pushEvent({ type: "error", error: normalized });
+            throw normalized;
+        }
+    }
+    pushEvent(event) {
+        const envelope = createQueryEventEnvelope(this.queryId, ++this.seq, event);
+        this.buffer.push(envelope);
+        this.options.onEvent?.(envelope);
+    }
+}
+//# sourceMappingURL=query-runtime.js.map

package/dist/server/query-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-runtime.js","sourceRoot":"","sources":["../../src/server/query-runtime.ts"],"names":[],"mappings":"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"}

package/dist/server/rpc-router.d.ts

@@ -0,0 +1,24 @@
+import type { AgentManager } from "./agent-manager.js";
+import type { ConnectionManager } from "./connection-manager.js";
+import type { JsonRpcError, JsonRpcRequest, JsonRpcSuccess } from "./rpc-types.js";
+export interface RpcRouterOptions {
+    agentManager: AgentManager;
+    connectionManager: ConnectionManager;
+    emitNotification: (connectionId: string, method: string, params: unknown) => void;
+}
+export declare class RpcRouter {
+    private readonly options;
+    constructor(options: RpcRouterOptions);
+    handle(connectionId: string, request: JsonRpcRequest): Promise<JsonRpcSuccess | JsonRpcError | null>;
+    private attach;
+    private detach;
+    private listSessions;
+    private deleteSession;
+    private startQuery;
+    private cancelQuery;
+    private resume;
+    private requireAttachedIdentity;
+    private requireAttachedIdentitySync;
+    private ok;
+    private error;
+}

package/dist/server/rpc-router.js

@@ -0,0 +1,165 @@
+export class RpcRouter {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async handle(connectionId, request) {
+        try {
+            switch (request.method) {
+                case "agent.attach":
+                    return this.ok(request.id, await this.attach(connectionId, request.params));
+                case "agent.detach":
+                    return this.ok(request.id, this.detach(connectionId, request.params));
+                case "session.list":
+                    return this.ok(request.id, await this.listSessions(connectionId, request.params));
+                case "session.delete":
+                    return this.ok(request.id, await this.deleteSession(connectionId, request.params));
+                case "query.start":
+                    return this.ok(request.id, await this.startQuery(connectionId, request.params));
+                case "query.cancel":
+                    return this.ok(request.id, this.cancelQuery(connectionId, request.params));
+                case "connection.resume":
+                    return this.ok(request.id, await this.resume(connectionId, request.params));
+                case "agent.list":
+                    return this.ok(request.id, this.options.agentManager.listSnapshots());
+                default:
+                    return this.error(request.id, -32601, `method not found: ${request.method}`);
+            }
+        }
+        catch (error) {
+            const normalized = error instanceof Error ? error : new Error(String(error));
+            return this.error(request.id, -32000, normalized.message, { stack: normalized.stack });
+        }
+    }
+    async attach(connectionId, params) {
+        const identity = normalizeIdentity(params);
+        const agent = await this.options.agentManager.attach(connectionId, identity, {
+            create: params?.create,
+            resume: params?.resume,
+        });
+        this.options.connectionManager.attachAgent(connectionId, identity);
+        return { key: agent.key, state: agent.state, snapshot: agent.engine.snapshot() };
+    }
+    detach(connectionId, params) {
+        const identity = normalizeIdentity(params);
+        const agent = this.options.agentManager.detach(connectionId, identity);
+        this.options.connectionManager.detachAgent(connectionId, identity);
+        return { detached: Boolean(agent), state: agent?.state };
+    }
+    async listSessions(connectionId, params) {
+        const identity = await this.requireAttachedIdentity(connectionId, params);
+        const agent = this.options.agentManager.get(identity);
+        if (!agent)
+            throw new Error(`agent not found: ${identity.agentId}`);
+        return {
+            current: agent.engine.snapshot().session,
+            available: await agent.engine.listSessions(params?.limit ?? 10),
+        };
+    }
+    async deleteSession(connectionId, params) {
+        const identity = await this.requireAttachedIdentity(connectionId, params);
+        const agent = this.options.agentManager.get(identity);
+        if (!agent)
+            throw new Error(`agent not found: ${identity.agentId}`);
+        return {
+            deleted: await agent.engine.deleteSession(required(params?.targetSessionId, "targetSessionId")),
+        };
+    }
+    async startQuery(connectionId, params) {
+        const identity = await this.requireAttachedIdentity(connectionId, params);
+        const queryId = params?.queryId?.trim() || createId("query");
+        const run = await this.options.agentManager.startQuery(identity, {
+            queryId,
+            text: required(params?.text, "text"),
+            displayText: params?.displayText,
+            disconnectPolicy: params?.disconnectPolicy,
+            onEvent: (event) => {
+                for (const target of this.options.connectionManager.listConnectionIdsForAgent(identity)) {
+                    this.options.emitNotification(target, "query.event", event);
+                }
+            },
+        });
+        return { queryId: run.queryId, state: run.getState() };
+    }
+    cancelQuery(connectionId, params) {
+        const identity = this.requireAttachedIdentitySync(connectionId, params);
+        return {
+            cancelled: this.options.agentManager.cancelQuery(identity, required(params?.queryId, "queryId")),
+        };
+    }
+    async resume(connectionId, params) {
+        const agents = params?.agents ?? [];
+        const queries = params?.queries ?? [];
+        const attached = [];
+        for (const locator of agents) {
+            const identity = normalizeIdentity(locator);
+            const agent = await this.options.agentManager.attach(connectionId, identity, { create: true, resume: true });
+            this.options.connectionManager.attachAgent(connectionId, identity);
+            attached.push({ key: agent.key, state: agent.state });
+        }
+        for (const query of queries) {
+            for (const identity of this.options.connectionManager.listAttachedAgents(connectionId)) {
+                const agent = this.options.agentManager.get(identity);
+                if (!agent?.activeQuery || agent.activeQuery.queryId !== query.queryId)
+                    continue;
+                for (const event of agent.activeQuery.getBufferedEvents(query.afterSeq ?? 0)) {
+                    this.options.emitNotification(connectionId, "query.event", event);
+                }
+            }
+        }
+        return { attached, replayedQueries: queries.map((item) => item.queryId) };
+    }
+    async requireAttachedIdentity(connectionId, params) {
+        return this.requireAttachedIdentitySync(connectionId, params);
+    }
+    requireAttachedIdentitySync(connectionId, params) {
+        const record = this.options.connectionManager.get(connectionId);
+        if (!record)
+            throw new Error(`connection not found: ${connectionId}`);
+        const requested = params?.userId ? normalizeIdentity(params) : undefined;
+        if (requested) {
+            const match = record.attachedAgents.get(locatorKey(requested));
+            if (match)
+                return match;
+            throw new Error(`agent is not attached to connection: ${locatorKey(requested)}`);
+        }
+        const first = record.attachedAgents.values().next().value;
+        if (!first)
+            throw new Error("no agent attached to connection");
+        return first;
+    }
+    ok(id, result) {
+        return {
+            jsonrpc: "2.0",
+            id: id ?? null,
+            result,
+        };
+    }
+    error(id, code, message, data) {
+        return {
+            jsonrpc: "2.0",
+            id: id ?? null,
+            error: { code, message, data },
+        };
+    }
+}
+function normalizeIdentity(params) {
+    return {
+        userId: required(params?.userId, "userId"),
+        agentId: params?.agentId?.trim() || "main",
+        sessionId: params?.sessionId?.trim() || undefined,
+    };
+}
+function required(value, field) {
+    const normalized = value?.trim();
+    if (!normalized)
+        throw new Error(`missing required field: ${field}`);
+    return normalized;
+}
+function locatorKey(identity) {
+    return `${identity.userId}:${identity.sessionId ?? "default"}:${identity.agentId}`;
+}
+function createId(prefix) {
+    return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+//# sourceMappingURL=rpc-router.js.map

package/dist/server/rpc-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-router.js","sourceRoot":"","sources":["../../src/server/rpc-router.ts"],"names":[],"mappings":"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"}

package/dist/server/rpc-types.d.ts

@@ -0,0 +1,92 @@
+import type { AgentEvent } from "../types/events.js";
+import type { SessionStoreSnapshot, SessionSummary } from "../session/session-store.js";
+export interface JsonRpcRequest<T = unknown> {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method: string;
+    params?: T;
+}
+export interface JsonRpcSuccess<T = unknown> {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result: T;
+}
+export interface JsonRpcError {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface RpcAgentLocator {
+    userId: string;
+    agentId?: string;
+    sessionId?: string;
+}
+export interface AgentAttachParams extends RpcAgentLocator {
+    create?: boolean;
+    resume?: boolean;
+}
+export interface AgentDetachParams extends RpcAgentLocator {
+}
+export interface SessionListParams extends RpcAgentLocator {
+    limit?: number;
+}
+export interface SessionDeleteParams extends RpcAgentLocator {
+    targetSessionId: string;
+}
+export interface QueryStartParams extends RpcAgentLocator {
+    queryId?: string;
+    text: string;
+    displayText?: string;
+    disconnectPolicy?: "continue" | "cancel";
+}
+export interface QueryCancelParams extends RpcAgentLocator {
+    queryId: string;
+}
+export interface QueryResumeItem {
+    queryId: string;
+    afterSeq?: number;
+}
+export interface ConnectionResumeParams {
+    agents?: RpcAgentLocator[];
+    queries?: QueryResumeItem[];
+}
+export interface RpcSessionInfo {
+    current?: SessionStoreSnapshot;
+    available?: SessionSummary[];
+}
+export interface RpcAgentSnapshot {
+    key: string;
+    userId: string;
+    agentId: string;
+    state: string;
+    attachedConnections: number;
+    activeQueryId?: string;
+    snapshot: ReturnType<import("../core/query-engine.js").QueryEngine["snapshot"]>;
+}
+export interface RpcQueryEventEnvelope {
+    queryId: string;
+    seq: number;
+    event: SerializedAgentEvent;
+    createdAt: string;
+}
+export type SerializedAgentEvent = AgentEvent | ({
+    type: "retrying";
+    attempt: number;
+    delayMs: number;
+    error: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+}) | ({
+    type: "error";
+    error: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+});

package/dist/server/rpc-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rpc-types.js.map

package/dist/server/rpc-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-types.js","sourceRoot":"","sources":["../../src/server/rpc-types.ts"],"names":[],"mappings":""}

package/dist/server/ws-server.d.ts

@@ -0,0 +1,22 @@
+import http from "node:http";
+import { WebSocketServer } from "ws";
+import { AgentManager, type AgentManagerOptions } from "./agent-manager.js";
+import { ConnectionManager } from "./connection-manager.js";
+import { RpcRouter } from "./rpc-router.js";
+export interface JsonRpcWebSocketServerOptions extends AgentManagerOptions {
+    server?: http.Server;
+    path?: string;
+    sweepIntervalMs?: number;
+}
+export declare class JsonRpcWebSocketServer {
+    readonly agentManager: AgentManager;
+    readonly connectionManager: ConnectionManager;
+    readonly websocketServer: WebSocketServer;
+    readonly router: RpcRouter;
+    private readonly sweepTimer;
+    constructor(options?: JsonRpcWebSocketServerOptions);
+    close(): Promise<void>;
+    private handleConnection;
+    private findSocket;
+}
+export declare function startJsonRpcWebSocketServer(options?: JsonRpcWebSocketServerOptions): Promise<JsonRpcWebSocketServer>;

package/dist/server/ws-server.js

@@ -0,0 +1,84 @@
+import { WebSocketServer } from "ws";
+import { AgentManager } from "./agent-manager.js";
+import { ConnectionManager } from "./connection-manager.js";
+import { RpcRouter } from "./rpc-router.js";
+export class JsonRpcWebSocketServer {
+    agentManager;
+    connectionManager = new ConnectionManager();
+    websocketServer;
+    router;
+    sweepTimer;
+    constructor(options = {}) {
+        this.agentManager = new AgentManager(options);
+        this.websocketServer = new WebSocketServer({ noServer: !options.server, server: options.server, path: options.path });
+        this.router = new RpcRouter({
+            agentManager: this.agentManager,
+            connectionManager: this.connectionManager,
+            emitNotification: (connectionId, method, params) => {
+                const socket = this.findSocket(connectionId);
+                if (!socket || socket.readyState !== socket.OPEN)
+                    return;
+                socket.send(JSON.stringify({ jsonrpc: "2.0", method, params }));
+            },
+        });
+        this.websocketServer.on("connection", (socket) => this.handleConnection(socket));
+        this.sweepTimer = setInterval(() => {
+            this.agentManager.sweep();
+        }, options.sweepIntervalMs ?? 30_000);
+        this.sweepTimer.unref?.();
+    }
+    close() {
+        clearInterval(this.sweepTimer);
+        return new Promise((resolve, reject) => {
+            this.websocketServer.close((error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        });
+    }
+    handleConnection(socket) {
+        const connectionId = createConnectionId();
+        this.connectionManager.open(connectionId);
+        socket.__connectionId = connectionId;
+        socket.on("message", async (data) => {
+            const text = typeof data === "string" ? data : data.toString("utf8");
+            let request;
+            try {
+                request = JSON.parse(text);
+            }
+            catch {
+                socket.send(JSON.stringify({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "parse error" } }));
+                return;
+            }
+            const response = await this.router.handle(connectionId, request);
+            if (response && request.id !== undefined)
+                socket.send(JSON.stringify(response));
+        });
+        socket.on("close", () => {
+            const detached = this.connectionManager.close(connectionId);
+            for (const identity of detached) {
+                const agent = this.agentManager.detach(connectionId, identity);
+                if (agent?.activeQuery?.disconnectPolicy === "cancel")
+                    agent.activeQuery.cancel();
+            }
+            this.agentManager.detachConnectionFromAll(connectionId);
+        });
+    }
+    findSocket(connectionId) {
+        for (const client of this.websocketServer.clients) {
+            const socket = client;
+            if (socket.__connectionId === connectionId)
+                return socket;
+        }
+        return undefined;
+    }
+}
+export async function startJsonRpcWebSocketServer(options = {}) {
+    return new JsonRpcWebSocketServer(options);
+}
+function createConnectionId() {
+    return `conn_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+//# sourceMappingURL=ws-server.js.map

package/dist/server/ws-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-server.js","sourceRoot":"","sources":["../../src/server/ws-server.ts"],"names":[],"mappings":"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"}

package/dist/tasks/task-record.d.ts

@@ -0,0 +1,50 @@
+import type { Message } from "../types/messages.js";
+export type LocalTaskStatus = "pending" | "running" | "completed" | "failed" | "killed";
+export type LocalTaskType = "exec";
+export interface TaskProgressSnapshot {
+    totalEvents: number;
+    totalToolUseCount: number;
+    lastActivity?: string;
+    lastText?: string;
+}
+export interface LocalTask {
+    id: string;
+    taskId: string;
+    agentId: string;
+    type: LocalTaskType;
+    status: LocalTaskStatus;
+    description: string;
+    prompt: string;
+    messages: Message[];
+    progress: TaskProgressSnapshot;
+    outputFile: string;
+    result?: TaskResult;
+    error?: string;
+    notified: boolean;
+    retain: boolean;
+    abortController?: AbortController;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+export interface TaskResult {
+    agent_id: string;
+    agent_type: string;
+    content: string;
+    total_duration_ms: number;
+    total_tokens?: number;
+    total_tool_use_count: number;
+    usage?: unknown;
+}
+export declare function createLocalTask(input: {
+    taskId: string;
+    agentId: string;
+    description: string;
+    prompt: string;
+    type?: LocalTaskType;
+    outputFile?: string;
+    abortController?: AbortController;
+    retain?: boolean;
+}): LocalTask;
+export declare function writeLocalTaskOutput(task: LocalTask): void;
+export declare function renderLocalTaskOutput(task: LocalTask): string;

package/dist/tasks/task-record.js

@@ -0,0 +1,50 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { getNeoctlHome } from "../paths.js";
+export function createLocalTask(input) {
+    const now = new Date().toISOString();
+    return {
+        id: input.taskId,
+        taskId: input.taskId,
+        agentId: input.agentId,
+        type: input.type ?? "exec",
+        status: "pending",
+        description: input.description,
+        prompt: input.prompt,
+        messages: [],
+        progress: { totalEvents: 0, totalToolUseCount: 0 },
+        outputFile: input.outputFile ?? defaultTaskOutputFile(input.taskId),
+        notified: false,
+        retain: input.retain ?? true,
+        abortController: input.abortController,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function writeLocalTaskOutput(task) {
+    const content = renderLocalTaskOutput(task);
+    mkdirSync(resolve(task.outputFile, ".."), { recursive: true });
+    writeFileSync(task.outputFile, content, "utf8");
+}
+export function renderLocalTaskOutput(task) {
+    return [
+        `task_id: ${task.taskId}`,
+        `agent_id: ${task.agentId}`,
+        `status: ${task.status}`,
+        `description: ${task.description}`,
+        `created_at: ${task.createdAt}`,
+        `updated_at: ${task.updatedAt}`,
+        task.completedAt ? `completed_at: ${task.completedAt}` : undefined,
+        "",
+        "prompt:",
+        task.prompt,
+        "",
+        "result:",
+        task.result?.content ?? "",
+        task.error ? `\nerror:\n${task.error}` : undefined,
+    ].filter((line) => line !== undefined).join("\n");
+}
+function defaultTaskOutputFile(taskId) {
+    return resolve(getNeoctlHome(), "tasks", `${taskId}.txt`);
+}
+//# sourceMappingURL=task-record.js.map

package/dist/tasks/task-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-record.js","sourceRoot":"","sources":["../../src/tasks/task-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA6C5C,MAAM,UAAU,eAAe,CAAC,KAS/B;IACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,MAAM;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM;QAC1B,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE;QAClD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC;QACnE,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAe;IACnD,OAAO;QACL,YAAY,IAAI,CAAC,MAAM,EAAE;QACzB,aAAa,IAAI,CAAC,OAAO,EAAE;QAC3B,WAAW,IAAI,CAAC,MAAM,EAAE;QACxB,gBAAgB,IAAI,CAAC,WAAW,EAAE;QAClC,eAAe,IAAI,CAAC,SAAS,EAAE;QAC/B,eAAe,IAAI,CAAC,SAAS,EAAE;QAC/B,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;QAClE,EAAE;QACF,SAAS;QACT,IAAI,CAAC,MAAM;QACX,EAAE;QACF,SAAS;QACT,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE;QAC1B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;KACnD,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAc;IAC3C,OAAO,OAAO,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC;AAC5D,CAAC"}

package/dist/tips.js

@@ -44,7 +44,7 @@ export const appTips = [
     {
         id: "image-paste",
         title: "Paste images",
-        placeholder: "Tip: With vision-capable models, paste screenshots and reference them as [img#1]",
+        placeholder: "Tip: With vision-capable models, paste screenshots and use load_image to inspect them later as [img#1]",
         detail: "If the current model supports image input, you can paste images or screenshots from the clipboard and submit them with your prompt.",
     },
     {

package/dist/tips.js.map

@@ -1 +1 @@
-{"version":3,"file":"tips.js","sourceRoot":"","sources":["../src/tips.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tips.js","sourceRoot":"","sources":["../src/tips.ts"],"names":[],"mappings":"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"}