@undefineds.co/xpod 0.2.45 → 0.3.1

package/dist/api/handlers/RunHandler.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRunRoutes = registerRunRoutes;
+const global_logger_factory_1 = require("global-logger-factory");
+const AuthContext_1 = require("../auth/AuthContext");
+const types_1 = require("../chatkit/types");
+const schema_1 = require("../runs/schema");
+const store_1 = require("../runs/store");
+const types_2 = require("../workspace/types");
+function registerRunRoutes(server, options) {
+    const logger = (0, global_logger_factory_1.getLoggerFor)('RunHandler');
+    const { runStore } = options;
+    server.get('/v1/runs', async (request, response) => {
+        try {
+            const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);
+            const runs = await runStore.listRuns(parseRunListOptions(url), buildStoreContext(request));
+            sendJson(response, 200, { runs });
+        }
+        catch (error) {
+            logger.error(`Failed to list runs: ${error}`);
+            sendJson(response, 400, { error: formatError(error) });
+        }
+    });
+    server.get('/v1/runs/:runId', async (request, response, params) => {
+        try {
+            const run = await runStore.loadRun(decodeURIComponent(params.runId), buildStoreContext(request));
+            sendJson(response, 200, { run });
+        }
+        catch (error) {
+            logger.error(`Failed to load run: ${error}`);
+            sendJson(response, 404, { error: formatError(error) });
+        }
+    });
+    server.get('/v1/runs/:runId/steps', async (request, response, params) => {
+        try {
+            const steps = await runStore.loadRunSteps(decodeURIComponent(params.runId), buildStoreContext(request));
+            sendJson(response, 200, { steps });
+        }
+        catch (error) {
+            logger.error(`Failed to load run steps: ${error}`);
+            sendJson(response, 404, { error: formatError(error) });
+        }
+    });
+    server.post('/v1/runs/:runId/cancel', async (request, response, params) => {
+        try {
+            const context = buildStoreContext(request);
+            const run = await runStore.loadRun(decodeURIComponent(params.runId), context);
+            const now = (0, types_1.nowTimestamp)();
+            run.cancelRequestedAt = run.cancelRequestedAt ?? now;
+            run.updatedAt = now;
+            if (run.status === schema_1.RunStatus.QUEUED) {
+                run.status = schema_1.RunStatus.CANCELLED;
+                run.completedAt = now;
+                run.leaseOwner = undefined;
+                run.leaseExpiresAt = undefined;
+            }
+            await runStore.saveRun(run, context);
+            await runStore.appendRunStep({
+                id: (0, store_1.generateRunStepResourceId)({
+                    key: (0, types_1.generateId)('run-step'),
+                    runId: run.id,
+                    commandKind: run.commandKind,
+                    surfaceId: run.surfaceId,
+                    createdAt: now,
+                }),
+                commandKind: run.commandKind,
+                surfaceId: run.surfaceId,
+                runId: run.id,
+                run: resolveRunUri(run, context),
+                type: schema_1.RunStepType.CANCEL_REQUESTED,
+                message: 'Run cancellation requested',
+                data: { status: run.status },
+                createdAt: now,
+            }, context);
+            sendJson(response, 200, { run });
+        }
+        catch (error) {
+            logger.error(`Failed to cancel run: ${error}`);
+            sendJson(response, 404, { error: formatError(error) });
+        }
+    });
+}
+function parseRunListOptions(url) {
+    const workspace = url.searchParams.get('workspace') ?? undefined;
+    if (workspace && !(0, types_2.isWorkspaceUri)(workspace)) {
+        throw new Error('workspace must be a URI');
+    }
+    return {
+        task: url.searchParams.get('task') ?? undefined,
+        thread: url.searchParams.get('thread') ?? undefined,
+        workspace,
+        commandKind: parseCommandKind(url.searchParams.get('commandKind')),
+        status: parseRunStatus(url.searchParams.get('status')),
+        limit: parseOptionalNumber(url.searchParams.get('limit')),
+    };
+}
+function parseCommandKind(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (value === 'chat' || value === 'task') {
+        return value;
+    }
+    throw new Error('commandKind must be chat or task');
+}
+function parseRunStatus(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (value === schema_1.RunStatus.QUEUED
+        || value === schema_1.RunStatus.RUNNING
+        || value === schema_1.RunStatus.WAITING_INPUT
+        || value === schema_1.RunStatus.WAITING_RUNNER
+        || value === schema_1.RunStatus.COMPLETED
+        || value === schema_1.RunStatus.FAILED
+        || value === schema_1.RunStatus.CANCELLED) {
+        return value;
+    }
+    throw new Error(`Unknown run status: ${value}`);
+}
+function parseOptionalNumber(value) {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+function buildStoreContext(request) {
+    const auth = request.auth;
+    const userId = auth ? (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous' : 'anonymous';
+    return {
+        userId,
+        auth,
+    };
+}
+function resolveRunUri(run, context) {
+    const auth = context.auth;
+    const webId = typeof auth?.webId === 'string' ? auth.webId : undefined;
+    const podBaseUrl = webId ? resolvePodBaseUrl(webId) : undefined;
+    if (podBaseUrl) {
+        return (0, store_1.resolveDataResourceIri)(podBaseUrl, run.id);
+    }
+    return (0, store_1.resolveRunUrn)(run.id);
+}
+function resolvePodBaseUrl(webId) {
+    try {
+        const url = new URL(webId);
+        url.hash = '';
+        url.search = '';
+        const normalizedPath = url.pathname.replace(/\/+$/, '');
+        if (!normalizedPath.endsWith('/profile/card')) {
+            return undefined;
+        }
+        url.pathname = normalizedPath.slice(0, -'/profile/card'.length) || '/';
+        return url.toString().replace(/\/$/, '');
+    }
+    catch {
+        return undefined;
+    }
+}
+function sendJson(response, status, data) {
+    response.statusCode = status;
+    response.setHeader('Content-Type', 'application/json');
+    response.end(JSON.stringify(data));
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=RunHandler.js.map

package/dist/api/handlers/RunHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/RunHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ServerResponse } from 'node:http';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { ApiServer } from '../ApiServer';\nimport { getAccountId, getWebId } from '../auth/AuthContext';\nimport { generateId, nowTimestamp } from '../chatkit/types';\nimport type { StoreContext } from '../chatkit/store';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport { RunStatus, RunStepType, type RunStatusType } from '../runs/schema';\nimport {\n  generateRunStepResourceId,\n  resolveDataResourceIri,\n  resolveRunUrn,\n  type RunListOptions,\n  type RunRecordData,\n  type RunStore,\n} from '../runs/store';\nimport { isWorkspaceUri } from '../workspace/types';\n\nexport interface RunHandlerOptions {\n  runStore: RunStore<StoreContext>;\n}\n\nexport function registerRunRoutes(server: ApiServer, options: RunHandlerOptions): void {\n  const logger = getLoggerFor('RunHandler');\n  const { runStore } = options;\n\n  server.get('/v1/runs', async (request, response) => {\n    try {\n      const url = new URL(request.url ?? '', `http://${request.headers.host ?? 'localhost'}`);\n      const runs = await runStore.listRuns(parseRunListOptions(url), buildStoreContext(request));\n      sendJson(response, 200, { runs });\n    } catch (error) {\n      logger.error(`Failed to list runs: ${error}`);\n      sendJson(response, 400, { error: formatError(error) });\n    }\n  });\n\n  server.get('/v1/runs/:runId', async (request, response, params) => {\n    try {\n      const run = await runStore.loadRun(decodeURIComponent(params.runId), buildStoreContext(request));\n      sendJson(response, 200, { run });\n    } catch (error) {\n      logger.error(`Failed to load run: ${error}`);\n      sendJson(response, 404, { error: formatError(error) });\n    }\n  });\n\n  server.get('/v1/runs/:runId/steps', async (request, response, params) => {\n    try {\n      const steps = await runStore.loadRunSteps(decodeURIComponent(params.runId), buildStoreContext(request));\n      sendJson(response, 200, { steps });\n    } catch (error) {\n      logger.error(`Failed to load run steps: ${error}`);\n      sendJson(response, 404, { error: formatError(error) });\n    }\n  });\n\n  server.post('/v1/runs/:runId/cancel', async (request, response, params) => {\n    try {\n      const context = buildStoreContext(request);\n      const run = await runStore.loadRun(decodeURIComponent(params.runId), context);\n      const now = nowTimestamp();\n      run.cancelRequestedAt = run.cancelRequestedAt ?? now;\n      run.updatedAt = now;\n\n      if (run.status === RunStatus.QUEUED) {\n        run.status = RunStatus.CANCELLED;\n        run.completedAt = now;\n        run.leaseOwner = undefined;\n        run.leaseExpiresAt = undefined;\n      }\n\n      await runStore.saveRun(run, context);\n      await runStore.appendRunStep({\n        id: generateRunStepResourceId({\n          key: generateId('run-step'),\n          runId: run.id,\n          commandKind: run.commandKind,\n          surfaceId: run.surfaceId,\n          createdAt: now,\n        }),\n        commandKind: run.commandKind,\n        surfaceId: run.surfaceId,\n        runId: run.id,\n        run: resolveRunUri(run, context),\n        type: RunStepType.CANCEL_REQUESTED,\n        message: 'Run cancellation requested',\n        data: { status: run.status },\n        createdAt: now,\n      }, context);\n\n      sendJson(response, 200, { run });\n    } catch (error) {\n      logger.error(`Failed to cancel run: ${error}`);\n      sendJson(response, 404, { error: formatError(error) });\n    }\n  });\n}\n\nfunction parseRunListOptions(url: URL): RunListOptions {\n  const workspace = url.searchParams.get('workspace') ?? undefined;\n  if (workspace && !isWorkspaceUri(workspace)) {\n    throw new Error('workspace must be a URI');\n  }\n\n  return {\n    task: url.searchParams.get('task') ?? undefined,\n    thread: url.searchParams.get('thread') ?? undefined,\n    workspace,\n    commandKind: parseCommandKind(url.searchParams.get('commandKind')),\n    status: parseRunStatus(url.searchParams.get('status')),\n    limit: parseOptionalNumber(url.searchParams.get('limit')),\n  };\n}\n\nfunction parseCommandKind(value: string | null): RunListOptions['commandKind'] {\n  if (!value) {\n    return undefined;\n  }\n  if (value === 'chat' || value === 'task') {\n    return value;\n  }\n  throw new Error('commandKind must be chat or task');\n}\n\nfunction parseRunStatus(value: string | null): RunStatusType | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (\n    value === RunStatus.QUEUED\n    || value === RunStatus.RUNNING\n    || value === RunStatus.WAITING_INPUT\n    || value === RunStatus.WAITING_RUNNER\n    || value === RunStatus.COMPLETED\n    || value === RunStatus.FAILED\n    || value === RunStatus.CANCELLED\n  ) {\n    return value;\n  }\n  throw new Error(`Unknown run status: ${value}`);\n}\n\nfunction parseOptionalNumber(value: string | null): number | undefined {\n  if (!value) {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;\n}\n\nfunction buildStoreContext(request: AuthenticatedRequest): StoreContext {\n  const auth = request.auth;\n  const userId = auth ? getWebId(auth) ?? getAccountId(auth) ?? 'anonymous' : 'anonymous';\n  return {\n    userId,\n    auth,\n  };\n}\n\nfunction resolveRunUri(run: RunRecordData, context: StoreContext): string {\n  const auth = context.auth as { webId?: unknown } | undefined;\n  const webId = typeof auth?.webId === 'string' ? auth.webId : undefined;\n  const podBaseUrl = webId ? resolvePodBaseUrl(webId) : undefined;\n  if (podBaseUrl) {\n    return resolveDataResourceIri(podBaseUrl, run.id);\n  }\n  return resolveRunUrn(run.id);\n}\n\nfunction resolvePodBaseUrl(webId: string): string | undefined {\n  try {\n    const url = new URL(webId);\n    url.hash = '';\n    url.search = '';\n    const normalizedPath = url.pathname.replace(/\\/+$/, '');\n    if (!normalizedPath.endsWith('/profile/card')) {\n      return undefined;\n    }\n    url.pathname = normalizedPath.slice(0, -'/profile/card'.length) || '/';\n    return url.toString().replace(/\\/$/, '');\n  } catch {\n    return undefined;\n  }\n}\n\nfunction sendJson(response: ServerResponse, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n\nfunction formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}

package/dist/api/handlers/index.d.ts

@@ -9,5 +9,6 @@ export * from './ApiKeyHandler';
 export * from './SubdomainHandler';
 export * from './SubdomainClientHandler';
 export * from './ChatKitHandler';
+export * from './RunHandler';
 export * from './ProvisionHandler';
 export * from './PodManagementHandler';

package/dist/api/handlers/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./ApiKeyHandler"), exports);
 __exportStar(require("./SubdomainHandler"), exports);
 __exportStar(require("./SubdomainClientHandler"), exports);
 __exportStar(require("./ChatKitHandler"), exports);
+__exportStar(require("./RunHandler"), exports);
 __exportStar(require("./ProvisionHandler"), exports);
 __exportStar(require("./PodManagementHandler"), exports);
 //# sourceMappingURL=index.js.map

package/dist/api/handlers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/handlers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,iDAA+B;AAC/B,gDAA8B;AAC9B,gDAA8B;AAC9B,kDAAgC;AAChC,uDAAqC;AACrC,8DAA4C;AAC5C,kDAAgC;AAChC,qDAAmC;AACnC,2DAAyC;AACzC,mDAAiC;AACjC,qDAAmC;AACnC,yDAAuC","sourcesContent":["export * from './EdgeNodeSignalHandler';\nexport * from './QuotaHandler';\nexport * from './NodeHandler';\nexport * from './ChatHandler';\nexport * from './VectorHandler';\nexport * from './VectorStoreHandler';\nexport * from './VectorStoreWebhookHandler';\nexport * from './ApiKeyHandler';\nexport * from './SubdomainHandler';\nexport * from './SubdomainClientHandler';\nexport * from './ChatKitHandler';\nexport * from './ProvisionHandler';\nexport * from './PodManagementHandler';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/handlers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,iDAA+B;AAC/B,gDAA8B;AAC9B,gDAA8B;AAC9B,kDAAgC;AAChC,uDAAqC;AACrC,8DAA4C;AAC5C,kDAAgC;AAChC,qDAAmC;AACnC,2DAAyC;AACzC,mDAAiC;AACjC,+CAA6B;AAC7B,qDAAmC;AACnC,yDAAuC","sourcesContent":["export * from './EdgeNodeSignalHandler';\nexport * from './QuotaHandler';\nexport * from './NodeHandler';\nexport * from './ChatHandler';\nexport * from './VectorHandler';\nexport * from './VectorStoreHandler';\nexport * from './VectorStoreWebhookHandler';\nexport * from './ApiKeyHandler';\nexport * from './SubdomainHandler';\nexport * from './SubdomainClientHandler';\nexport * from './ChatKitHandler';\nexport * from './RunHandler';\nexport * from './ProvisionHandler';\nexport * from './PodManagementHandler';\n"]}

package/dist/api/models/namespaces.d.ts

@@ -1,2 +1,2 @@
-import { ACL, AS, DCTerms, FOAF, LINQ, LINX_CHAT, LINX_MSG, LDP, MEETING, ODRL, OWL, RDF, RDFS, SCHEMA, SIOC, UDFS, UDFS_NAMESPACE, VCARD, WF } from '@undefineds.co/models';
-export { ACL, AS, DCTerms, FOAF, LINQ, LINX_CHAT, LINX_MSG, LDP, MEETING, ODRL, OWL, RDF, RDFS, SCHEMA, SIOC, UDFS, UDFS_NAMESPACE, VCARD, WF, };
+import { ACL, AS, DCTerms, FOAF, LDP, MEETING, ODRL, OWL, RDF, RDFS, SCHEMA, SIOC, UDFS, UDFS_NAMESPACE, VCARD, WF } from '@undefineds.co/models';
+export { ACL, AS, DCTerms, FOAF, LDP, MEETING, ODRL, OWL, RDF, RDFS, SCHEMA, SIOC, UDFS, UDFS_NAMESPACE, VCARD, WF, };

package/dist/api/models/namespaces.js

@@ -1,14 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WF = exports.VCARD = exports.UDFS_NAMESPACE = exports.UDFS = exports.SIOC = exports.SCHEMA = exports.RDFS = exports.RDF = exports.OWL = exports.ODRL = exports.MEETING = exports.LDP = exports.LINX_MSG = exports.LINX_CHAT = exports.LINQ = exports.FOAF = exports.DCTerms = exports.AS = exports.ACL = void 0;
+exports.WF = exports.VCARD = exports.UDFS_NAMESPACE = exports.UDFS = exports.SIOC = exports.SCHEMA = exports.RDFS = exports.RDF = exports.OWL = exports.ODRL = exports.MEETING = exports.LDP = exports.FOAF = exports.DCTerms = exports.AS = exports.ACL = void 0;
 const models_1 = require("@undefineds.co/models");
 Object.defineProperty(exports, "ACL", { enumerable: true, get: function () { return models_1.ACL; } });
 Object.defineProperty(exports, "AS", { enumerable: true, get: function () { return models_1.AS; } });
 Object.defineProperty(exports, "DCTerms", { enumerable: true, get: function () { return models_1.DCTerms; } });
 Object.defineProperty(exports, "FOAF", { enumerable: true, get: function () { return models_1.FOAF; } });
-Object.defineProperty(exports, "LINQ", { enumerable: true, get: function () { return models_1.LINQ; } });
-Object.defineProperty(exports, "LINX_CHAT", { enumerable: true, get: function () { return models_1.LINX_CHAT; } });
-Object.defineProperty(exports, "LINX_MSG", { enumerable: true, get: function () { return models_1.LINX_MSG; } });
 Object.defineProperty(exports, "LDP", { enumerable: true, get: function () { return models_1.LDP; } });
 Object.defineProperty(exports, "MEETING", { enumerable: true, get: function () { return models_1.MEETING; } });
 Object.defineProperty(exports, "ODRL", { enumerable: true, get: function () { return models_1.ODRL; } });

package/dist/api/models/namespaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../../../src/api/models/namespaces.ts"],"names":[],"mappings":";;;AAAA,kDAoB+B;AAG7B,oFAtBA,YAAG,OAsBA;AACH,mFAtBA,WAAE,OAsBA;AACF,wFAtBA,gBAAO,OAsBA;AACP,qFAtBA,aAAI,OAsBA;AACJ,qFAtBA,aAAI,OAsBA;AACJ,0FAtBA,kBAAS,OAsBA;AACT,yFAtBA,iBAAQ,OAsBA;AACR,oFAtBA,YAAG,OAsBA;AACH,wFAtBA,gBAAO,OAsBA;AACP,qFAtBA,aAAI,OAsBA;AACJ,oFAtBA,YAAG,OAsBA;AACH,oFAtBA,YAAG,OAsBA;AACH,qFAtBA,aAAI,OAsBA;AACJ,uFAtBA,eAAM,OAsBA;AACN,qFAtBA,aAAI,OAsBA;AACJ,qFAtBA,aAAI,OAsBA;AACJ,+FAtBA,uBAAc,OAsBA;AACd,sFAtBA,cAAK,OAsBA;AACL,mFAtBA,WAAE,OAsBA","sourcesContent":["import {\n  ACL,\n  AS,\n  DCTerms,\n  FOAF,\n  LINQ,\n  LINX_CHAT,\n  LINX_MSG,\n  LDP,\n  MEETING,\n  ODRL,\n  OWL,\n  RDF,\n  RDFS,\n  SCHEMA,\n  SIOC,\n  UDFS,\n  UDFS_NAMESPACE,\n  VCARD,\n  WF,\n} from '@undefineds.co/models';\n\nexport {\n  ACL,\n  AS,\n  DCTerms,\n  FOAF,\n  LINQ,\n  LINX_CHAT,\n  LINX_MSG,\n  LDP,\n  MEETING,\n  ODRL,\n  OWL,\n  RDF,\n  RDFS,\n  SCHEMA,\n  SIOC,\n  UDFS,\n  UDFS_NAMESPACE,\n  VCARD,\n  WF,\n};\n"]}
+{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../../../src/api/models/namespaces.ts"],"names":[],"mappings":";;;AAAA,kDAiB+B;AAG7B,oFAnBA,YAAG,OAmBA;AACH,mFAnBA,WAAE,OAmBA;AACF,wFAnBA,gBAAO,OAmBA;AACP,qFAnBA,aAAI,OAmBA;AACJ,oFAnBA,YAAG,OAmBA;AACH,wFAnBA,gBAAO,OAmBA;AACP,qFAnBA,aAAI,OAmBA;AACJ,oFAnBA,YAAG,OAmBA;AACH,oFAnBA,YAAG,OAmBA;AACH,qFAnBA,aAAI,OAmBA;AACJ,uFAnBA,eAAM,OAmBA;AACN,qFAnBA,aAAI,OAmBA;AACJ,qFAnBA,aAAI,OAmBA;AACJ,+FAnBA,uBAAc,OAmBA;AACd,sFAnBA,cAAK,OAmBA;AACL,mFAnBA,WAAE,OAmBA","sourcesContent":["import {\n  ACL,\n  AS,\n  DCTerms,\n  FOAF,\n  LDP,\n  MEETING,\n  ODRL,\n  OWL,\n  RDF,\n  RDFS,\n  SCHEMA,\n  SIOC,\n  UDFS,\n  UDFS_NAMESPACE,\n  VCARD,\n  WF,\n} from '@undefineds.co/models';\n\nexport {\n  ACL,\n  AS,\n  DCTerms,\n  FOAF,\n  LDP,\n  MEETING,\n  ODRL,\n  OWL,\n  RDF,\n  RDFS,\n  SCHEMA,\n  SIOC,\n  UDFS,\n  UDFS_NAMESPACE,\n  VCARD,\n  WF,\n};\n"]}

package/dist/api/runs/AgentRuntimeTypes.d.ts

@@ -0,0 +1,83 @@
+import type { ResolvedAgentConfig } from '../../agents/config/types';
+import type { WorkspaceUri } from '../workspace/types';
+export type RunnerProtocol = 'pi' | 'acp';
+export type AcpRunnerType = 'codebuddy' | 'claude' | 'codex';
+export type RunnerType = 'pi' | AcpRunnerType;
+export type WorktreeSpec = {
+    mode: 'existing';
+    path: string;
+} | {
+    mode: 'create';
+    baseRef?: string;
+    branch?: string;
+};
+/**
+ * Canonical workspace reference for a Run.
+ *
+ * This is an RDF URI reference to a workspace Container, not an execution
+ * config object. Stable workspace metadata belongs on the Container .meta
+ * resource. Runners resolve this URI into their own local cwd before starting
+ * the Agent Loop.
+ */
+export interface AgentRuntimeConfig {
+    workspace: WorkspaceUri;
+    /**
+     * Optional execution policy for git workspaces. The workspace field still
+     * points at the repo/workspace URI; this only selects the cwd used by a run.
+     */
+    worktree?: WorktreeSpec;
+    /**
+     * Stream idle cutoff for agent output. If no output arrives within this window,
+     * the current streaming response ends.
+     *
+     * Defaults to 500ms for tests; real agents may need a larger value.
+     */
+    idleMs?: number;
+    /**
+     * How long to keep the stream open after an auth_required event.
+     * Defaults to 5 minutes.
+     */
+    authWaitMs?: number;
+    runner: {
+        type: RunnerType;
+        /**
+         * pi: request-scoped pi AgentSession restored from Xpod Run/Thread/Message state.
+         * acp: protocol adapter over JSON-RPC (Agent Client Protocol) stdio runners.
+         */
+        protocol?: RunnerProtocol;
+        argv?: string[];
+        allowCustomArgv?: boolean;
+    };
+    /**
+     * Resolved agent configuration from /agents/{agentId}/AGENTS.md + .meta.
+     * When provided, credentials/model/MCP servers/system prompt come from here
+     * instead of DEFAULT_* environment variables.
+     */
+    agentConfig?: ResolvedAgentConfig;
+}
+export type AgentRuntimeEvent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'waiting_runner';
+    workspace: WorkspaceUri;
+    message: string;
+} | {
+    type: 'auth_required';
+    method: string;
+    url?: string;
+    message?: string;
+    options?: Array<{
+        label?: string;
+        url?: string;
+        method?: string;
+    }>;
+} | {
+    type: 'tool_call';
+    requestId: string;
+    name: string;
+    arguments: string;
+};

package/dist/api/runs/AgentRuntimeTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AgentRuntimeTypes.js.map

package/dist/api/runs/AgentRuntimeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeTypes.js","sourceRoot":"","sources":["../../../src/api/runs/AgentRuntimeTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { ResolvedAgentConfig } from '../../agents/config/types';\nimport type { WorkspaceUri } from '../workspace/types';\n\nexport type RunnerProtocol = 'pi' | 'acp';\nexport type AcpRunnerType = 'codebuddy' | 'claude' | 'codex';\nexport type RunnerType = 'pi' | AcpRunnerType;\n\nexport type WorktreeSpec =\n  | { mode: 'existing'; path: string }\n  | { mode: 'create'; baseRef?: string; branch?: string };\n\n/**\n * Canonical workspace reference for a Run.\n *\n * This is an RDF URI reference to a workspace Container, not an execution\n * config object. Stable workspace metadata belongs on the Container .meta\n * resource. Runners resolve this URI into their own local cwd before starting\n * the Agent Loop.\n */\nexport interface AgentRuntimeConfig {\n  workspace: WorkspaceUri;\n  /**\n   * Optional execution policy for git workspaces. The workspace field still\n   * points at the repo/workspace URI; this only selects the cwd used by a run.\n   */\n  worktree?: WorktreeSpec;\n  /**\n   * Stream idle cutoff for agent output. If no output arrives within this window,\n   * the current streaming response ends.\n   *\n   * Defaults to 500ms for tests; real agents may need a larger value.\n   */\n  idleMs?: number;\n  /**\n   * How long to keep the stream open after an auth_required event.\n   * Defaults to 5 minutes.\n   */\n  authWaitMs?: number;\n  runner: {\n    type: RunnerType;\n    /**\n     * pi: request-scoped pi AgentSession restored from Xpod Run/Thread/Message state.\n     * acp: protocol adapter over JSON-RPC (Agent Client Protocol) stdio runners.\n     */\n    protocol?: RunnerProtocol;\n    argv?: string[];\n    allowCustomArgv?: boolean;\n  };\n  /**\n   * Resolved agent configuration from /agents/{agentId}/AGENTS.md + .meta.\n   * When provided, credentials/model/MCP servers/system prompt come from here\n   * instead of DEFAULT_* environment variables.\n   */\n  agentConfig?: ResolvedAgentConfig;\n}\n\nexport type AgentRuntimeEvent =\n  | { type: 'text'; text: string }\n  | { type: 'error'; message: string }\n  | {\n    type: 'waiting_runner';\n    workspace: WorkspaceUri;\n    message: string;\n  }\n  | {\n    type: 'auth_required';\n    method: string;\n    url?: string;\n    message?: string;\n    options?: Array<{ label?: string; url?: string; method?: string }>;\n  }\n  | {\n    type: 'tool_call';\n    requestId: string;\n    name: string;\n    arguments: string;\n  };\n"]}

package/dist/api/runs/EmbeddedInngestService.d.ts

@@ -0,0 +1,47 @@
+export interface EmbeddedInngestServiceOptions {
+    edition: 'cloud' | 'local';
+    apiBaseUrl: string;
+    apiPath?: string;
+    databaseUrl: string;
+    redisUrl?: string;
+    enabled?: boolean;
+    mode?: 'managed' | 'spawn';
+    host?: string;
+    port?: number;
+    baseUrl?: string;
+    eventKey?: string;
+    signingKey?: string;
+    binaryPath?: string;
+    sqliteDir?: string;
+}
+export interface EmbeddedInngestRuntimeConfig {
+    enabled: boolean;
+    durableDelivery: boolean;
+    baseUrl: string;
+    eventKey: string;
+    signingKey: string;
+    functionEndpoint: string;
+}
+/**
+ * Xpod-owned Inngest runtime process.
+ *
+ * The JS SDK is only the client/function adapter; the durable executor is the
+ * Inngest CLI/server. In local mode Xpod may spawn that server as a managed
+ * child process. In cloud/cluster mode the deployment supplies a stable
+ * cluster-scoped Inngest URL, still owned by the Xpod deployment rather than
+ * user-provided SaaS. Xpod Run/RunStep remain the business source of truth.
+ */
+export declare class EmbeddedInngestService {
+    private readonly logger;
+    private readonly options;
+    private child?;
+    private config?;
+    constructor(options: EmbeddedInngestServiceOptions);
+    start(): Promise<EmbeddedInngestRuntimeConfig>;
+    stop(): Promise<void>;
+    private resolveUsableBinaryPath;
+    private isUsableBinary;
+    private buildArguments;
+    private buildEnvironment;
+    private isPostgresUrl;
+}

package/dist/api/runs/EmbeddedInngestService.js

@@ -0,0 +1,203 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddedInngestService = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const global_logger_factory_1 = require("global-logger-factory");
+const runtime_1 = require("../../runtime");
+/**
+ * Xpod-owned Inngest runtime process.
+ *
+ * The JS SDK is only the client/function adapter; the durable executor is the
+ * Inngest CLI/server. In local mode Xpod may spawn that server as a managed
+ * child process. In cloud/cluster mode the deployment supplies a stable
+ * cluster-scoped Inngest URL, still owned by the Xpod deployment rather than
+ * user-provided SaaS. Xpod Run/RunStep remain the business source of truth.
+ */
+class EmbeddedInngestService {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.options = options;
+    }
+    async start() {
+        if (this.config) {
+            return this.config;
+        }
+        const mode = this.options.mode ?? (this.options.edition === 'cloud' ? 'managed' : 'spawn');
+        if ((this.options.edition === 'cloud' || mode === 'managed') && (!this.options.eventKey || !this.options.signingKey)) {
+            throw new Error('Managed/cloud Inngest requires explicit eventKey and signingKey');
+        }
+        const eventKey = this.options.eventKey || 'xpod-local-event-key';
+        const signingKey = this.options.signingKey || 'signkey-test-xpod-local-signing-key';
+        const host = this.options.host || '127.0.0.1';
+        const port = this.options.port ?? (mode === 'spawn' ? await (0, runtime_1.getFreePort)(8288, host) : 8288);
+        const baseUrl = this.options.baseUrl || (mode === 'spawn' ? `http://${host}:${port}` : 'http://xpod-inngest:8288');
+        const functionEndpoint = new URL(this.options.apiPath ?? '/api/inngest', this.options.apiBaseUrl).toString();
+        this.config = {
+            enabled: this.options.enabled !== false,
+            durableDelivery: false,
+            baseUrl,
+            eventKey,
+            signingKey,
+            functionEndpoint,
+        };
+        if (this.options.enabled === false) {
+            this.logger.info('Embedded Inngest disabled by config');
+            return this.config;
+        }
+        if (mode === 'managed') {
+            this.config.durableDelivery = this.config.enabled;
+            this.logger.info(`Using managed embedded Inngest at ${baseUrl}, function endpoint ${functionEndpoint}`);
+            return this.config;
+        }
+        const binary = this.resolveUsableBinaryPath();
+        if (!binary) {
+            this.logger.warn('Embedded Inngest binary not found; Xpod will still expose the function endpoint, but durable delivery is unavailable.');
+            return this.config;
+        }
+        const env = this.buildEnvironment({
+            baseUrl,
+            eventKey,
+            signingKey,
+            functionEndpoint,
+        });
+        const args = this.buildArguments(host, port, functionEndpoint);
+        this.child = (0, node_child_process_1.spawn)(binary, args, {
+            cwd: runtime_1.PACKAGE_ROOT,
+            env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        this.child.stdout?.on('data', (chunk) => {
+            this.logger.info(`[Inngest] ${String(chunk).trim()}`);
+        });
+        this.child.stderr?.on('data', (chunk) => {
+            this.logger.warn(`[Inngest] ${String(chunk).trim()}`);
+        });
+        this.child.once('exit', (code, signal) => {
+            const message = `Embedded Inngest exited: code=${code ?? 'null'} signal=${signal ?? 'null'}`;
+            if (code && code !== 0) {
+                this.logger.error(message);
+            }
+            else {
+                this.logger.info(message);
+            }
+            this.child = undefined;
+        });
+        this.child.once('error', (error) => {
+            this.logger.error(`Failed to start embedded Inngest: ${error}`);
+            this.child = undefined;
+        });
+        this.logger.info(`Embedded Inngest starting at ${baseUrl}, function endpoint ${functionEndpoint}`);
+        this.config.durableDelivery = true;
+        return this.config;
+    }
+    async stop() {
+        const child = this.child;
+        if (!child) {
+            return;
+        }
+        this.child = undefined;
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                child.kill('SIGKILL');
+                resolve();
+            }, 5_000);
+            timer.unref?.();
+            child.once('exit', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            child.kill('SIGTERM');
+        });
+    }
+    resolveUsableBinaryPath() {
+        const configured = this.options.binaryPath;
+        if (configured) {
+            return this.isUsableBinary(configured) ? configured : undefined;
+        }
+        const candidates = [
+            path.join(runtime_1.PACKAGE_ROOT, 'node_modules', '.bin', process.platform === 'win32' ? 'inngest.cmd' : 'inngest'),
+            path.join(runtime_1.PACKAGE_ROOT, 'node_modules', 'inngest-cli', 'bin', process.platform === 'win32' ? 'inngest.exe' : 'inngest'),
+            'inngest',
+        ];
+        return candidates.find((candidate) => this.isUsableBinary(candidate));
+    }
+    isUsableBinary(candidate) {
+        const isPathLike = candidate.includes('/') || candidate.includes('\\');
+        if (isPathLike && !fs.existsSync(candidate)) {
+            return false;
+        }
+        const result = (0, node_child_process_1.spawnSync)(candidate, ['--help'], {
+            cwd: runtime_1.PACKAGE_ROOT,
+            env: process.env,
+            stdio: 'ignore',
+            timeout: 5_000,
+        });
+        return !result.error && result.status === 0;
+    }
+    buildArguments(host, port, functionEndpoint) {
+        return [
+            'dev',
+            '--no-discovery',
+            '--host',
+            host,
+            '--port',
+            String(port),
+            '-u',
+            functionEndpoint,
+        ];
+    }
+    buildEnvironment(config) {
+        const env = {
+            ...process.env,
+            INNGEST_DEV: config.baseUrl,
+            INNGEST_BASE_URL: config.baseUrl,
+            INNGEST_EVENT_API_BASE_URL: config.baseUrl,
+            INNGEST_API_BASE_URL: config.baseUrl,
+            INNGEST_EVENT_KEY: config.eventKey,
+            INNGEST_SIGNING_KEY: config.signingKey,
+        };
+        if (this.options.edition === 'cloud') {
+            if (this.isPostgresUrl(this.options.databaseUrl)) {
+                env.INNGEST_POSTGRES_URI = this.options.databaseUrl;
+            }
+            if (this.options.redisUrl) {
+                env.INNGEST_REDIS_URI = this.options.redisUrl;
+            }
+            return env;
+        }
+        const sqliteDir = this.options.sqliteDir ?? path.join(process.env.CSS_ROOT_FILE_PATH || './data', '.inngest');
+        fs.mkdirSync(sqliteDir, { recursive: true });
+        env.INNGEST_SQLITE_DIR = sqliteDir;
+        return env;
+    }
+    isPostgresUrl(value) {
+        return value.startsWith('postgres://') || value.startsWith('postgresql://');
+    }
+}
+exports.EmbeddedInngestService = EmbeddedInngestService;
+//# sourceMappingURL=EmbeddedInngestService.js.map

package/dist/api/runs/EmbeddedInngestService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddedInngestService.js","sourceRoot":"","sources":["../../../src/api/runs/EmbeddedInngestService.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { spawn, spawnSync, type ChildProcess } from 'node:child_process';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { getFreePort, PACKAGE_ROOT } from '../../runtime';\n\nexport interface EmbeddedInngestServiceOptions {\n  edition: 'cloud' | 'local';\n  apiBaseUrl: string;\n  apiPath?: string;\n  databaseUrl: string;\n  redisUrl?: string;\n  enabled?: boolean;\n  mode?: 'managed' | 'spawn';\n  host?: string;\n  port?: number;\n  baseUrl?: string;\n  eventKey?: string;\n  signingKey?: string;\n  binaryPath?: string;\n  sqliteDir?: string;\n}\n\nexport interface EmbeddedInngestRuntimeConfig {\n  enabled: boolean;\n  durableDelivery: boolean;\n  baseUrl: string;\n  eventKey: string;\n  signingKey: string;\n  functionEndpoint: string;\n}\n\n/**\n * Xpod-owned Inngest runtime process.\n *\n * The JS SDK is only the client/function adapter; the durable executor is the\n * Inngest CLI/server. In local mode Xpod may spawn that server as a managed\n * child process. In cloud/cluster mode the deployment supplies a stable\n * cluster-scoped Inngest URL, still owned by the Xpod deployment rather than\n * user-provided SaaS. Xpod Run/RunStep remain the business source of truth.\n */\nexport class EmbeddedInngestService {\n  private readonly logger = getLoggerFor(this);\n  private readonly options: EmbeddedInngestServiceOptions;\n  private child?: ChildProcess;\n  private config?: EmbeddedInngestRuntimeConfig;\n\n  public constructor(options: EmbeddedInngestServiceOptions) {\n    this.options = options;\n  }\n\n  public async start(): Promise<EmbeddedInngestRuntimeConfig> {\n    if (this.config) {\n      return this.config;\n    }\n\n    const mode = this.options.mode ?? (this.options.edition === 'cloud' ? 'managed' : 'spawn');\n    if ((this.options.edition === 'cloud' || mode === 'managed') && (!this.options.eventKey || !this.options.signingKey)) {\n      throw new Error('Managed/cloud Inngest requires explicit eventKey and signingKey');\n    }\n\n    const eventKey = this.options.eventKey || 'xpod-local-event-key';\n    const signingKey = this.options.signingKey || 'signkey-test-xpod-local-signing-key';\n    const host = this.options.host || '127.0.0.1';\n    const port = this.options.port ?? (mode === 'spawn' ? await getFreePort(8288, host) : 8288);\n    const baseUrl = this.options.baseUrl || (mode === 'spawn' ? `http://${host}:${port}` : 'http://xpod-inngest:8288');\n    const functionEndpoint = new URL(this.options.apiPath ?? '/api/inngest', this.options.apiBaseUrl).toString();\n\n    this.config = {\n      enabled: this.options.enabled !== false,\n      durableDelivery: false,\n      baseUrl,\n      eventKey,\n      signingKey,\n      functionEndpoint,\n    };\n\n    if (this.options.enabled === false) {\n      this.logger.info('Embedded Inngest disabled by config');\n      return this.config;\n    }\n\n    if (mode === 'managed') {\n      this.config.durableDelivery = this.config.enabled;\n      this.logger.info(`Using managed embedded Inngest at ${baseUrl}, function endpoint ${functionEndpoint}`);\n      return this.config;\n    }\n\n    const binary = this.resolveUsableBinaryPath();\n    if (!binary) {\n      this.logger.warn('Embedded Inngest binary not found; Xpod will still expose the function endpoint, but durable delivery is unavailable.');\n      return this.config;\n    }\n\n    const env = this.buildEnvironment({\n      baseUrl,\n      eventKey,\n      signingKey,\n      functionEndpoint,\n    });\n    const args = this.buildArguments(host, port, functionEndpoint);\n\n    this.child = spawn(binary, args, {\n      cwd: PACKAGE_ROOT,\n      env,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    this.child.stdout?.on('data', (chunk) => {\n      this.logger.info(`[Inngest] ${String(chunk).trim()}`);\n    });\n    this.child.stderr?.on('data', (chunk) => {\n      this.logger.warn(`[Inngest] ${String(chunk).trim()}`);\n    });\n    this.child.once('exit', (code, signal) => {\n      const message = `Embedded Inngest exited: code=${code ?? 'null'} signal=${signal ?? 'null'}`;\n      if (code && code !== 0) {\n        this.logger.error(message);\n      } else {\n        this.logger.info(message);\n      }\n      this.child = undefined;\n    });\n    this.child.once('error', (error) => {\n      this.logger.error(`Failed to start embedded Inngest: ${error}`);\n      this.child = undefined;\n    });\n\n    this.logger.info(`Embedded Inngest starting at ${baseUrl}, function endpoint ${functionEndpoint}`);\n    this.config.durableDelivery = true;\n    return this.config;\n  }\n\n  public async stop(): Promise<void> {\n    const child = this.child;\n    if (!child) {\n      return;\n    }\n    this.child = undefined;\n\n    await new Promise<void>((resolve) => {\n      const timer = setTimeout(() => {\n        child.kill('SIGKILL');\n        resolve();\n      }, 5_000);\n      timer.unref?.();\n\n      child.once('exit', () => {\n        clearTimeout(timer);\n        resolve();\n      });\n      child.kill('SIGTERM');\n    });\n  }\n\n  private resolveUsableBinaryPath(): string | undefined {\n    const configured = this.options.binaryPath;\n    if (configured) {\n      return this.isUsableBinary(configured) ? configured : undefined;\n    }\n\n    const candidates = [\n      path.join(PACKAGE_ROOT, 'node_modules', '.bin', process.platform === 'win32' ? 'inngest.cmd' : 'inngest'),\n      path.join(PACKAGE_ROOT, 'node_modules', 'inngest-cli', 'bin', process.platform === 'win32' ? 'inngest.exe' : 'inngest'),\n      'inngest',\n    ];\n\n    return candidates.find((candidate) => this.isUsableBinary(candidate));\n  }\n\n  private isUsableBinary(candidate: string): boolean {\n    const isPathLike = candidate.includes('/') || candidate.includes('\\\\');\n    if (isPathLike && !fs.existsSync(candidate)) {\n      return false;\n    }\n\n    const result = spawnSync(candidate, ['--help'], {\n      cwd: PACKAGE_ROOT,\n      env: process.env,\n      stdio: 'ignore',\n      timeout: 5_000,\n    });\n    return !result.error && result.status === 0;\n  }\n\n  private buildArguments(host: string, port: number, functionEndpoint: string): string[] {\n    return [\n      'dev',\n      '--no-discovery',\n      '--host',\n      host,\n      '--port',\n      String(port),\n      '-u',\n      functionEndpoint,\n    ];\n  }\n\n  private buildEnvironment(config: {\n    baseUrl: string;\n    eventKey: string;\n    signingKey: string;\n    functionEndpoint: string;\n  }): NodeJS.ProcessEnv {\n    const env: NodeJS.ProcessEnv = {\n      ...process.env,\n      INNGEST_DEV: config.baseUrl,\n      INNGEST_BASE_URL: config.baseUrl,\n      INNGEST_EVENT_API_BASE_URL: config.baseUrl,\n      INNGEST_API_BASE_URL: config.baseUrl,\n      INNGEST_EVENT_KEY: config.eventKey,\n      INNGEST_SIGNING_KEY: config.signingKey,\n    };\n\n    if (this.options.edition === 'cloud') {\n      if (this.isPostgresUrl(this.options.databaseUrl)) {\n        env.INNGEST_POSTGRES_URI = this.options.databaseUrl;\n      }\n      if (this.options.redisUrl) {\n        env.INNGEST_REDIS_URI = this.options.redisUrl;\n      }\n      return env;\n    }\n\n    const sqliteDir = this.options.sqliteDir ?? path.join(process.env.CSS_ROOT_FILE_PATH || './data', '.inngest');\n    fs.mkdirSync(sqliteDir, { recursive: true });\n    env.INNGEST_SQLITE_DIR = sqliteDir;\n    return env;\n  }\n\n  private isPostgresUrl(value: string): boolean {\n    return value.startsWith('postgres://') || value.startsWith('postgresql://');\n  }\n}\n"]}