sparkecoder 0.1.114 → 0.1.115

package/dist/db/index.d.ts

@@ -1,5 +1,5 @@
-import { C as Checkpoint, F as FileBackup, M as ModelMessage, a as Message, S as Session, L as LoadedSkill, T as TodoItem, b as ToolExecution, A as ActiveStream, I as IndexStatusRecord, c as IndexedChunk, d as SubagentExecution, e as SubagentStep, f as Terminal } from '../schema-ecQSnCMz.js';
-export { N as NewActiveStream, g as NewCheckpoint, h as NewFileBackup, i as NewIndexStatusRecord, j as NewIndexedChunk, k as NewMessage, l as NewSession, m as NewSubagentExecution, n as NewTerminal, o as NewTodoItem, p as NewToolExecution, q as SessionConfig, r as TaskConfig, U as UserContentPart, s as UserFilePart, t as UserImagePart, u as UserModelMessage, v as UserTextPart } from '../schema-ecQSnCMz.js';
+import { C as Checkpoint, F as FileBackup, M as ModelMessage, a as Message, S as Session, L as LoadedSkill, T as TodoItem, b as ToolExecution, A as ActiveStream, I as IndexStatusRecord, c as IndexedChunk, d as SubagentExecution, e as SubagentStep, f as Terminal } from '../schema-CYSKJZ3m.js';
+export { N as NewActiveStream, g as NewCheckpoint, h as NewFileBackup, i as NewIndexStatusRecord, j as NewIndexedChunk, k as NewMessage, l as NewSession, m as NewSubagentExecution, n as NewTerminal, o as NewTodoItem, p as NewToolExecution, q as SessionConfig, r as TaskConfig, U as UserContentPart, s as UserFilePart, t as UserImagePart, u as UserModelMessage, v as UserTextPart } from '../schema-CYSKJZ3m.js';
 import 'drizzle-orm/sqlite-core';
 
 /**

package/dist/{index-Bi8Ek02A.d.ts → index-Biy5JTop.d.ts}

@@ -1,7 +1,7 @@
 import { ModelMessage, streamText } from 'ai';
-import { S as Session, b as ToolExecution, r as TaskConfig } from './schema-ecQSnCMz.js';
+import { S as Session, b as ToolExecution, r as TaskConfig } from './schema-CYSKJZ3m.js';
 import { z } from 'zod';
-import { B as BashToolProgress, W as WriteFileProgress, S as SearchToolProgress } from './search-DOzC4ojH.js';
+import { B as BashToolProgress, W as WriteFileProgress, S as SearchToolProgress } from './search-CVVfuBPZ.js';
 
 declare const ToolApprovalConfigSchema: z.ZodObject<{
     bash: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -38,25 +38,25 @@ declare const SessionConfigSchema: z.ZodObject<{
         iterations: z.ZodOptional<z.ZodNumber>;
         parentTaskId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "completed" | "failed" | "running";
+        status: "running" | "completed" | "failed";
         enabled: boolean;
         outputSchema: Record<string, unknown>;
-        error?: string | undefined;
-        maxIterations?: number | undefined;
         webhookUrl?: string | undefined;
-        parentTaskId?: string | undefined;
+        maxIterations?: number | undefined;
         result?: unknown;
+        error?: string | undefined;
         iterations?: number | undefined;
+        parentTaskId?: string | undefined;
     }, {
-        status: "completed" | "failed" | "running";
+        status: "running" | "completed" | "failed";
         enabled: boolean;
         outputSchema: Record<string, unknown>;
-        error?: string | undefined;
-        maxIterations?: number | undefined;
         webhookUrl?: string | undefined;
-        parentTaskId?: string | undefined;
+        maxIterations?: number | undefined;
         result?: unknown;
+        error?: string | undefined;
         iterations?: number | undefined;
+        parentTaskId?: string | undefined;
     }>>;
     computerUseEnabled: z.ZodOptional<z.ZodBoolean>;
     computerUseDisplayWidth: z.ZodOptional<z.ZodNumber>;
@@ -87,20 +87,20 @@ declare const SessionConfigSchema: z.ZodObject<{
         lastFiredAt: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
         id: string;
         name: string;
-        enabled: boolean;
-        createdAt: string;
-        prompt: string;
         cron: string;
+        prompt: string;
+        createdAt: string;
         replyChannel?: string | undefined;
         lastFiredAt?: string | undefined;
     }, {
         id: string;
         name: string;
-        createdAt: string;
-        prompt: string;
         cron: string;
+        prompt: string;
+        createdAt: string;
         enabled?: boolean | undefined;
         replyChannel?: string | undefined;
         lastFiredAt?: string | undefined;
@@ -115,19 +115,19 @@ declare const SessionConfigSchema: z.ZodObject<{
         lastHitAt: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        token: string;
         id: string;
         name: string;
         createdAt: string;
+        token: string;
         wake: "now" | "next";
         hitCount: number;
         template?: string | undefined;
         lastHitAt?: string | undefined;
     }, {
-        token: string;
         id: string;
         name: string;
         createdAt: string;
+        token: string;
         wake?: "now" | "next" | undefined;
         template?: string | undefined;
         hitCount?: number | undefined;
@@ -137,96 +137,96 @@ declare const SessionConfigSchema: z.ZodObject<{
     maxContextChars: number;
     toolApprovals?: Record<string, boolean> | undefined;
     approvalWebhook?: string | undefined;
-    webhooks?: {
-        token: string;
-        id: string;
-        name: string;
-        createdAt: string;
-        wake: "now" | "next";
-        hitCount: number;
-        template?: string | undefined;
-        lastHitAt?: string | undefined;
-    }[] | undefined;
-    slack?: {
-        channel?: string | undefined;
-        threadTs?: string | undefined;
-        teamId?: string | undefined;
-    } | undefined;
+    skillsDirectory?: string | undefined;
     task?: {
-        status: "completed" | "failed" | "running";
+        status: "running" | "completed" | "failed";
         enabled: boolean;
         outputSchema: Record<string, unknown>;
-        error?: string | undefined;
-        maxIterations?: number | undefined;
         webhookUrl?: string | undefined;
-        parentTaskId?: string | undefined;
+        maxIterations?: number | undefined;
         result?: unknown;
+        error?: string | undefined;
         iterations?: number | undefined;
+        parentTaskId?: string | undefined;
     } | undefined;
-    skillsDirectory?: string | undefined;
     computerUseEnabled?: boolean | undefined;
     computerUseDisplayWidth?: number | undefined;
     computerUseDisplayHeight?: number | undefined;
     role?: "orchestrator" | "worker" | "chat" | undefined;
     personality?: string | undefined;
     orchestratorSessionId?: string | undefined;
+    slack?: {
+        channel?: string | undefined;
+        threadTs?: string | undefined;
+        teamId?: string | undefined;
+    } | undefined;
     schedules?: {
+        enabled: boolean;
         id: string;
         name: string;
-        enabled: boolean;
-        createdAt: string;
-        prompt: string;
         cron: string;
+        prompt: string;
+        createdAt: string;
         replyChannel?: string | undefined;
         lastFiredAt?: string | undefined;
     }[] | undefined;
-}, {
-    toolApprovals?: Record<string, boolean> | undefined;
-    approvalWebhook?: string | undefined;
     webhooks?: {
-        token: string;
         id: string;
         name: string;
         createdAt: string;
-        wake?: "now" | "next" | undefined;
+        token: string;
+        wake: "now" | "next";
+        hitCount: number;
         template?: string | undefined;
-        hitCount?: number | undefined;
         lastHitAt?: string | undefined;
     }[] | undefined;
-    slack?: {
-        channel?: string | undefined;
-        threadTs?: string | undefined;
-        teamId?: string | undefined;
-    } | undefined;
+}, {
+    toolApprovals?: Record<string, boolean> | undefined;
+    approvalWebhook?: string | undefined;
+    skillsDirectory?: string | undefined;
+    maxContextChars?: number | undefined;
     task?: {
-        status: "completed" | "failed" | "running";
+        status: "running" | "completed" | "failed";
         enabled: boolean;
         outputSchema: Record<string, unknown>;
-        error?: string | undefined;
-        maxIterations?: number | undefined;
         webhookUrl?: string | undefined;
-        parentTaskId?: string | undefined;
+        maxIterations?: number | undefined;
         result?: unknown;
+        error?: string | undefined;
         iterations?: number | undefined;
+        parentTaskId?: string | undefined;
     } | undefined;
-    skillsDirectory?: string | undefined;
-    maxContextChars?: number | undefined;
     computerUseEnabled?: boolean | undefined;
     computerUseDisplayWidth?: number | undefined;
     computerUseDisplayHeight?: number | undefined;
     role?: "orchestrator" | "worker" | "chat" | undefined;
     personality?: string | undefined;
     orchestratorSessionId?: string | undefined;
+    slack?: {
+        channel?: string | undefined;
+        threadTs?: string | undefined;
+        teamId?: string | undefined;
+    } | undefined;
     schedules?: {
         id: string;
         name: string;
-        createdAt: string;
-        prompt: string;
         cron: string;
+        prompt: string;
+        createdAt: string;
         enabled?: boolean | undefined;
         replyChannel?: string | undefined;
         lastFiredAt?: string | undefined;
     }[] | undefined;
+    webhooks?: {
+        id: string;
+        name: string;
+        createdAt: string;
+        token: string;
+        wake?: "now" | "next" | undefined;
+        template?: string | undefined;
+        hitCount?: number | undefined;
+        lastHitAt?: string | undefined;
+    }[] | undefined;
 }>;
 declare const SparkcoderConfigSchema: z.ZodObject<{
     defaultModel: z.ZodDefault<z.ZodString>;
@@ -392,15 +392,15 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
                 expiresAt?: string | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
             id: string;
             name: string;
-            transport: "http" | "sse" | "stdio";
-            enabled: boolean;
             createdAt: string;
+            transport: "http" | "sse" | "stdio";
+            args?: string[] | undefined;
             url?: string | undefined;
             headers?: Record<string, string> | undefined;
             command?: string | undefined;
-            args?: string[] | undefined;
             oauth?: {
                 authorizationUrl?: string | undefined;
                 tokenUrl?: string | undefined;
@@ -413,13 +413,13 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         }, {
             id: string;
             name: string;
-            transport: "http" | "sse" | "stdio";
             createdAt: string;
+            transport: "http" | "sse" | "stdio";
+            enabled?: boolean | undefined;
+            args?: string[] | undefined;
             url?: string | undefined;
             headers?: Record<string, string> | undefined;
             command?: string | undefined;
-            args?: string[] | undefined;
-            enabled?: boolean | undefined;
             oauth?: {
                 authorizationUrl?: string | undefined;
                 tokenUrl?: string | undefined;
@@ -432,15 +432,15 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         }>, "many">>>>;
     }, "strip", z.ZodTypeAny, {
         servers?: {
+            enabled: boolean;
             id: string;
             name: string;
-            transport: "http" | "sse" | "stdio";
-            enabled: boolean;
             createdAt: string;
+            transport: "http" | "sse" | "stdio";
+            args?: string[] | undefined;
             url?: string | undefined;
             headers?: Record<string, string> | undefined;
             command?: string | undefined;
-            args?: string[] | undefined;
             oauth?: {
                 authorizationUrl?: string | undefined;
                 tokenUrl?: string | undefined;
@@ -455,13 +455,13 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         servers?: {
             id: string;
             name: string;
-            transport: "http" | "sse" | "stdio";
             createdAt: string;
+            transport: "http" | "sse" | "stdio";
+            enabled?: boolean | undefined;
+            args?: string[] | undefined;
             url?: string | undefined;
             headers?: Record<string, string> | undefined;
             command?: string | undefined;
-            args?: string[] | undefined;
-            enabled?: boolean | undefined;
             oauth?: {
                 authorizationUrl?: string | undefined;
                 tokenUrl?: string | undefined;
@@ -504,7 +504,6 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         allowedEmails?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    defaultModel: string;
     toolApprovals: {
         bash: boolean;
         write_file: boolean;
@@ -512,6 +511,7 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         load_skill: boolean;
         todo: boolean;
     };
+    defaultModel: string;
     skills: {
         directory: string;
         additionalDirectories: string[];
@@ -527,11 +527,21 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         publicUrl?: string | undefined;
     };
     databasePath: string;
-    workingDirectory?: string | undefined;
     approvalWebhook?: string | undefined;
+    slack?: {
+        botToken?: string | undefined;
+        signingSecret?: string | undefined;
+        defaultOrchestratorName?: string | undefined;
+        allowedUsers?: string[] | undefined;
+        allowedChannels?: string[] | undefined;
+        allowDmsFromAnyone?: boolean | undefined;
+        deniedReplyEnabled?: boolean | undefined;
+        deniedReplyTemplate?: string | undefined;
+    } | undefined;
     webhooks?: {
         token?: string | undefined;
     } | undefined;
+    workingDirectory?: string | undefined;
     remoteServer?: {
         url?: string | undefined;
         authKey?: string | undefined;
@@ -544,27 +554,17 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         httpUrl?: string | undefined;
         namespace?: string | undefined;
     } | undefined;
-    slack?: {
-        botToken?: string | undefined;
-        signingSecret?: string | undefined;
-        defaultOrchestratorName?: string | undefined;
-        allowedUsers?: string[] | undefined;
-        allowedChannels?: string[] | undefined;
-        allowDmsFromAnyone?: boolean | undefined;
-        deniedReplyEnabled?: boolean | undefined;
-        deniedReplyTemplate?: string | undefined;
-    } | undefined;
     mcp?: {
         servers?: {
+            enabled: boolean;
             id: string;
             name: string;
-            transport: "http" | "sse" | "stdio";
-            enabled: boolean;
             createdAt: string;
+            transport: "http" | "sse" | "stdio";
+            args?: string[] | undefined;
             url?: string | undefined;
             headers?: Record<string, string> | undefined;
             command?: string | undefined;
-            args?: string[] | undefined;
             oauth?: {
                 authorizationUrl?: string | undefined;
                 tokenUrl?: string | undefined;
@@ -585,8 +585,6 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         allowedEmails?: string[] | undefined;
     } | undefined;
 }, {
-    defaultModel?: string | undefined;
-    workingDirectory?: string | undefined;
     toolApprovals?: {
         bash?: boolean | undefined;
         write_file?: boolean | undefined;
@@ -595,6 +593,21 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         todo?: boolean | undefined;
     } | undefined;
     approvalWebhook?: string | undefined;
+    slack?: {
+        botToken?: string | undefined;
+        signingSecret?: string | undefined;
+        defaultOrchestratorName?: string | undefined;
+        allowedUsers?: string[] | undefined;
+        allowedChannels?: string[] | undefined;
+        allowDmsFromAnyone?: boolean | undefined;
+        deniedReplyEnabled?: boolean | undefined;
+        deniedReplyTemplate?: string | undefined;
+    } | undefined;
+    webhooks?: {
+        token?: string | undefined;
+    } | undefined;
+    workingDirectory?: string | undefined;
+    defaultModel?: string | undefined;
     skills?: {
         directory?: string | undefined;
         additionalDirectories?: string[] | undefined;
@@ -609,9 +622,6 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         host?: string | undefined;
         publicUrl?: string | undefined;
     } | undefined;
-    webhooks?: {
-        token?: string | undefined;
-    } | undefined;
     databasePath?: string | undefined;
     remoteServer?: {
         url?: string | undefined;
@@ -625,27 +635,17 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         include?: string[] | undefined;
         exclude?: string[] | undefined;
     } | undefined;
-    slack?: {
-        botToken?: string | undefined;
-        signingSecret?: string | undefined;
-        defaultOrchestratorName?: string | undefined;
-        allowedUsers?: string[] | undefined;
-        allowedChannels?: string[] | undefined;
-        allowDmsFromAnyone?: boolean | undefined;
-        deniedReplyEnabled?: boolean | undefined;
-        deniedReplyTemplate?: string | undefined;
-    } | undefined;
     mcp?: {
         servers?: {
             id: string;
             name: string;
-            transport: "http" | "sse" | "stdio";
             createdAt: string;
+            transport: "http" | "sse" | "stdio";
+            enabled?: boolean | undefined;
+            args?: string[] | undefined;
             url?: string | undefined;
             headers?: Record<string, string> | undefined;
             command?: string | undefined;
-            args?: string[] | undefined;
-            enabled?: boolean | undefined;
             oauth?: {
                 authorizationUrl?: string | undefined;
                 tokenUrl?: string | undefined;

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { R as ResolvedConfig } from './index-Bi8Ek02A.js';
-export { A as Agent, a as AgentOptions, b as AgentRunOptions, c as AgentStreamResult, S as SparkcoderConfig, T as ToolApprovalConfig } from './index-Bi8Ek02A.js';
+import { R as ResolvedConfig } from './index-Biy5JTop.js';
+export { A as Agent, a as AgentOptions, b as AgentRunOptions, c as AgentStreamResult, S as SparkcoderConfig, T as ToolApprovalConfig } from './index-Biy5JTop.js';
 export { ServerOptions, createApp, startServer, stopServer } from './server/index.js';
 export { checkpointQueries, closeDatabase, fileBackupQueries, getDb, initDatabase, messageQueries, sessionQueries, skillQueries, todoQueries, toolExecutionQueries } from './db/index.js';
-import { F as FileBackup, C as Checkpoint } from './schema-ecQSnCMz.js';
-export { a as Message, M as ModelMessage, S as Session, q as SessionConfig, f as Terminal, T as TodoItem, b as ToolExecution } from './schema-ecQSnCMz.js';
+import { F as FileBackup, C as Checkpoint } from './schema-CYSKJZ3m.js';
+export { a as Message, M as ModelMessage, S as Session, q as SessionConfig, f as Terminal, T as TodoItem, b as ToolExecution } from './schema-CYSKJZ3m.js';
 export { createLoadSkillTool, createReadFileTool, createTodoTool, createTools } from './tools/index.js';
-export { c as createBashTool, a as createWriteFileTool } from './search-DOzC4ojH.js';
+export { c as createBashTool, a as createWriteFileTool } from './search-CVVfuBPZ.js';
 import 'ai';
 import 'zod';
 import 'hono/types';

package/dist/{schema-ecQSnCMz.d.ts → schema-CYSKJZ3m.d.ts}

@@ -85,7 +85,7 @@ declare const sessions: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
             tableName: "sessions";
             dataType: "string";
             columnType: "SQLiteText";
-            data: "error" | "completed" | "active" | "waiting";
+            data: "completed" | "error" | "active" | "waiting";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -391,7 +391,7 @@ declare const toolExecutions: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
             tableName: "tool_executions";
             dataType: "string";
             columnType: "SQLiteText";
-            data: "error" | "completed" | "pending" | "approved" | "rejected";
+            data: "completed" | "error" | "pending" | "approved" | "rejected";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -814,7 +814,7 @@ declare const terminals: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
             tableName: "terminals";
             dataType: "string";
             columnType: "SQLiteText";
-            data: "error" | "running" | "stopped";
+            data: "running" | "error" | "stopped";
             driverParam: string;
             notNull: true;
             hasDefault: true;

package/dist/{search-DOzC4ojH.d.ts → search-CVVfuBPZ.d.ts}

@@ -16,11 +16,11 @@ interface BashToolOptions {
 declare function createBashTool(options: BashToolOptions): ai.Tool<{
     background: boolean;
     id?: string | undefined;
-    command?: string | undefined;
     input?: string | undefined;
+    command?: string | undefined;
     kill?: boolean | undefined;
     tail?: number | undefined;
-    key?: "y" | "Enter" | "Escape" | "Up" | "Down" | "Left" | "Right" | "Tab" | "C-c" | "C-d" | "n" | undefined;
+    key?: "Enter" | "Escape" | "Up" | "Down" | "Left" | "Right" | "Tab" | "C-c" | "C-d" | "y" | "n" | undefined;
 }, {
     success: boolean;
     id: string;
@@ -66,7 +66,7 @@ declare function createBashTool(options: BashToolOptions): ai.Tool<{
     id: string;
     output: string;
     exitCode: number;
-    status: "error" | "completed" | "running" | "stopped";
+    status: "running" | "completed" | "error" | "stopped";
     message?: undefined;
     error?: undefined;
 } | {
@@ -218,8 +218,8 @@ interface SearchToolOptions {
  * Progress is streamed back to the UI so users can see exploration happening.
  */
 declare function createSearchTool(options: SearchToolOptions): ai.Tool<{
-    context: string;
     query: string;
+    context: string;
 }, {
     success: boolean;
     error: string;

package/dist/skills/default/computer-use.md

@@ -154,23 +154,30 @@ Coordinates are in the **logical points** of the primary display — same coordi
 
 ## Record what you're doing (default ON)
 
-Computer-use sessions are *visual* — the user can't see the screen you're driving, only your text summary. **Record almost every computer-use task** so the user can replay it. See the **Recording** skill for the details (`load_skill recording`); the short version:
+Computer-use sessions are *visual* — the user can't see the screen you're driving, only your text summary. **Record almost every computer-use task** so the user can replay it. Use the built-in `sparkecoder record` helper which manages start/stop properly so the recording covers the **entire task**, not just a fixed-time window:
 
 ```bash
-# At the start of the task, before your first `computer` action:
-mkdir -p ~/recordings
-RECORDING=~/recordings/cu-$(date +%s).mov
-screencapture -v -V 180 -C "$RECORDING" &
-REC_PID=$!
-
-# ... do all your computer-use actions ...
-
-# When you're done (success OR failure), stop the recording:
-kill -INT $REC_PID 2>/dev/null
-wait $REC_PID 2>/dev/null
-echo "Recording: $RECORDING"
+# 1. At the START of the task, BEFORE your first `computer` action:
+REC=$(sparkecoder record start --name "calculator-demo")
+# REC is JSON: {"id":"rec-abc123","path":"~/recordings/rec-abc123-calculator-demo.mov","pid":12345}
+REC_ID=$(echo "$REC" | jq -r .id)
+REC_PATH=$(echo "$REC" | jq -r .path)
+echo "Recording started: $REC_PATH (id=$REC_ID)"
+
+# 2. ... do all your computer-use actions (open apps, click, type, etc.) ...
+
+# 3. At the END (success OR failure), stop the recording:
+sparkecoder record stop "$REC_ID"
+# → JSON: {"id":"...","path":"...","durationSec":42,"sizeMb":18.4,"ok":true}
 ```
 
+Why use `sparkecoder record` instead of `screencapture -V 60` directly:
+
+- `-V <seconds>` is a fixed timeout — if your task takes longer than the guess, the recording ends mid-task and you get a partial. The helper has no timeout; it records until you explicitly stop it.
+- The helper tracks PIDs in state so `sparkecoder record stop-all` can clean up if something crashes.
+- Works on both macOS (screencapture) and Linux (ffmpeg x11grab) with the same command.
+- Returns the file path as JSON, so you can include it in your final result without guessing.
+
 Default behavior:
 
 - **Always record** short / visually interesting tasks (open an app, click around, drag/drop, fill a form, demos, "show me X working").