@positronic/spec 0.0.37 → 0.0.39

package/dist/api.d.ts

@@ -55,6 +55,19 @@ export declare const brains: {
      * Test GET /brains - List all brains
      */
     list(fetch: Fetch): Promise<boolean>;
+    /**
+     * Test GET /brains?q=<query> - Search brains by query string
+     * Returns brains matching the query (by title, filename, or description).
+     * The matching algorithm is implementation-defined; the spec only verifies
+     * the response structure and that results are relevant to the query.
+     */
+    search(fetch: Fetch, query: string): Promise<{
+        brains: Array<{
+            title: string;
+            description: string;
+        }>;
+        count: number;
+    } | null>;
     /**
      * Test GET /brains/:identifier - Get brain structure/definition
      * (For future brain exploration/info command)
@@ -89,6 +102,40 @@ export declare const brains: {
      * Test DELETE /brains/runs/:runId - Kill/cancel a running brain run
      */
     kill(fetch: Fetch, runId: string): Promise<boolean>;
+    /**
+     * Test DELETE /brains/runs/:runId for a brain suspended on a webhook.
+     * This tests that killing a webhook-suspended brain:
+     * 1. Returns 204 (not 409)
+     * 2. Updates status to CANCELLED
+     * 3. Clears webhook registrations (webhook no longer resumes the brain)
+     *
+     * Requires a brain with a loop step that will pause on a webhook.
+     */
+    killSuspended(fetch: Fetch, loopBrainIdentifier: string, webhookSlug: string, webhookPayload: Record<string, any>): Promise<boolean>;
+    /**
+     * Test that loop steps emit proper LOOP_* events in the SSE stream.
+     * Requires a brain with a loop step that will pause on a webhook.
+     *
+     * Expected events before webhook pause:
+     * - LOOP_START (with prompt and optional system)
+     * - LOOP_ITERATION
+     * - LOOP_TOOL_CALL
+     * - LOOP_WEBHOOK (before WEBHOOK event)
+     * - WEBHOOK
+     */
+    watchLoopEvents(fetch: Fetch, loopBrainIdentifier: string): Promise<boolean>;
+    /**
+     * Test full loop webhook resumption flow:
+     * 1. Start a loop brain that will pause on a webhook
+     * 2. Verify it pauses with WEBHOOK event
+     * 3. Trigger the webhook with a response
+     * 4. Verify the brain resumes and emits WEBHOOK_RESPONSE and LOOP_TOOL_RESULT
+     *
+     * Requires:
+     * - A brain with a loop step that calls a tool returning { waitFor: webhook(...) }
+     * - The webhook slug and identifier to trigger
+     */
+    loopWebhookResume(fetch: Fetch, loopBrainIdentifier: string, webhookSlug: string, webhookPayload: Record<string, any>): Promise<boolean>;
 };
 export declare const schedules: {
     /**

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -1,4 +1,4 @@
-import { STATUS } from '@positronic/core';
+import { STATUS, BRAIN_EVENTS } from '@positronic/core';
 export async function testStatus(fetch) {
     try {
         const request = new Request('http://example.com/status', {
@@ -570,6 +570,56 @@ export const brains = {
             return false;
         }
     },
+    /**
+     * Test GET /brains?q=<query> - Search brains by query string
+     * Returns brains matching the query (by title, filename, or description).
+     * The matching algorithm is implementation-defined; the spec only verifies
+     * the response structure and that results are relevant to the query.
+     */
+    async search(fetch, query) {
+        try {
+            const url = new URL('http://example.com/brains');
+            url.searchParams.set('q', query);
+            const request = new Request(url.toString(), {
+                method: 'GET',
+            });
+            const response = await fetch(request);
+            if (!response.ok) {
+                console.error(`GET /brains?q=${query} returned ${response.status}`);
+                return null;
+            }
+            const data = await response.json();
+            // Validate response structure
+            if (!Array.isArray(data.brains)) {
+                console.error(`Expected brains to be an array, got ${typeof data.brains}`);
+                return null;
+            }
+            if (typeof data.count !== 'number') {
+                console.error(`Expected count to be number, got ${typeof data.count}`);
+                return null;
+            }
+            // Validate each brain has required fields
+            for (const brain of data.brains) {
+                if (!brain.title ||
+                    typeof brain.title !== 'string' ||
+                    !brain.description ||
+                    typeof brain.description !== 'string') {
+                    console.error(`Brain missing required fields or has invalid types: ${JSON.stringify(brain)}`);
+                    return null;
+                }
+            }
+            // Count should match array length
+            if (data.count !== data.brains.length) {
+                console.error(`Count (${data.count}) does not match brains array length (${data.brains.length})`);
+                return null;
+            }
+            return data;
+        }
+        catch (error) {
+            console.error(`Failed to test GET /brains?q=${query}:`, error);
+            return null;
+        }
+    },
     /**
      * Test GET /brains/:identifier - Get brain structure/definition
      * (For future brain exploration/info command)
@@ -867,6 +917,425 @@ export const brains = {
             return false;
         }
     },
+    /**
+     * Test DELETE /brains/runs/:runId for a brain suspended on a webhook.
+     * This tests that killing a webhook-suspended brain:
+     * 1. Returns 204 (not 409)
+     * 2. Updates status to CANCELLED
+     * 3. Clears webhook registrations (webhook no longer resumes the brain)
+     *
+     * Requires a brain with a loop step that will pause on a webhook.
+     */
+    async killSuspended(fetch, loopBrainIdentifier, webhookSlug, webhookPayload) {
+        try {
+            // Step 1: Start the loop brain
+            const runRequest = new Request('http://example.com/brains/runs', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ identifier: loopBrainIdentifier }),
+            });
+            const runResponse = await fetch(runRequest);
+            if (runResponse.status !== 201) {
+                console.error(`POST /brains/runs returned ${runResponse.status}, expected 201`);
+                return false;
+            }
+            const { brainRunId } = (await runResponse.json());
+            // Step 2: Watch until WEBHOOK event (brain pauses)
+            const watchRequest = new Request(`http://example.com/brains/runs/${brainRunId}/watch`, { method: 'GET' });
+            const watchResponse = await fetch(watchRequest);
+            if (!watchResponse.ok) {
+                console.error(`GET /brains/runs/${brainRunId}/watch returned ${watchResponse.status}`);
+                return false;
+            }
+            let foundWebhookEvent = false;
+            if (watchResponse.body) {
+                const reader = watchResponse.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                try {
+                    while (!foundWebhookEvent) {
+                        const { value, done } = await reader.read();
+                        if (done)
+                            break;
+                        buffer += decoder.decode(value, { stream: true });
+                        let eventEndIndex;
+                        while ((eventEndIndex = buffer.indexOf('\n\n')) !== -1) {
+                            const message = buffer.substring(0, eventEndIndex);
+                            buffer = buffer.substring(eventEndIndex + 2);
+                            if (message.startsWith('data: ')) {
+                                try {
+                                    const event = JSON.parse(message.substring(6));
+                                    if (event.type === BRAIN_EVENTS.WEBHOOK) {
+                                        foundWebhookEvent = true;
+                                        break;
+                                    }
+                                    if (event.type === BRAIN_EVENTS.COMPLETE ||
+                                        event.type === BRAIN_EVENTS.ERROR) {
+                                        console.error(`Brain completed/errored before WEBHOOK event: ${event.type}`);
+                                        return false;
+                                    }
+                                }
+                                catch (e) {
+                                    // Ignore parse errors
+                                }
+                            }
+                        }
+                    }
+                }
+                finally {
+                    await reader.cancel();
+                }
+            }
+            if (!foundWebhookEvent) {
+                console.error('Brain did not emit WEBHOOK event');
+                return false;
+            }
+            // Step 3: Kill the suspended brain
+            const killRequest = new Request(`http://example.com/brains/runs/${brainRunId}`, { method: 'DELETE' });
+            const killResponse = await fetch(killRequest);
+            if (killResponse.status !== 204) {
+                console.error(`DELETE /brains/runs/${brainRunId} returned ${killResponse.status}, expected 204`);
+                return false;
+            }
+            // Step 4: Verify status is CANCELLED via getRun
+            const getRunRequest = new Request(`http://example.com/brains/runs/${brainRunId}`, { method: 'GET' });
+            const getRunResponse = await fetch(getRunRequest);
+            if (!getRunResponse.ok) {
+                console.error(`GET /brains/runs/${brainRunId} returned ${getRunResponse.status}`);
+                return false;
+            }
+            const runData = (await getRunResponse.json());
+            if (runData.status !== STATUS.CANCELLED) {
+                console.error(`Expected status to be '${STATUS.CANCELLED}', got '${runData.status}'`);
+                return false;
+            }
+            // Step 5: Verify webhook no longer resumes the brain
+            // Send a webhook - it should return 'no-match' since registrations were cleared
+            const webhookRequest = new Request(`http://example.com/webhooks/${encodeURIComponent(webhookSlug)}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(webhookPayload),
+            });
+            const webhookResponse = await fetch(webhookRequest);
+            // Accept 200/202 - the important thing is it doesn't resume the brain
+            if (!webhookResponse.ok) {
+                console.error(`POST /webhooks/${webhookSlug} returned ${webhookResponse.status}`);
+                return false;
+            }
+            const webhookResult = (await webhookResponse.json());
+            // The action should be 'no-match' since webhook registrations were cleared
+            if (webhookResult.action === 'resumed') {
+                console.error('Webhook resumed the brain after it was killed - webhook registrations were not cleared');
+                return false;
+            }
+            // Verify the brain is still CANCELLED (didn't restart)
+            const finalCheckRequest = new Request(`http://example.com/brains/runs/${brainRunId}`, { method: 'GET' });
+            const finalCheckResponse = await fetch(finalCheckRequest);
+            if (!finalCheckResponse.ok) {
+                console.error(`Final GET /brains/runs/${brainRunId} returned ${finalCheckResponse.status}`);
+                return false;
+            }
+            const finalRunData = (await finalCheckResponse.json());
+            if (finalRunData.status !== STATUS.CANCELLED) {
+                console.error(`Final status check: expected '${STATUS.CANCELLED}', got '${finalRunData.status}'`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            console.error(`Failed to test kill suspended brain for ${loopBrainIdentifier}:`, error);
+            return false;
+        }
+    },
+    /**
+     * Test that loop steps emit proper LOOP_* events in the SSE stream.
+     * Requires a brain with a loop step that will pause on a webhook.
+     *
+     * Expected events before webhook pause:
+     * - LOOP_START (with prompt and optional system)
+     * - LOOP_ITERATION
+     * - LOOP_TOOL_CALL
+     * - LOOP_WEBHOOK (before WEBHOOK event)
+     * - WEBHOOK
+     */
+    async watchLoopEvents(fetch, loopBrainIdentifier) {
+        try {
+            // Start the loop brain
+            const runRequest = new Request('http://example.com/brains/runs', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ identifier: loopBrainIdentifier }),
+            });
+            const runResponse = await fetch(runRequest);
+            if (runResponse.status !== 201) {
+                console.error(`POST /brains/runs returned ${runResponse.status}, expected 201`);
+                return false;
+            }
+            const { brainRunId } = (await runResponse.json());
+            // Watch the brain run
+            const watchRequest = new Request(`http://example.com/brains/runs/${brainRunId}/watch`, { method: 'GET' });
+            const watchResponse = await fetch(watchRequest);
+            if (!watchResponse.ok) {
+                console.error(`GET /brains/runs/${brainRunId}/watch returned ${watchResponse.status}`);
+                return false;
+            }
+            // Read SSE events until we get WEBHOOK or COMPLETE/ERROR
+            const events = [];
+            if (watchResponse.body) {
+                const reader = watchResponse.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                let done = false;
+                try {
+                    while (!done) {
+                        const { value, done: streamDone } = await reader.read();
+                        if (streamDone)
+                            break;
+                        buffer += decoder.decode(value, { stream: true });
+                        // Process complete SSE messages
+                        let eventEndIndex;
+                        while ((eventEndIndex = buffer.indexOf('\n\n')) !== -1) {
+                            const message = buffer.substring(0, eventEndIndex);
+                            buffer = buffer.substring(eventEndIndex + 2);
+                            if (message.startsWith('data: ')) {
+                                try {
+                                    const event = JSON.parse(message.substring(6));
+                                    events.push(event);
+                                    // Stop on terminal events
+                                    if (event.type === BRAIN_EVENTS.WEBHOOK ||
+                                        event.type === BRAIN_EVENTS.COMPLETE ||
+                                        event.type === BRAIN_EVENTS.ERROR) {
+                                        done = true;
+                                        break;
+                                    }
+                                }
+                                catch (e) {
+                                    // Ignore parse errors
+                                }
+                            }
+                        }
+                    }
+                }
+                finally {
+                    await reader.cancel();
+                }
+            }
+            // Verify required loop events are present
+            const hasLoopStart = events.some((e) => e.type === BRAIN_EVENTS.LOOP_START);
+            if (!hasLoopStart) {
+                console.error('Missing LOOP_START event in SSE stream');
+                return false;
+            }
+            // Verify LOOP_START has prompt field
+            const loopStartEvent = events.find((e) => e.type === BRAIN_EVENTS.LOOP_START);
+            if (!loopStartEvent.prompt || typeof loopStartEvent.prompt !== 'string') {
+                console.error('LOOP_START event missing prompt field');
+                return false;
+            }
+            const hasLoopIteration = events.some((e) => e.type === BRAIN_EVENTS.LOOP_ITERATION);
+            if (!hasLoopIteration) {
+                console.error('Missing LOOP_ITERATION event in SSE stream');
+                return false;
+            }
+            const hasLoopToolCall = events.some((e) => e.type === BRAIN_EVENTS.LOOP_TOOL_CALL);
+            if (!hasLoopToolCall) {
+                console.error('Missing LOOP_TOOL_CALL event in SSE stream');
+                return false;
+            }
+            // If we got a WEBHOOK event, verify LOOP_WEBHOOK came before it
+            const webhookIndex = events.findIndex((e) => e.type === BRAIN_EVENTS.WEBHOOK);
+            if (webhookIndex !== -1) {
+                const loopWebhookIndex = events.findIndex((e) => e.type === BRAIN_EVENTS.LOOP_WEBHOOK);
+                if (loopWebhookIndex === -1) {
+                    console.error('Missing LOOP_WEBHOOK event before WEBHOOK event');
+                    return false;
+                }
+                if (loopWebhookIndex >= webhookIndex) {
+                    console.error('LOOP_WEBHOOK event must come before WEBHOOK event');
+                    return false;
+                }
+                // Verify LOOP_WEBHOOK has required fields
+                const loopWebhookEvent = events[loopWebhookIndex];
+                if (!loopWebhookEvent.toolCallId || !loopWebhookEvent.toolName) {
+                    console.error('LOOP_WEBHOOK event missing toolCallId or toolName fields');
+                    return false;
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            console.error(`Failed to test loop events for ${loopBrainIdentifier}:`, error);
+            return false;
+        }
+    },
+    /**
+     * Test full loop webhook resumption flow:
+     * 1. Start a loop brain that will pause on a webhook
+     * 2. Verify it pauses with WEBHOOK event
+     * 3. Trigger the webhook with a response
+     * 4. Verify the brain resumes and emits WEBHOOK_RESPONSE and LOOP_TOOL_RESULT
+     *
+     * Requires:
+     * - A brain with a loop step that calls a tool returning { waitFor: webhook(...) }
+     * - The webhook slug and identifier to trigger
+     */
+    async loopWebhookResume(fetch, loopBrainIdentifier, webhookSlug, webhookPayload) {
+        try {
+            // Step 1: Start the loop brain
+            const runRequest = new Request('http://example.com/brains/runs', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ identifier: loopBrainIdentifier }),
+            });
+            const runResponse = await fetch(runRequest);
+            if (runResponse.status !== 201) {
+                console.error(`POST /brains/runs returned ${runResponse.status}, expected 201`);
+                return false;
+            }
+            const { brainRunId } = (await runResponse.json());
+            // Step 2: Watch until WEBHOOK event (brain pauses)
+            const watchRequest = new Request(`http://example.com/brains/runs/${brainRunId}/watch`, { method: 'GET' });
+            const watchResponse = await fetch(watchRequest);
+            if (!watchResponse.ok) {
+                console.error(`GET /brains/runs/${brainRunId}/watch returned ${watchResponse.status}`);
+                return false;
+            }
+            let foundWebhookEvent = false;
+            if (watchResponse.body) {
+                const reader = watchResponse.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                try {
+                    while (!foundWebhookEvent) {
+                        const { value, done } = await reader.read();
+                        if (done)
+                            break;
+                        buffer += decoder.decode(value, { stream: true });
+                        let eventEndIndex;
+                        while ((eventEndIndex = buffer.indexOf('\n\n')) !== -1) {
+                            const message = buffer.substring(0, eventEndIndex);
+                            buffer = buffer.substring(eventEndIndex + 2);
+                            if (message.startsWith('data: ')) {
+                                try {
+                                    const event = JSON.parse(message.substring(6));
+                                    if (event.type === BRAIN_EVENTS.WEBHOOK) {
+                                        foundWebhookEvent = true;
+                                        break;
+                                    }
+                                    if (event.type === BRAIN_EVENTS.COMPLETE ||
+                                        event.type === BRAIN_EVENTS.ERROR) {
+                                        console.error(`Brain completed/errored before WEBHOOK event: ${event.type}`);
+                                        return false;
+                                    }
+                                }
+                                catch (e) {
+                                    // Ignore parse errors
+                                }
+                            }
+                        }
+                    }
+                }
+                finally {
+                    await reader.cancel();
+                }
+            }
+            if (!foundWebhookEvent) {
+                console.error('Brain did not emit WEBHOOK event');
+                return false;
+            }
+            // Step 3: Trigger the webhook
+            const webhookRequest = new Request(`http://example.com/webhooks/${encodeURIComponent(webhookSlug)}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(webhookPayload),
+            });
+            const webhookResponse = await fetch(webhookRequest);
+            if (!webhookResponse.ok) {
+                console.error(`POST /webhooks/${webhookSlug} returned ${webhookResponse.status}`);
+                return false;
+            }
+            const webhookResult = (await webhookResponse.json());
+            if (!webhookResult.received) {
+                console.error('Webhook was not received');
+                return false;
+            }
+            if (webhookResult.action !== 'resumed') {
+                console.error(`Expected webhook action 'resumed', got '${webhookResult.action}'`);
+                return false;
+            }
+            // Step 4: Watch again for resumed events
+            const resumeWatchRequest = new Request(`http://example.com/brains/runs/${brainRunId}/watch`, { method: 'GET' });
+            const resumeWatchResponse = await fetch(resumeWatchRequest);
+            if (!resumeWatchResponse.ok) {
+                console.error(`GET /brains/runs/${brainRunId}/watch (resume) returned ${resumeWatchResponse.status}`);
+                return false;
+            }
+            const resumeEvents = [];
+            if (resumeWatchResponse.body) {
+                const reader = resumeWatchResponse.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                let done = false;
+                try {
+                    while (!done) {
+                        const { value, done: streamDone } = await reader.read();
+                        if (streamDone)
+                            break;
+                        buffer += decoder.decode(value, { stream: true });
+                        let eventEndIndex;
+                        while ((eventEndIndex = buffer.indexOf('\n\n')) !== -1) {
+                            const message = buffer.substring(0, eventEndIndex);
+                            buffer = buffer.substring(eventEndIndex + 2);
+                            if (message.startsWith('data: ')) {
+                                try {
+                                    const event = JSON.parse(message.substring(6));
+                                    resumeEvents.push(event);
+                                    if (event.type === BRAIN_EVENTS.COMPLETE ||
+                                        event.type === BRAIN_EVENTS.ERROR) {
+                                        done = true;
+                                        break;
+                                    }
+                                }
+                                catch (e) {
+                                    // Ignore parse errors
+                                }
+                            }
+                        }
+                    }
+                }
+                finally {
+                    await reader.cancel();
+                }
+            }
+            // Verify WEBHOOK_RESPONSE event is present
+            const hasWebhookResponse = resumeEvents.some((e) => e.type === BRAIN_EVENTS.WEBHOOK_RESPONSE);
+            if (!hasWebhookResponse) {
+                console.error('Missing WEBHOOK_RESPONSE event after resume');
+                return false;
+            }
+            // Verify LOOP_TOOL_RESULT event is present (with the webhook response as result)
+            const hasLoopToolResult = resumeEvents.some((e) => e.type === BRAIN_EVENTS.LOOP_TOOL_RESULT);
+            if (!hasLoopToolResult) {
+                console.error('Missing LOOP_TOOL_RESULT event after resume');
+                return false;
+            }
+            // Verify brain completed successfully
+            const completeEvent = resumeEvents.find((e) => e.type === BRAIN_EVENTS.COMPLETE);
+            if (!completeEvent) {
+                console.error('Brain did not complete after resume');
+                return false;
+            }
+            if (completeEvent.status !== STATUS.COMPLETE) {
+                console.error(`Expected COMPLETE status, got ${completeEvent.status}`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            console.error(`Failed to test loop webhook resume for ${loopBrainIdentifier}:`, error);
+            return false;
+        }
+    },
 };
 export const schedules = {
     /**