@positronic/spec 0.0.56 → 0.0.57

package/dist/src/api/signals.js

@@ -0,0 +1,778 @@
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+export var signals = {
+    pause: /**
+   * Test POST /brains/runs/:runId/signals - Queue PAUSE signal
+   * Expects 202 Accepted with signal confirmation
+   */ function pause(fetch, runId) {
+        return _async_to_generator(function() {
+            var _data_signal, request, response, data, _data_signal1, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/signals"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify({
+                                type: 'PAUSE'
+                            })
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 202) {
+                            console.error("POST /brains/runs/".concat(runId, "/signals returned ").concat(response.status, ", expected 202"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (!data.success) {
+                            console.error("Expected success: true, got ".concat(JSON.stringify(data)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (((_data_signal = data.signal) === null || _data_signal === void 0 ? void 0 : _data_signal.type) !== 'PAUSE') {
+                            ;
+                            console.error("Expected signal.type to be 'PAUSE', got '".concat((_data_signal1 = data.signal) === null || _data_signal1 === void 0 ? void 0 : _data_signal1.type, "'"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/signals (PAUSE):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    kill: /**
+   * Test POST /brains/runs/:runId/signals - Queue KILL signal
+   * Expects 202 Accepted with signal confirmation
+   */ function kill(fetch, runId) {
+        return _async_to_generator(function() {
+            var _data_signal, request, response, data, _data_signal1, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/signals"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify({
+                                type: 'KILL'
+                            })
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 202) {
+                            console.error("POST /brains/runs/".concat(runId, "/signals returned ").concat(response.status, ", expected 202"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (!data.success) {
+                            console.error("Expected success: true, got ".concat(JSON.stringify(data)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (((_data_signal = data.signal) === null || _data_signal === void 0 ? void 0 : _data_signal.type) !== 'KILL') {
+                            ;
+                            console.error("Expected signal.type to be 'KILL', got '".concat((_data_signal1 = data.signal) === null || _data_signal1 === void 0 ? void 0 : _data_signal1.type, "'"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/signals (KILL):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    sendMessage: /**
+   * Test POST /brains/runs/:runId/signals - Queue USER_MESSAGE signal
+   * Expects 202 Accepted with signal confirmation
+   */ function sendMessage(fetch, runId, content) {
+        return _async_to_generator(function() {
+            var _data_signal, request, response, data, _data_signal1, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/signals"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify({
+                                type: 'USER_MESSAGE',
+                                content: content
+                            })
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 202) {
+                            console.error("POST /brains/runs/".concat(runId, "/signals returned ").concat(response.status, ", expected 202"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (!data.success) {
+                            console.error("Expected success: true, got ".concat(JSON.stringify(data)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (((_data_signal = data.signal) === null || _data_signal === void 0 ? void 0 : _data_signal.type) !== 'USER_MESSAGE') {
+                            ;
+                            console.error("Expected signal.type to be 'USER_MESSAGE', got '".concat((_data_signal1 = data.signal) === null || _data_signal1 === void 0 ? void 0 : _data_signal1.type, "'"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/signals (USER_MESSAGE):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    sendMessageNoAgent: /**
+   * Test POST /brains/runs/:runId/signals - USER_MESSAGE without active agent
+   * Expects 409 Conflict when no agent step is currently active
+   */ function sendMessageNoAgent(fetch, runId) {
+        return _async_to_generator(function() {
+            var request, response, data, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/signals"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify({
+                                type: 'USER_MESSAGE',
+                                content: 'test message'
+                            })
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 409) {
+                            console.error("POST /brains/runs/".concat(runId, "/signals returned ").concat(response.status, ", expected 409"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (!data.error) {
+                            console.error("Expected error message in response, got ".concat(JSON.stringify(data)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/signals (USER_MESSAGE no agent):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    resumeSignal: /**
+   * Test POST /brains/runs/:runId/signals - Queue RESUME signal
+   * Expects 202 Accepted with signal confirmation
+   * Note: This is an alternative to POST /brains/runs/:runId/resume
+   * The brain must be in PAUSED state for RESUME signal to be valid
+   */ function resumeSignal(fetch, runId) {
+        return _async_to_generator(function() {
+            var _data_signal, request, response, data, _data_signal1, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/signals"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify({
+                                type: 'RESUME'
+                            })
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 202) {
+                            console.error("POST /brains/runs/".concat(runId, "/signals returned ").concat(response.status, ", expected 202"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (!data.success) {
+                            console.error("Expected success: true, got ".concat(JSON.stringify(data)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (((_data_signal = data.signal) === null || _data_signal === void 0 ? void 0 : _data_signal.type) !== 'RESUME') {
+                            ;
+                            console.error("Expected signal.type to be 'RESUME', got '".concat((_data_signal1 = data.signal) === null || _data_signal1 === void 0 ? void 0 : _data_signal1.type, "'"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/signals (RESUME):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    webhookResponse: /**
+   * Test POST /brains/runs/:runId/signals - Queue WEBHOOK_RESPONSE signal
+   * Expects 202 Accepted with signal confirmation
+   * Note: This is an alternative to sending webhooks via POST /webhooks/:slug
+   * The brain must be in WAITING state for WEBHOOK_RESPONSE signal to be valid
+   */ function webhookResponse(fetch, runId, response) {
+        return _async_to_generator(function() {
+            var _data_signal, request, fetchResponse, data, _data_signal1, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/signals"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify({
+                                type: 'WEBHOOK_RESPONSE',
+                                response: response
+                            })
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        fetchResponse = _state.sent();
+                        if (fetchResponse.status !== 202) {
+                            console.error("POST /brains/runs/".concat(runId, "/signals returned ").concat(fetchResponse.status, ", expected 202"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            fetchResponse.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (!data.success) {
+                            console.error("Expected success: true, got ".concat(JSON.stringify(data)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (((_data_signal = data.signal) === null || _data_signal === void 0 ? void 0 : _data_signal.type) !== 'WEBHOOK_RESPONSE') {
+                            ;
+                            console.error("Expected signal.type to be 'WEBHOOK_RESPONSE', got '".concat((_data_signal1 = data.signal) === null || _data_signal1 === void 0 ? void 0 : _data_signal1.type, "'"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/signals (WEBHOOK_RESPONSE):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    resume: /**
+   * Test POST /brains/runs/:runId/resume - Resume a PAUSED brain
+   * Expects 202 Accepted with resumed confirmation
+   */ function resume(fetch, runId) {
+        return _async_to_generator(function() {
+            var request, response, data, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/resume"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            }
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 202) {
+                            console.error("POST /brains/runs/".concat(runId, "/resume returned ").concat(response.status, ", expected 202"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (!data.success) {
+                            console.error("Expected success: true, got ".concat(JSON.stringify(data)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (data.action !== 'resumed') {
+                            console.error("Expected action to be 'resumed', got '".concat(data.action, "'"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/resume:"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    resumeWrongState: /**
+   * Test POST /brains/runs/:runId/resume - Resume a non-PAUSED brain
+   * Expects 409 Conflict when brain is not in PAUSED state
+   */ function resumeWrongState(fetch, runId) {
+        return _async_to_generator(function() {
+            var request, response, data, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/resume"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            }
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 409) {
+                            console.error("POST /brains/runs/".concat(runId, "/resume returned ").concat(response.status, ", expected 409"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (!data.error) {
+                            console.error("Expected error message in response, got ".concat(JSON.stringify(data)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/resume (wrong state):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    signalNotFound: /**
+   * Test POST /brains/runs/:runId/signals - Signal to non-existent run
+   * Expects 404 Not Found
+   */ function signalNotFound(fetch, runId) {
+        return _async_to_generator(function() {
+            var request, response, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        request = new Request("http://example.com/brains/runs/".concat(encodeURIComponent(runId), "/signals"), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify({
+                                type: 'PAUSE'
+                            })
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 404) {
+                            console.error("POST /brains/runs/".concat(runId, "/signals returned ").concat(response.status, ", expected 404"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 2:
+                        error = _state.sent();
+                        console.error("Failed to test POST /brains/runs/".concat(runId, "/signals (not found):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    }
+};