@positronic/spec 0.0.52 → 0.0.54

package/dist/api.d.ts

@@ -113,29 +113,29 @@ export declare const brains: {
      */
     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.
+     * Test that agent steps emit proper AGENT_* events in the SSE stream.
+     * Requires a brain with an agent 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)
+     * - AGENT_START (with prompt and optional system)
+     * - AGENT_ITERATION
+     * - AGENT_TOOL_CALL
+     * - AGENT_WEBHOOK (before WEBHOOK event)
      * - WEBHOOK
      */
-    watchLoopEvents(fetch: Fetch, loopBrainIdentifier: string): Promise<boolean>;
+    watchAgentEvents(fetch: Fetch, agentBrainIdentifier: string): Promise<boolean>;
     /**
-     * Test full loop webhook resumption flow:
-     * 1. Start a loop brain that will pause on a webhook
+     * Test full agent webhook resumption flow:
+     * 1. Start an agent 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
+     * 4. Verify the brain resumes and emits WEBHOOK_RESPONSE and AGENT_TOOL_RESULT
      *
      * Requires:
-     * - A brain with a loop step that calls a tool returning { waitFor: webhook(...) }
+     * - A brain with an agent 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>;
+    agentWebhookResume(fetch: Fetch, agentBrainIdentifier: string, webhookSlug: string, webhookPayload: Record<string, any>): Promise<boolean>;
     /**
      * Test that inner brain COMPLETE events don't overwrite outer brain status.
      *
@@ -208,6 +208,20 @@ export declare const webhooks: {
      * Test POST /webhooks/:slug with non-existent webhook - Should return 404
      */
     notFound(fetch: Fetch, slug: string): Promise<boolean>;
+    /**
+     * Test POST /webhooks/system/ui-form - Built-in webhook for UI form submissions.
+     * This is used by pages generated via .ui() steps to submit form data.
+     *
+     * The endpoint:
+     * - Accepts form data (application/x-www-form-urlencoded or multipart/form-data)
+     * - Requires an `identifier` query parameter to match the waiting brain
+     * - Returns { received: true, action: 'resumed' | 'not_found', ... }
+     */
+    uiForm(fetch: Fetch, identifier: string, formData: Record<string, string | string[]>): Promise<boolean>;
+    /**
+     * Test POST /webhooks/system/ui-form with missing identifier - Should return 400
+     */
+    uiFormMissingIdentifier(fetch: Fetch): Promise<boolean>;
 };
 export declare const pages: {
     /**
@@ -253,5 +267,20 @@ export declare const pages: {
      */
     deletePreservesResources(fetch: Fetch): Promise<boolean>;
 };
+/**
+ * Bundle API Tests
+ *
+ * Tests for the /bundle/components.js endpoint which serves the component bundle.
+ *
+ * NOTE: These tests only verify the API endpoint behavior. The bundle build and
+ * upload process is backend-specific and must be tested separately by each
+ * backend implementation.
+ */
+export declare const bundle: {
+    /**
+     * Test GET /bundle/components.js - Serve the component bundle
+     */
+    get(fetch: Fetch): Promise<boolean>;
+};
 export {};
 //# sourceMappingURL=api.d.ts.map

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

@@ -1048,23 +1048,23 @@ export const brains = {
         }
     },
     /**
-     * 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.
+     * Test that agent steps emit proper AGENT_* events in the SSE stream.
+     * Requires a brain with an agent 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)
+     * - AGENT_START (with prompt and optional system)
+     * - AGENT_ITERATION
+     * - AGENT_TOOL_CALL
+     * - AGENT_WEBHOOK (before WEBHOOK event)
      * - WEBHOOK
      */
-    async watchLoopEvents(fetch, loopBrainIdentifier) {
+    async watchAgentEvents(fetch, agentBrainIdentifier) {
         try {
-            // Start the loop brain
+            // Start the agent brain
             const runRequest = new Request('http://example.com/brains/runs', {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ identifier: loopBrainIdentifier }),
+                body: JSON.stringify({ identifier: agentBrainIdentifier }),
             });
             const runResponse = await fetch(runRequest);
             if (runResponse.status !== 201) {
@@ -1120,72 +1120,72 @@ export const brains = {
                     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');
+            // Verify required agent events are present
+            const hasAgentStart = events.some((e) => e.type === BRAIN_EVENTS.AGENT_START);
+            if (!hasAgentStart) {
+                console.error('Missing AGENT_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');
+            // Verify AGENT_START has prompt field
+            const agentStartEvent = events.find((e) => e.type === BRAIN_EVENTS.AGENT_START);
+            if (!agentStartEvent.prompt || typeof agentStartEvent.prompt !== 'string') {
+                console.error('AGENT_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');
+            const hasAgentIteration = events.some((e) => e.type === BRAIN_EVENTS.AGENT_ITERATION);
+            if (!hasAgentIteration) {
+                console.error('Missing AGENT_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');
+            const hasAgentToolCall = events.some((e) => e.type === BRAIN_EVENTS.AGENT_TOOL_CALL);
+            if (!hasAgentToolCall) {
+                console.error('Missing AGENT_TOOL_CALL event in SSE stream');
                 return false;
             }
-            // If we got a WEBHOOK event, verify LOOP_WEBHOOK came before it
+            // If we got a WEBHOOK event, verify AGENT_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');
+                const agentWebhookIndex = events.findIndex((e) => e.type === BRAIN_EVENTS.AGENT_WEBHOOK);
+                if (agentWebhookIndex === -1) {
+                    console.error('Missing AGENT_WEBHOOK event before WEBHOOK event');
                     return false;
                 }
-                if (loopWebhookIndex >= webhookIndex) {
-                    console.error('LOOP_WEBHOOK event must come before WEBHOOK event');
+                if (agentWebhookIndex >= webhookIndex) {
+                    console.error('AGENT_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');
+                // Verify AGENT_WEBHOOK has required fields
+                const agentWebhookEvent = events[agentWebhookIndex];
+                if (!agentWebhookEvent.toolCallId || !agentWebhookEvent.toolName) {
+                    console.error('AGENT_WEBHOOK event missing toolCallId or toolName fields');
                     return false;
                 }
             }
             return true;
         }
         catch (error) {
-            console.error(`Failed to test loop events for ${loopBrainIdentifier}:`, error);
+            console.error(`Failed to test agent events for ${agentBrainIdentifier}:`, error);
             return false;
         }
     },
     /**
-     * Test full loop webhook resumption flow:
-     * 1. Start a loop brain that will pause on a webhook
+     * Test full agent webhook resumption flow:
+     * 1. Start an agent 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
+     * 4. Verify the brain resumes and emits WEBHOOK_RESPONSE and AGENT_TOOL_RESULT
      *
      * Requires:
-     * - A brain with a loop step that calls a tool returning { waitFor: webhook(...) }
+     * - A brain with an agent step that calls a tool returning { waitFor: webhook(...) }
      * - The webhook slug and identifier to trigger
      */
-    async loopWebhookResume(fetch, loopBrainIdentifier, webhookSlug, webhookPayload) {
+    async agentWebhookResume(fetch, agentBrainIdentifier, webhookSlug, webhookPayload) {
         try {
-            // Step 1: Start the loop brain
+            // Step 1: Start the agent brain
             const runRequest = new Request('http://example.com/brains/runs', {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ identifier: loopBrainIdentifier }),
+                body: JSON.stringify({ identifier: agentBrainIdentifier }),
             });
             const runResponse = await fetch(runRequest);
             if (runResponse.status !== 201) {
@@ -1313,10 +1313,10 @@ export const brains = {
                 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');
+            // Verify AGENT_TOOL_RESULT event is present (with the webhook response as result)
+            const hasAgentToolResult = resumeEvents.some((e) => e.type === BRAIN_EVENTS.AGENT_TOOL_RESULT);
+            if (!hasAgentToolResult) {
+                console.error('Missing AGENT_TOOL_RESULT event after resume');
                 return false;
             }
             // Verify brain completed successfully
@@ -1332,7 +1332,7 @@ export const brains = {
             return true;
         }
         catch (error) {
-            console.error(`Failed to test loop webhook resume for ${loopBrainIdentifier}:`, error);
+            console.error(`Failed to test agent webhook resume for ${agentBrainIdentifier}:`, error);
             return false;
         }
     },
@@ -1974,6 +1974,97 @@ export const webhooks = {
             return false;
         }
     },
+    /**
+     * Test POST /webhooks/system/ui-form - Built-in webhook for UI form submissions.
+     * This is used by pages generated via .ui() steps to submit form data.
+     *
+     * The endpoint:
+     * - Accepts form data (application/x-www-form-urlencoded or multipart/form-data)
+     * - Requires an `identifier` query parameter to match the waiting brain
+     * - Returns { received: true, action: 'resumed' | 'not_found', ... }
+     */
+    async uiForm(fetch, identifier, formData) {
+        try {
+            // Build URLSearchParams from form data
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(formData)) {
+                if (Array.isArray(value)) {
+                    for (const v of value) {
+                        params.append(`${key}[]`, v);
+                    }
+                }
+                else {
+                    params.append(key, value);
+                }
+            }
+            const request = new Request(`http://example.com/webhooks/system/ui-form?identifier=${encodeURIComponent(identifier)}`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body: params.toString(),
+            });
+            const response = await fetch(request);
+            // Accept 200 (found and processed) or 404 (no brain waiting)
+            if (response.status !== 200 && response.status !== 404) {
+                console.error(`POST /webhooks/system/ui-form returned ${response.status}, expected 200 or 404`);
+                return false;
+            }
+            const data = (await response.json());
+            // Validate response structure
+            if (typeof data.received !== 'boolean') {
+                console.error(`Expected received to be boolean, got ${typeof data.received}`);
+                return false;
+            }
+            if (!data.action || typeof data.action !== 'string') {
+                console.error(`Expected action to be string, got ${typeof data.action}`);
+                return false;
+            }
+            // Action should be 'resumed' or 'not_found'
+            if (data.action !== 'resumed' && data.action !== 'not_found') {
+                console.error(`Expected action to be 'resumed' or 'not_found', got '${data.action}'`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('Failed to test POST /webhooks/system/ui-form:', error);
+            return false;
+        }
+    },
+    /**
+     * Test POST /webhooks/system/ui-form with missing identifier - Should return 400
+     */
+    async uiFormMissingIdentifier(fetch) {
+        try {
+            const request = new Request('http://example.com/webhooks/system/ui-form', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body: 'test=data',
+            });
+            const response = await fetch(request);
+            if (response.status !== 400) {
+                console.error(`POST /webhooks/system/ui-form without identifier returned ${response.status}, expected 400`);
+                return false;
+            }
+            const data = (await response.json());
+            if (!data.error || typeof data.error !== 'string') {
+                console.error(`Expected error to be string, got ${typeof data.error}`);
+                return false;
+            }
+            if (!data.error.toLowerCase().includes('identifier')) {
+                console.error(`Expected error message to mention identifier, got: ${data.error}`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('Failed to test POST /webhooks/system/ui-form without identifier:', error);
+            return false;
+        }
+    },
 };
 export const pages = {
     /**
@@ -2306,4 +2397,59 @@ export const pages = {
         }
     },
 };
+/**
+ * Bundle API Tests
+ *
+ * Tests for the /bundle/components.js endpoint which serves the component bundle.
+ *
+ * NOTE: These tests only verify the API endpoint behavior. The bundle build and
+ * upload process is backend-specific and must be tested separately by each
+ * backend implementation.
+ */
+export const bundle = {
+    /**
+     * Test GET /bundle/components.js - Serve the component bundle
+     */
+    async get(fetch) {
+        try {
+            const request = new Request('http://example.com/bundle/components.js', {
+                method: 'GET',
+            });
+            const response = await fetch(request);
+            // Bundle may or may not exist depending on project setup
+            // 200 = bundle exists and served correctly
+            // 404 = bundle not found (expected if no components/ directory)
+            if (response.status !== 200 && response.status !== 404) {
+                console.error(`GET /bundle/components.js returned unexpected status ${response.status}`);
+                return false;
+            }
+            const contentType = response.headers.get('Content-Type');
+            if (!contentType || !contentType.includes('application/javascript')) {
+                console.error(`Expected Content-Type application/javascript, got ${contentType}`);
+                return false;
+            }
+            // If 200, verify we got some content
+            if (response.status === 200) {
+                const content = await response.text();
+                if (!content || content.length === 0) {
+                    console.error('Bundle endpoint returned 200 but empty content');
+                    return false;
+                }
+            }
+            // If 404, verify we got the helpful error message
+            if (response.status === 404) {
+                const content = await response.text();
+                if (!content.includes('Bundle not found')) {
+                    console.error('Bundle 404 response missing helpful error message');
+                    return false;
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            console.error(`Failed to test GET /bundle/components.js:`, error);
+            return false;
+        }
+    },
+};
 //# sourceMappingURL=api.js.map