surfcode 0.0.0-stage → 0.1.0

package/dist/core/delegate.js

@@ -0,0 +1,184 @@
+import { streamChat } from './chat/index.js';
+import { costForUsage } from './usage.js';
+const MAX_TASKS = 8;
+const MAX_WORKER_OUTPUT = 6_000;
+const MAX_CONTEXT_CHARS = 16_000;
+export function createDelegateTool(options) {
+    const labels = options.delegates.map((delegate) => `${delegate.provider.id}/${delegate.model.id}`);
+    return {
+        name: 'delegate',
+        description: 'Run independent subtasks in parallel on the configured worker models, then return their answers to you. ' +
+            'Workers have no tools and cannot edit files. Use this for reviews, research, debugging hypotheses, or comparing approaches. ' +
+            `Available workers: ${labels.join(', ')}.`,
+        readOnly: true,
+        action: 'read',
+        parameters: {
+            type: 'object',
+            properties: {
+                tasks: {
+                    type: 'array',
+                    description: `1-${MAX_TASKS} independent tasks. All start at the same time.`,
+                    items: {
+                        type: 'object',
+                        properties: {
+                            worker: {
+                                type: 'string',
+                                description: `Optional worker id (${labels.join(', ')}). Omit to assign automatically.`
+                            },
+                            task: {
+                                type: 'string',
+                                description: 'A self-contained instruction for one worker model.'
+                            }
+                        },
+                        required: ['task']
+                    }
+                }
+            },
+            required: ['tasks']
+        },
+        async execute(args) {
+            const started = Date.now();
+            const rawTasks = Array.isArray(args.tasks) ? args.tasks : [];
+            const tasks = [];
+            for (const [index, entry] of rawTasks.slice(0, MAX_TASKS).entries()) {
+                if (!entry || typeof entry !== 'object')
+                    continue;
+                const record = entry;
+                const task = String(record.task ?? '').trim();
+                if (!task)
+                    continue;
+                const requested = typeof record.worker === 'string' ? record.worker.trim() : '';
+                const delegate = requested
+                    ? matchWorker(options.delegates, requested)
+                    : options.delegates[index % options.delegates.length];
+                if (!delegate) {
+                    tasks.push({
+                        delegate: options.delegates[index % options.delegates.length],
+                        task: `[worker "${requested}" was not found; answer this anyway]\n${task}`
+                    });
+                    continue;
+                }
+                tasks.push({ delegate, task });
+            }
+            if (tasks.length === 0) {
+                return {
+                    output: 'No delegation tasks were provided.',
+                    isError: true,
+                    display: { summary: 'no tasks' }
+                };
+            }
+            const context = compactHistory(options.getHistory());
+            const results = await Promise.allSettled(tasks.map(({ delegate, task }) => runWorker(options, delegate, task, context)));
+            const blocks = [];
+            let succeeded = 0;
+            let failed = 0;
+            for (const [index, result] of results.entries()) {
+                const { delegate, task } = tasks[index];
+                const label = `${delegate.provider.id}/${delegate.model.id}`;
+                if (result.status === 'fulfilled') {
+                    succeeded += 1;
+                    const text = result.value.text.trim() || '(the worker returned no text)';
+                    blocks.push(`### ${label}\n${clip(text, MAX_WORKER_OUTPUT)}`);
+                }
+                else {
+                    failed += 1;
+                    const reason = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                    blocks.push(`### ${label}\n_Worker failed: ${clip(reason, 800)}_\n\nTask: ${clip(task, 500)}`);
+                }
+            }
+            const seconds = ((Date.now() - started) / 1000).toFixed(1);
+            return {
+                output: blocks.join('\n\n'),
+                title: 'delegate',
+                isError: succeeded === 0,
+                display: {
+                    kind: 'text',
+                    summary: `${succeeded} worker${succeeded === 1 ? '' : 's'}${failed ? ` · ${failed} failed` : ''} · ${seconds}s`,
+                    lines: succeeded
+                }
+            };
+        }
+    };
+}
+async function runWorker(options, delegate, task, context) {
+    const system = `You are a worker model inside SurfCode's multi-model /agent mode.
+The head model is coordinating several workers in parallel. Answer only the task you were given.
+You have NO tools: do not read files, run commands, or claim that you did.
+Use the conversation context below, be specific, and return GitHub-flavored Markdown.
+Keep the answer focused and under 500 words unless the task genuinely needs more.
+
+Workspace: ${options.cwd}
+Worker: ${delegate.provider.name} / ${delegate.model.name}`;
+    const messages = [
+        ...(context ? [{ role: 'user', content: `Conversation context:\n\n${context}` }] : []),
+        { role: 'user', content: task }
+    ];
+    const result = await streamChat({
+        provider: delegate.provider,
+        model: delegate.model,
+        messages,
+        system,
+        tools: [],
+        options: {
+            signal: options.signal,
+            maxTokens: Math.min(options.maxTokens, 8_192),
+            temperature: options.temperature,
+            effort: options.effort,
+            showReasoning: false,
+            timeout: delegate.provider.settings.timeout
+        },
+        callbacks: {
+            onText() { },
+            onReasoning() { }
+        }
+    });
+    const usage = {
+        inputTokens: result.usage.inputTokens ?? 0,
+        outputTokens: result.usage.outputTokens ?? 0,
+        reasoningTokens: result.usage.reasoningTokens ?? 0,
+        cacheReadTokens: result.usage.cacheReadTokens ?? 0,
+        cacheWriteTokens: result.usage.cacheWriteTokens ?? 0,
+        cost: costForUsage(delegate.model.meta, result.usage, delegate.provider.dialect),
+        requests: 1
+    };
+    options.onUsage?.(usage);
+    return { text: result.text, usage };
+}
+function matchWorker(delegates, reference) {
+    const wanted = reference.toLowerCase();
+    return delegates.find((delegate) => {
+        const id = `${delegate.provider.id}/${delegate.model.id}`.toLowerCase();
+        return (id === wanted ||
+            delegate.model.id.toLowerCase() === wanted ||
+            delegate.provider.id.toLowerCase() === wanted ||
+            delegate.model.name.toLowerCase() === wanted);
+    });
+}
+function compactHistory(messages) {
+    const blocks = [];
+    let total = 0;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (message.role === 'user') {
+            blocks.push(`User: ${clip(message.content, 2_000)}`);
+        }
+        else if (message.role === 'assistant') {
+            if (message.content)
+                blocks.push(`Assistant: ${clip(message.content, 2_000)}`);
+            for (const call of message.toolCalls ?? []) {
+                blocks.push(`Assistant called ${call.name}(${clip(JSON.stringify(call.arguments), 600)})`);
+            }
+        }
+        else {
+            blocks.push(`Tool ${message.name}${message.isError ? ' (error)' : ''}: ${clip(message.content, 1_200)}`);
+        }
+        total += blocks.at(-1).length;
+        if (total >= MAX_CONTEXT_CHARS)
+            break;
+    }
+    return blocks.reverse().join('\n\n').slice(-MAX_CONTEXT_CHARS);
+}
+function clip(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max)}…`;
+}
+//# sourceMappingURL=delegate.js.map

package/dist/core/delegate.js.map

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

package/dist/core/effort.js

@@ -0,0 +1,80 @@
+export const EFFORT_LEVELS = ['low', 'medium', 'high'];
+export const EFFORT_SETTINGS = ['auto', ...EFFORT_LEVELS];
+const ANTHROPIC_BUDGETS = {
+    low: 2_048,
+    medium: 8_192,
+    high: 16_384
+};
+const GOOGLE_BUDGETS = {
+    low: 1_024,
+    medium: 8_192,
+    high: 24_576
+};
+export const EFFORT_GUIDANCE = {
+    low: 'Answer directly. Spend little time deliberating and keep tool use to the minimum needed.',
+    medium: 'Balance speed and depth. Reason through the problem, then act.',
+    high: 'Think carefully. Explore alternatives, verify assumptions, and check your work before answering.'
+};
+export function parseEffort(value) {
+    const normalized = value.trim().toLowerCase();
+    return EFFORT_SETTINGS.includes(normalized)
+        ? normalized
+        : undefined;
+}
+export function activeEffort(value) {
+    return value && value !== 'auto' ? value : undefined;
+}
+export function effortLabel(value) {
+    return !value || value === 'auto' ? 'auto (provider default)' : value;
+}
+/**
+ * Extended-thinking budget for Anthropic. The API requires room for both the
+ * thinking block and the final answer, so leave at least 1k tokens for text.
+ */
+export function anthropicThinkingBudget(effort, maxTokens) {
+    const available = maxTokens - 1_024;
+    if (available < 1_024)
+        return undefined;
+    return Math.min(ANTHROPIC_BUDGETS[effort], available);
+}
+/**
+ * Gemini counts thinking tokens inside maxOutputTokens. Keep a small reserve
+ * so a small output limit cannot make the request invalid.
+ */
+export function googleThinkingBudget(effort, maxTokens) {
+    const available = maxTokens - 512;
+    if (available < 1)
+        return undefined;
+    return Math.min(GOOGLE_BUDGETS[effort], available);
+}
+/**
+ * Gemini 3 and newer take `thinkingLevel`; Gemini 2.5 takes `thinkingBudget`.
+ * Flash-Lite models get `minimal` for low effort, which is their true
+ * "no thinking" setting. Gemini 2.5 Flash/Flash-Lite accept a zero budget.
+ * Pro models cannot fully disable thinking, so low stays at a small budget.
+ */
+export function googleThinkingControl(modelId, effort, maxTokens) {
+    const id = modelId.toLowerCase();
+    const match = /gemini-(\d+)(?:\.(\d+))?/.exec(id);
+    const major = match ? Number(match[1]) : 0;
+    const minor = match?.[2] ? Number(match[2]) : 0;
+    const lite = /flash[-_.]?lite|lite/.test(id);
+    const pro = /(?:^|[-_/])pro(?:$|[-_/])/.test(id);
+    if (major >= 3) {
+        const low = lite ? 'minimal' : 'low';
+        return { thinkingLevel: effort === 'low' ? low : effort };
+    }
+    if (major === 2 && minor >= 5) {
+        if (effort === 'low' && !pro)
+            return { thinkingBudget: 0 };
+        const budget = googleThinkingBudget(effort, maxTokens);
+        return budget === undefined ? undefined : { thinkingBudget: budget };
+    }
+    const budget = googleThinkingBudget(effort, maxTokens);
+    return budget === undefined ? undefined : { thinkingBudget: budget };
+}
+/** Providers whose OpenAI-compatible endpoint understands `reasoning_effort`. */
+export function supportsOpenAiEffort(providerId) {
+    return new Set(['openai', 'azure', 'groq', 'cerebras', 'openrouter']).has(providerId);
+}
+//# sourceMappingURL=effort.js.map

package/dist/core/effort.js.map

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

package/dist/core/errors.js

@@ -0,0 +1,32 @@
+export class SurfError extends Error {
+    hint;
+    exitCode;
+    status;
+    retryable;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = 'SurfError';
+        this.hint = options.hint;
+        this.exitCode = options.exitCode ?? 1;
+        this.status = options.status;
+        this.retryable = options.retryable;
+    }
+}
+export function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+export function isAbortError(error) {
+    if (!(error instanceof Error))
+        return false;
+    // AbortSignal.timeout() uses TimeoutError, which is retryable. It must not
+    // be mistaken for a user cancellation just because its message says
+    // "aborted due to timeout".
+    if (error.name === 'TimeoutError')
+        return false;
+    if (error.name === 'AbortError')
+        return true;
+    return /(?:request|operation|signal) aborted/i.test(error.message) && !/timeout/i.test(error.message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAU;IACd,QAAQ,CAAS;IACjB,MAAM,CAAU;IAChB,SAAS,CAAW;IAE7B,YACE,OAAe,EACf,UAMI,EAAE;QAEN,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,2EAA2E;IAC3E,oEAAoE;IACpE,4BAA4B;IAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACxG,CAAC"}

package/dist/core/free.js

@@ -0,0 +1,21 @@
+/**
+ * Providers with a permanent no-cost API tier.
+ *
+ * A badge means the provider itself offers free, rate-limited inference; it
+ * does not mean every model is free. Trial credits and one-off promotions are
+ * deliberately excluded because they expire. Local runtimes are already
+ * labelled separately in the UI.
+ */
+export const FREE_API_PROVIDERS = new Set([
+    'google',
+    'groq',
+    'mistral',
+    'openrouter',
+    'cloudflare-workers-ai'
+]);
+export function hasFreeApi(providerId) {
+    return FREE_API_PROVIDERS.has(providerId);
+}
+export const FREE_API_LABEL = '[FREE API]';
+export const FREE_API_HINT = 'free tier · rate-limited';
+//# sourceMappingURL=free.js.map

package/dist/core/free.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"free.js","sourceRoot":"","sources":["../../src/core/free.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,QAAQ;IACR,MAAM;IACN,SAAS;IACT,YAAY;IACZ,uBAAuB;CACxB,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,OAAO,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC"}