sparkecoder 0.1.116 → 0.1.117

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-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 { 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 'drizzle-orm/sqlite-core';
 
 /**

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

@@ -1,7 +1,7 @@
 import { ModelMessage, streamText } from 'ai';
-import { S as Session, b as ToolExecution, r as TaskConfig } from './schema-CYSKJZ3m.js';
+import { S as Session, b as ToolExecution, r as TaskConfig } from './schema-ecQSnCMz.js';
 import { z } from 'zod';
-import { B as BashToolProgress, W as WriteFileProgress, S as SearchToolProgress } from './search-CVVfuBPZ.js';
+import { B as BashToolProgress, W as WriteFileProgress, S as SearchToolProgress } from './search-DOzC4ojH.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: "running" | "completed" | "failed";
+        status: "completed" | "failed" | "running";
         enabled: boolean;
         outputSchema: Record<string, unknown>;
-        webhookUrl?: string | undefined;
+        error?: string | undefined;
         maxIterations?: number | undefined;
+        webhookUrl?: string | undefined;
+        parentTaskId?: string | undefined;
         result?: unknown;
-        error?: string | undefined;
         iterations?: number | undefined;
-        parentTaskId?: string | undefined;
     }, {
-        status: "running" | "completed" | "failed";
+        status: "completed" | "failed" | "running";
         enabled: boolean;
         outputSchema: Record<string, unknown>;
-        webhookUrl?: string | undefined;
+        error?: string | undefined;
         maxIterations?: number | undefined;
+        webhookUrl?: string | undefined;
+        parentTaskId?: string | 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;
-        cron: string;
-        prompt: string;
+        enabled: boolean;
         createdAt: string;
+        prompt: string;
+        cron: string;
         replyChannel?: string | undefined;
         lastFiredAt?: string | undefined;
     }, {
         id: string;
         name: string;
-        cron: string;
-        prompt: string;
         createdAt: string;
+        prompt: string;
+        cron: 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;
-    skillsDirectory?: 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;
     task?: {
-        status: "running" | "completed" | "failed";
+        status: "completed" | "failed" | "running";
         enabled: boolean;
         outputSchema: Record<string, unknown>;
-        webhookUrl?: string | undefined;
+        error?: string | undefined;
         maxIterations?: number | undefined;
+        webhookUrl?: string | undefined;
+        parentTaskId?: string | 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;
-        cron: string;
-        prompt: string;
+        enabled: boolean;
         createdAt: string;
+        prompt: string;
+        cron: 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;
-        token: string;
-        wake: "now" | "next";
-        hitCount: number;
+        wake?: "now" | "next" | undefined;
         template?: string | undefined;
+        hitCount?: number | undefined;
         lastHitAt?: string | undefined;
     }[] | undefined;
-}, {
-    toolApprovals?: Record<string, boolean> | undefined;
-    approvalWebhook?: string | undefined;
-    skillsDirectory?: string | undefined;
-    maxContextChars?: number | undefined;
+    slack?: {
+        channel?: string | undefined;
+        threadTs?: string | undefined;
+        teamId?: string | undefined;
+    } | undefined;
     task?: {
-        status: "running" | "completed" | "failed";
+        status: "completed" | "failed" | "running";
         enabled: boolean;
         outputSchema: Record<string, unknown>;
-        webhookUrl?: string | undefined;
+        error?: string | undefined;
         maxIterations?: number | undefined;
+        webhookUrl?: string | undefined;
+        parentTaskId?: string | 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;
-        cron: string;
-        prompt: string;
         createdAt: string;
+        prompt: string;
+        cron: 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;
-            createdAt: string;
             transport: "http" | "sse" | "stdio";
-            args?: string[] | undefined;
+            enabled: boolean;
+            createdAt: string;
             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;
-            createdAt: string;
             transport: "http" | "sse" | "stdio";
-            enabled?: boolean | undefined;
-            args?: string[] | undefined;
+            createdAt: string;
             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;
-            createdAt: string;
             transport: "http" | "sse" | "stdio";
-            args?: string[] | undefined;
+            enabled: boolean;
+            createdAt: string;
             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;
-            createdAt: string;
             transport: "http" | "sse" | "stdio";
-            enabled?: boolean | undefined;
-            args?: string[] | undefined;
+            createdAt: string;
             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,6 +504,7 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         allowedEmails?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    defaultModel: string;
     toolApprovals: {
         bash: boolean;
         write_file: boolean;
@@ -511,7 +512,6 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         load_skill: boolean;
         todo: boolean;
     };
-    defaultModel: string;
     skills: {
         directory: string;
         additionalDirectories: string[];
@@ -527,21 +527,11 @@ 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;
@@ -554,17 +544,27 @@ 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;
-            createdAt: string;
             transport: "http" | "sse" | "stdio";
-            args?: string[] | undefined;
+            enabled: boolean;
+            createdAt: string;
             url?: string | undefined;
             headers?: Record<string, string> | undefined;
             command?: string | undefined;
+            args?: string[] | undefined;
             oauth?: {
                 authorizationUrl?: string | undefined;
                 tokenUrl?: string | undefined;
@@ -585,6 +585,8 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         allowedEmails?: string[] | undefined;
     } | undefined;
 }, {
+    defaultModel?: string | undefined;
+    workingDirectory?: string | undefined;
     toolApprovals?: {
         bash?: boolean | undefined;
         write_file?: boolean | undefined;
@@ -593,21 +595,6 @@ 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;
@@ -622,6 +609,9 @@ declare const SparkcoderConfigSchema: z.ZodObject<{
         host?: string | undefined;
         publicUrl?: string | undefined;
     } | undefined;
+    webhooks?: {
+        token?: string | undefined;
+    } | undefined;
     databasePath?: string | undefined;
     remoteServer?: {
         url?: string | undefined;
@@ -635,17 +625,27 @@ 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;
-            createdAt: string;
             transport: "http" | "sse" | "stdio";
-            enabled?: boolean | undefined;
-            args?: string[] | undefined;
+            createdAt: string;
             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-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';
+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';
 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-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';
+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';
 export { createLoadSkillTool, createReadFileTool, createTodoTool, createTools } from './tools/index.js';
-export { c as createBashTool, a as createWriteFileTool } from './search-CVVfuBPZ.js';
+export { c as createBashTool, a as createWriteFileTool } from './search-DOzC4ojH.js';
 import 'ai';
 import 'zod';
 import 'hono/types';

package/dist/index.js

@@ -7672,6 +7672,26 @@ When you spawn a **desktop worker**, include a one-liner in the goal asking it t
 
 Default bias: **when in doubt, decompose**. Two workers running in parallel and reporting independently is almost always better UX than one worker doing things sequentially.
 
+### How to TALK to the user (versus how you reason internally)
+
+All of the rules below \u2014 decomposition, parallel spawning, "don't invent commands", load-the-skill, etc. \u2014 are **your internal operating procedure**. They are how you decide what to do. They are NOT something to recite back to the user.
+
+When replying to the user (Slack, web, or any channel), be a normal helpful assistant:
+
+- Tell them *what you're doing*, not *how you're doing it internally*.
+- Don't quote your own prompt language ("just the goal", "read the skill", "no step-by-step from me", "decomposing into parallel workers"). The user doesn't care about your delegation pattern.
+- Don't narrate "handing off to a worker now" unless it's actually relevant (e.g. they asked how you work, or the work is going to take a noticeably long time).
+- Skip ceremony. A short acknowledgement + a brief description of the actual task + (optionally) a heads-up if there's anything they need to do or avoid is plenty.
+
+| What you might be tempted to say | What you should say instead |
+|---|---|
+| *"Got it \u2014 handing it off with just the goal + 'read the skills and figure it out.' No step-by-step from me."* | *"On it. Recording a screen capture of the Weather app showing Anchorage. Don't touch the keyboard while it's running \u2014 I'll post the video when it's done."* |
+| *"Decomposing into two parallel workers: one headless, one desktop."* | *"Running the tests and pulling the diff at the same time. Back in ~30s."* |
+| *"Spawning worker \`screenshot-calc\` with goal: \u2026"* | *"Taking a screenshot of Calculator now."* |
+| *"I'll relay the user's instructions to the worker verbatim."* | *(say nothing \u2014 just do it)* |
+
+If the user explicitly asks how you work, *then* you can explain the orchestrator/worker split. Otherwise: less is more.
+
 ### How to write a worker goal (and what NOT to put in it)
 
 You delegate; the worker executes. Stay at the **what** level, not the **how**.