deepclause-sdk 0.2.2 → 0.4.0

package/README.md

@@ -329,6 +329,20 @@ deepclause repl --session last          # resume the most recent session
 deepclause repl --session repl_m9x1_1   # …or one by id
 ```
 
+A turn can also **suspend itself** at a safe point and be continued on resume —
+the continuation is a goal, so the program says where it is safe:
+
+```prolog
+loop(N) :-
+    (   N >= 2 -> suspend(loop(N))       % stop here; resume with loop(N)
+    ;   M is N + 1, loop(M)
+    ).
+```
+
+`suspend/1` refuses while the turn holds something a snapshot cannot carry — an
+open stream or an open form — so a resumed session never inherits a half-written
+file. See [`docs/DML_REPL_SUSPEND_RESUME.md`](docs/DML_REPL_SUSPEND_RESUME.md).
+
 ### Why Prolog/DML for a self-modifying harness
 
 An RLM-style harness works best when the harness *is* the program the model
@@ -411,9 +425,10 @@ dml> /ps --watch --logs
   debater   ›   finished
 ```
 
-The authoring agent uses the same machinery through its `spawn` / `ps` / `send`
-/ `call` / `stop` / `swarm` / `wait` tools, and DML programs use the built-ins
-directly (`spawn`, `send`/`receive`, `serve`/`service_call`, `swarm`/`pmap`). A
+The authoring agent uses the same machinery through its `ps` / `send` / `stop` /
+`swarm` / `wait` tools, and drives `spawn` and request/reply through `execute`
+with the DML built-ins (`spawn`, `send`/`receive`, `serve`/`service_call`,
+`swarm`/`pmap`). A
 subagent runs against a **private snapshot** of the module with **value
 semantics** — a result comes back by message, never by a shared variable — which
 is what makes it safe to run many at once.
@@ -461,6 +476,66 @@ only for models that support it.
 Credentials live in pi's agent dir (`~/.pi/agent`) unless `backend.agentDir`
 overrides it. Existing pi installations stay untouched.
 
+### Local models (Ollama, llama.cpp, vLLM)
+
+The default `pi` backend reads pi's `models.json`, which can declare **custom
+OpenAI-compatible providers**, so a local server needs no SDK changes:
+
+```jsonc
+// ~/.pi/agent/models.json
+{
+  "providers": {
+    "loc": {
+      "name": "Local server",
+      "baseUrl": "http://localhost:11434/v1",   // Ollama; llama.cpp: http://127.0.0.1:8080/v1
+      "apiKey": "ollama",                        // any string; satisfies the auth check
+      "api": "openai-completions",               // not openai-responses
+      "models": [{
+        "id": "llama3.1",
+        "contextWindow": 131072,
+        "maxTokens": 8192,
+        "reasoning": false,
+        "input": ["text"],
+        "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
+      }]
+    }
+  }
+}
+```
+
+```bash
+deepclause set-backend pi --list   # lists "loc (Local server) — configured [api-key]"
+                                   # and the model "loc/lecho"
+deepclause repl --model loc:llama3.1
+```
+
+`run` has no `--model` flag; set `backend.model` instead. DML can route a single
+step there as well — `with_model("loc:llama3.1", Goal)`.
+
+Point at a non-default file with `backend.modelsPath` in
+`.deepclause/config.json` (or `PI_CODING_AGENT_DIR` to move pi's whole agent
+dir), which keeps a project's catalog in the repository rather than the home
+directory:
+
+```json
+{ "backend": { "kind": "pi", "model": "loc:llama3.1", "modelsPath": "./agent/models.json" } }
+```
+
+- **`api` picks the wire protocol.** `openai-completions` is what Ollama,
+  llama.cpp, vLLM and SGLang serve; `openai-responses` is the newer OpenAI API.
+  Per-provider `compat` flags cover servers that differ
+  (`maxTokensField`, `supportsUsageInStreaming`, `requiresToolResultName`, …),
+  and a model's `samplingParams` forwards `top_p`/`top_k`/`repetition_penalty`.
+- **Tool calling is required for `task/N`**, which ends by calling
+  `set_result`/`finish`; a text-only model exhausts the turn instead. `chat/1`
+  needs no tools, so a small local model is usable there, or pick a model whose
+  chat template supports tools.
+- **`list-models` prints the bundled model database** and will not show custom
+  entries; `set-backend pi --list` prints pi's catalog, which does.
+- The `env` backend can also point at a local server
+  (`providers.openai.baseUrl` + `apiKey`), but it always speaks chat completions
+  and **`repl` ignores `providers.*.baseUrl`** today — prefer the `pi` backend.
+
 ## run
 
 `run` uses the **same engine as the REPL**: it opens a module, loads the
@@ -662,6 +737,13 @@ npm test          # vitest
 npm run repl      # deepclause repl via tsx
 ```
 
+**`npm run build` is required for the default process backend.** L2 (worker)
+processes run `dist/repl/process-worker.js`, so editing `src` without rebuilding
+runs old worker code against a new main — the symptom used to be child sessions
+that silently had no harness. `WORKER_PROTOCOL_VERSION` now fails that loudly
+(`stale L2 process worker: … run 'npm run build'`). The tests that need it
+(`repl-process-worker-child`) skip themselves when `dist` is absent.
+
 See [`docs/`](docs/): [`SUBAGENTS.md`](docs/SUBAGENTS.md) (subagents and
 concurrency), [`STATUS.md`](docs/STATUS.md) (current state),
 [`REPL.md`](docs/REPL.md),
@@ -670,6 +752,7 @@ concurrency), [`STATUS.md`](docs/STATUS.md) (current state),
 [`DML_MEDIA.md`](docs/DML_MEDIA.md),
 [`DML_MODEL_SWITCHING.md`](docs/DML_MODEL_SWITCHING.md),
 [`DML_REPL_WORKER_EXECUTION.md`](docs/DML_REPL_WORKER_EXECUTION.md) (plan),
+[`DML_FORMS.md`](docs/DML_FORMS.md) (structured human input),
 [`JUDGMENT_BACKENDS.md`](docs/JUDGMENT_BACKENDS.md).
 
 ## License

package/dist/agent.d.ts

@@ -11,6 +11,21 @@ import type { ExecutionEnvironment } from './system/runtime/shell-manager.js';
 export interface AgentLoopOptions {
     taskDescription: string;
     outputVars: (string | TypedVar)[];
+    /**
+     * Conversational mode: a chat turn, not a task.
+     *
+     * A traditional agent loop — tools, but no `finish`/`set_result`, and the turn
+     * ends when the model stops calling tools. That is how a chat agent works: it
+     * replies, and the next message starts the next turn. Task mode, by contrast,
+     * insists on an explicit `finish` and nudges the model when it does not.
+     */
+    conversational?: boolean;
+    /**
+     * A conversational turn has run out of tool calls. Return a message to keep the
+     * turn alive (the runner uses it to deliver a form the person is still filling
+     * in), or null to end the turn.
+     */
+    onIdleTurn?: () => Promise<string | null>;
     memory: MemoryMessage[];
     tools: Map<string, ToolDefinition>;
     /**
@@ -25,6 +40,8 @@ export interface AgentLoopOptions {
      * and dates in the dark.
      */
     environment?: ExecutionEnvironment;
+    /** Name of the single capability host tool (default `bash`; the browser uses `python`). */
+    capabilityTool?: string;
     modelOptions: {
         model: string;
         provider: string;

package/dist/agent.d.ts.map

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

package/dist/agent.js

@@ -6,7 +6,7 @@
  * - Uses Zod schemas for tool definitions
  * - Uses result.response.messages for message history management
  */
-import { generateText, streamText, hasToolCall, tool as aiTool } from 'ai';
+import { generateText, streamText, hasToolCall, stepCountIs, tool as aiTool } from 'ai';
 import { z } from 'zod';
 import { createModelProvider } from './prolog/bridge.js';
 import { readSystemPromptAsset } from './system/assets/index.js';
@@ -512,7 +512,9 @@ async function runInjectedAgentLoop(options, normalizedOutputVars, combinedSyste
         success: false,
     };
     const requiredVarNames = normalizedOutputVars.map((variable) => variable.name);
-    const backendTools = [{
+    // A chat turn has no `finish`/`set_result`: it ends when the model stops calling
+    // tools, like a traditional agent loop.
+    const backendTools = options.conversational ? [] : [{
             name: 'finish',
             description: 'Complete the task. success=true requires every requested result variable to be set.',
             parameters: {
@@ -575,7 +577,7 @@ async function runInjectedAgentLoop(options, normalizedOutputVars, combinedSyste
     const messages = [
         { role: 'system', content: combinedSystemPrompt },
         ...historyMessages,
-        { role: 'user', content: `Subtask: ${options.taskDescription}` },
+        { role: 'user', content: options.conversational ? options.taskDescription : `Subtask: ${options.taskDescription}` },
     ];
     const maxIterations = Math.max(1, Number(process.env.DC_MAX_ITERATIONS) || 1000);
     for (let iteration = 0; iteration < maxIterations && !state.finished; iteration++) {
@@ -707,10 +709,24 @@ async function runInjectedAgentLoop(options, normalizedOutputVars, combinedSyste
             });
         }
         if (toolCalls.length === 0 && !state.finished) {
-            messages.push({
-                role: 'user',
-                content: 'Continue the task. Use set_result for each requested output, then call finish.',
-            });
+            if (options.conversational) {
+                // The reply is the answer — unless the host is still holding something
+                // for this turn (a form the person has not submitted yet).
+                const injected = options.onIdleTurn ? await options.onIdleTurn() : null;
+                if (injected) {
+                    messages.push({ role: 'user', content: injected });
+                }
+                else {
+                    state.finished = true;
+                    state.success = true;
+                }
+            }
+            else {
+                messages.push({
+                    role: 'user',
+                    content: 'Continue the task. Use set_result for each requested output, then call finish.',
+                });
+            }
         }
     }
     return {
@@ -748,26 +764,28 @@ export async function runAgentLoop(options) {
     // Build the AI SDK tools using Zod schemas
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const aiTools = {};
-    // Add finish tool with Zod schema
+    // Add finish tool with Zod schema. A chat turn has no finish: the model replies
+    // and stops, and the next message starts the next turn.
     const requiredVarNames = normalizedOutputVars.map(v => v.name);
-    aiTools['finish'] = aiTool({
-        description: 'CRITICAL: You MUST call this tool to complete the task and return success/failure. Call with success=true if you have set all required results, or success=false if the task is impossible.',
-        inputSchema: z.object({
-            success: z.boolean().describe('Whether the task was completed successfully')
-        }),
-        execute: async ({ success: s }) => {
-            // Guard: success=true requires all output variables to be set
-            if (s && requiredVarNames.length > 0) {
-                const missing = requiredVarNames.filter(v => !(v in variables));
-                if (missing.length > 0) {
-                    return { finished: false, error: `Cannot finish with success=true — missing required result variable(s): ${missing.join(', ')}. Call set_result for each before finishing.` };
+    if (!options.conversational)
+        aiTools['finish'] = aiTool({
+            description: 'CRITICAL: You MUST call this tool to complete the task and return success/failure. Call with success=true if you have set all required results, or success=false if the task is impossible.',
+            inputSchema: z.object({
+                success: z.boolean().describe('Whether the task was completed successfully')
+            }),
+            execute: async ({ success: s }) => {
+                // Guard: success=true requires all output variables to be set
+                if (s && requiredVarNames.length > 0) {
+                    const missing = requiredVarNames.filter(v => !(v in variables));
+                    if (missing.length > 0) {
+                        return { finished: false, error: `Cannot finish with success=true — missing required result variable(s): ${missing.join(', ')}. Call set_result for each before finishing.` };
+                    }
                 }
-            }
-            finished = true;
-            success = s;
-            return { finished: true, success: s };
-        },
-    });
+                finished = true;
+                success = s;
+                return { finished: true, success: s };
+            },
+        });
     // Add set_result tool for output variables
     if (normalizedOutputVars.length > 0) {
         const varNames = normalizedOutputVars.map(v => v.name);
@@ -850,6 +868,8 @@ export async function runAgentLoop(options) {
         tools,
         workspacePath: options.workspacePath,
         environment: options.environment,
+        capabilityTool: options.capabilityTool,
+        conversational: options.conversational,
     });
     // Extract system context from memory (user-defined system() calls)
     const systemContext = memory
@@ -949,7 +969,7 @@ export async function runAgentLoop(options) {
                     maxOutputTokens: modelOptions.maxOutputTokens,
                     abortSignal: signal,
                     providerOptions: modelOptions.providerOptions,
-                    stopWhen: hasToolCall('finish'),
+                    stopWhen: options.conversational ? stepCountIs(1) : hasToolCall('finish'),
                     onStepFinish: (step) => {
                         debugLog(`Step finished: finishReason=${step.finishReason} toolCalls=${step.toolCalls?.length ?? 0}`);
                     },
@@ -1122,10 +1142,28 @@ export async function runAgentLoop(options) {
                     outputs.push('Agent loop detected repeated non-progressing responses and stopped early.');
                     break;
                 }
+                // A chat turn ends when the model stops calling tools: that reply is the
+                // answer, and the next message starts the next turn. Unless the host is
+                // still holding something for this turn — a form the person has not
+                // submitted yet — in which case its submission is injected and the loop
+                // continues, so the turn never ends with an unanswered form.
+                if (options.conversational && !finished && toolCallsThisIteration.length === 0) {
+                    const injected = options.onIdleTurn ? await options.onIdleTurn() : null;
+                    if (injected) {
+                        messages.push({ role: 'user', content: injected });
+                    }
+                    else {
+                        finished = true;
+                        success = true;
+                    }
+                }
                 // If no tool calls were made, nudge the model to act.
                 // This handles 'stop', 'other', and any unexpected finish reason.
-                const recoveryPrompt = buildRecoveryPrompt(normalizedOutputVars, repeatedStallCount, toolCallsThisIteration.length === 0);
-                const continuationPrompt = !finished && getLastMessageRole(messages) === 'assistant'
+                // A chat turn is never nudged: the model simply finished its reply.
+                const recoveryPrompt = options.conversational
+                    ? null
+                    : buildRecoveryPrompt(normalizedOutputVars, repeatedStallCount, toolCallsThisIteration.length === 0);
+                const continuationPrompt = !options.conversational && !finished && getLastMessageRole(messages) === 'assistant'
                     ? buildAssistantContinuationPrompt(normalizedOutputVars)
                     : null;
                 const nextPrompt = recoveryPrompt ?? continuationPrompt;
@@ -1242,10 +1280,28 @@ export async function runAgentLoop(options) {
                     outputs.push('Agent loop detected repeated non-progressing responses and stopped early.');
                     break;
                 }
+                // A chat turn ends when the model stops calling tools: that reply is the
+                // answer, and the next message starts the next turn. Unless the host is
+                // still holding something for this turn — a form the person has not
+                // submitted yet — in which case its submission is injected and the loop
+                // continues, so the turn never ends with an unanswered form.
+                if (options.conversational && !finished && toolCallsThisIteration.length === 0) {
+                    const injected = options.onIdleTurn ? await options.onIdleTurn() : null;
+                    if (injected) {
+                        messages.push({ role: 'user', content: injected });
+                    }
+                    else {
+                        finished = true;
+                        success = true;
+                    }
+                }
                 // If no tool calls were made, nudge the model to act.
                 // This handles 'stop', 'other', and any unexpected finish reason.
-                const recoveryPrompt = buildRecoveryPrompt(normalizedOutputVars, repeatedStallCount, toolCallsThisIteration.length === 0);
-                const continuationPrompt = !finished && getLastMessageRole(messages) === 'assistant'
+                // A chat turn is never nudged: the model simply finished its reply.
+                const recoveryPrompt = options.conversational
+                    ? null
+                    : buildRecoveryPrompt(normalizedOutputVars, repeatedStallCount, toolCallsThisIteration.length === 0);
+                const continuationPrompt = !options.conversational && !finished && getLastMessageRole(messages) === 'assistant'
                     ? buildAssistantContinuationPrompt(normalizedOutputVars)
                     : null;
                 const nextPrompt = recoveryPrompt ?? continuationPrompt;
@@ -1298,11 +1354,36 @@ export async function runAgentLoop(options) {
     // Extract assistant text responses from the conversation
     const assistantTextResponses = [];
     for (const m of messages) {
-        if (m.role === 'assistant' && typeof m.content === 'string' && m.content.trim()) {
-            assistantTextResponses.push(m.content);
-        }
+        // An AI-SDK assistant message carries its text as content *parts*
+        // (`[{type:'text', text:'…'}]`), not a string. Skipping those dropped every
+        // assistant reply from the memory a conversation hands to the next turn (and
+        // left `chat/2` binding an empty string).
+        if (m.role !== 'assistant')
+            continue;
+        const text = messageText(m.content);
+        if (text.trim())
+            assistantTextResponses.push(text);
     }
     // Add result to persistent messages
+    if (options.conversational) {
+        // A chat turn keeps the conversation, not a task summary: the person's
+        // message and what the agent actually said. No extra summarising model call.
+        return {
+            success: true,
+            outputs,
+            variables,
+            messages: [
+                ...conversationHistory
+                    .filter((message) => message.role === 'user' || message.role === 'assistant')
+                    .map((message) => ({
+                    role: message.role,
+                    content: typeof message.content === 'string' ? message.content : JSON.stringify(message.content),
+                })),
+                { role: 'user', content: taskDescription },
+                ...assistantTextResponses.map((text) => ({ role: 'assistant', content: text })),
+            ],
+        };
+    }
     if (success && Object.keys(variables).length > 0) {
         const varSummary = Object.entries(variables)
             .map(([k, v]) => `${k}: ${v}`)
@@ -1347,6 +1428,18 @@ export async function runAgentLoop(options) {
         messages: persistentMessages,
     };
 }
+/** An assistant message's text: a string, or its `{type: 'text'}` content parts. */
+function messageText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((part) => (part && typeof part === 'object' && part.type === 'text'
+        ? String(part.text ?? '')
+        : ''))
+        .join('');
+}
 function getResponseMessages(response) {
     if (!response || typeof response !== 'object') {
         return [];
@@ -1360,15 +1453,17 @@ function getResponseMessages(response) {
 async function buildSystemPrompt(options) {
     const toolDescriptions = [];
     const normalizedOutputVars = options.outputVars;
-    // Add finish tool description
-    toolDescriptions.push('- finish(success: boolean): Signal task completion. Call finish(true) when done successfully, or finish(false) if the task cannot be completed.');
-    // Add set_result tool if we have output variables
-    if (normalizedOutputVars.length > 0) {
-        const varList = normalizedOutputVars.map(v => {
-            const typeStr = v.type === 'array' && v.itemType ? `array<${v.itemType}>` : v.type;
-            return `"${v.name}" (${typeStr})`;
-        }).join(', ');
-        toolDescriptions.push(`- set_result(variable: string, value: any): Store a result value. Variable must be one of: ${varList}`);
+    if (!options.conversational) {
+        // Add finish tool description
+        toolDescriptions.push('- finish(success: boolean): Signal task completion. Call finish(true) when done successfully, or finish(false) if the task cannot be completed.');
+        // Add set_result tool if we have output variables
+        if (normalizedOutputVars.length > 0) {
+            const varList = normalizedOutputVars.map(v => {
+                const typeStr = v.type === 'array' && v.itemType ? `array<${v.itemType}>` : v.type;
+                return `"${v.name}" (${typeStr})`;
+            }).join(', ');
+            toolDescriptions.push(`- set_result(variable: string, value: any): Store a result value. Variable must be one of: ${varList}`);
+        }
     }
     // Add user-defined tools
     for (const [name, tool] of options.tools) {
@@ -1400,6 +1495,16 @@ async function buildSystemPrompt(options) {
         '- If you are stuck, either choose one different tool or call finish(false).',
         '- Once enough information exists, stop planning, set results if needed, and finish.',
     ].join('\n');
+    if (options.conversational) {
+        const chatTemplate = await readSystemPromptAsset('chat', { workspacePath: options.workspacePath });
+        return chatTemplate
+            .replace('{TOOL_DESCRIPTIONS}', toolDescriptions.join('\n'))
+            .replace('{ENVIRONMENT_SECTION}', describeEnvironment({
+            workspacePath: options.workspacePath,
+            environment: options.environment,
+            capabilityTool: options.capabilityTool,
+        }) + describeCurrentTime());
+    }
     const template = await readSystemPromptAsset('task', { workspacePath: options.workspacePath });
     return template
         .replace('{TASK_DESCRIPTION}', options.taskDescription)
@@ -1409,6 +1514,7 @@ async function buildSystemPrompt(options) {
         .replace('{ENVIRONMENT_SECTION}', describeEnvironment({
         workspacePath: options.workspacePath,
         environment: options.environment,
+        capabilityTool: options.capabilityTool,
     }) + describeCurrentTime());
 }
 //# sourceMappingURL=agent.js.map