Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.
JavaScript agent-collaborationagent-harnessagent-orchestrationagent-teamagent-workflowai-assistantai-automationai-employeeai-productivityai-teamai-workflowautonomous-agentsclaude-code-guiclaude-coworkdesktop-agentlocal-firstmulti-agentmulti-agent-systemself-evolving-agentstask-automation
'use strict';
const { AsyncLocalStorage } = require('node:async_hooks');
const requestSignal = new AsyncLocalStorage();
function withRequestSignal(signal, operation) {
return requestSignal.run(signal, operation);
}
// Diagnose at the IO boundary before privacy wrappers replace the exception.
// A user-supplied cancellation reason is never a diagnostic string.
function requestFailureCode(error, deadline) {
if (requestSignal.getStore()?.aborted) return 'E_TOOL_CALL_CANCELLED';
if (deadline?.aborted || error?.name === 'TimeoutError') return 'E_TOOL_CALL_TIMEOUT';
if (error?.name === 'AbortError') return 'E_TOOL_CALL_CANCELLED';
return 'E_TOOL_CALL_NETWORK';
}
function httpFailureCode(status) {
if (status === 401 || status === 403) return 'E_TOOL_CALL_AUTH';
if (status === 429) return 'E_TOOL_CALL_RATE_LIMIT';
if (status === 408 || status === 504) return 'E_TOOL_CALL_TIMEOUT';
if (status >= 400 && status < 500) return 'E_BAD_INPUT';
return 'E_TOOL_CALL_UPSTREAM';
}
function tokenExpiryMs(value, fallbackSeconds) {
if (value !== undefined && typeof value !== 'number' && typeof value !== 'string') {
throw Object.assign(new Error('The platform returned an invalid token expiry'), { code: 'E_TOOL_CALL_UPSTREAM' });
}
const seconds = value === undefined ? fallbackSeconds : Number(value);
const expiry = Date.now() + seconds * 1000;
if (!Number.isSafeInteger(seconds) || seconds <= 0 || !Number.isSafeInteger(expiry)) {
throw Object.assign(new Error('The platform returned an invalid token expiry'), { code: 'E_TOOL_CALL_UPSTREAM' });
}
return expiry;
}
function httpFailure(status, message) {
return Object.assign(new Error(message), { code: httpFailureCode(status), httpStatus: status });
}
function credentialOperation(operation) {
return async (...args) => {
requestSignal.getStore()?.throwIfAborted();
// A rotating grant can serve other requests and must reach durable storage
// once started. Keep its existing provider timeout; each waiting request
// checks its own cancellation again before issuing any business request.
return requestSignal.run(undefined, () => operation(...args));
};
}
// Keep cancellation scoped to one MCP request across token acquisition and the
// provider-specific helpers. Standalone authorization calls retain their timeout.
function requestFetch(url, init = {}, fetchImpl = globalThis.fetch) {
const ownerSignal = requestSignal.getStore();
ownerSignal?.throwIfAborted();
const signal = ownerSignal
? AbortSignal.any([ownerSignal, ...(init.signal ? [init.signal] : [])])
: init.signal;
return fetchImpl(url, { ...init, signal });
}
module.exports = { withRequestSignal, credentialOperation, requestFetch, requestFailureCode, httpFailureCode,
httpFailure, tokenExpiryMs };