@undefineds.co/xpod 0.2.45 → 0.3.0

package/dist/api/tasks/TaskService.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskService = void 0;
+const types_1 = require("../chatkit/types");
+const store_1 = require("../runs/store");
+const types_2 = require("../workspace/types");
+const TaskMaterializer_1 = require("./TaskMaterializer");
+const schema_1 = require("./schema");
+const store_2 = require("./store");
+class TaskService {
+    constructor(options) {
+        this.store = options.store;
+        this.materializer = new TaskMaterializer_1.TaskMaterializer({
+            store: options.store,
+            executionBackend: options.executionBackend,
+            executeRuns: options.executeRuns,
+        });
+    }
+    async createTask(input, context) {
+        if (!input.prompt.trim()) {
+            throw new Error('Task prompt is required');
+        }
+        if (!(0, types_2.isWorkspaceUri)(input.workspace)) {
+            throw new Error('Task workspace URI is required');
+        }
+        const triggerKind = input.triggerKind ?? schema_1.TaskTriggerKind.ONCE;
+        this.validateTrigger(input, triggerKind);
+        const authBinding = this.normalizeAuthBinding(input.authBinding);
+        const now = (0, types_1.nowTimestamp)();
+        const taskId = (0, store_2.generateTaskResourceId)((0, types_1.generateId)('task'));
+        const surfaceId = this.normalizeSurfaceId(input.surfaceId ?? 'default');
+        const thread = await this.createTaskThread({
+            taskId,
+            surfaceId,
+            title: input.title,
+            workspace: input.workspace,
+            runner: input.runner ?? 'pi:pi',
+            metadata: input.metadata,
+            context,
+        });
+        const task = {
+            id: taskId,
+            surfaceId,
+            title: input.title,
+            prompt: input.prompt,
+            thread: this.resolveThreadUri(thread, context),
+            workspace: input.workspace,
+            runner: input.runner ?? 'pi:pi',
+            status: schema_1.TaskStatus.ACTIVE,
+            triggerKind,
+            cron: input.cron,
+            intervalSeconds: input.intervalSeconds,
+            eventName: input.eventName,
+            nextRunAt: this.initialNextRunAt(input, triggerKind, now),
+            authBinding,
+            metadata: {
+                ...(input.metadata ?? {}),
+                authBinding,
+            },
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.store.saveTask(task, context);
+        if (triggerKind === schema_1.TaskTriggerKind.ONCE) {
+            const materialized = await this.materializer.materialize({
+                task,
+                context,
+                trigger: {
+                    kind: 'once',
+                    scheduledFor: now,
+                },
+            });
+            return { task: materialized.task, run: materialized.run };
+        }
+        return { task };
+    }
+    async loadTask(taskId, context) {
+        return this.store.loadTask(taskId, context);
+    }
+    async listTasks(context) {
+        return this.store.listTasks({}, context);
+    }
+    async materializeDueTasks(context, options = {}) {
+        const now = options.now ?? (0, types_1.nowTimestamp)();
+        const dueTasks = await this.store.listTasks({
+            status: schema_1.TaskStatus.ACTIVE,
+            dueAt: now,
+            limit: options.limit,
+        }, context);
+        const materialized = [];
+        for (const task of dueTasks) {
+            if (task.triggerKind !== schema_1.TaskTriggerKind.INTERVAL && task.triggerKind !== schema_1.TaskTriggerKind.CRON) {
+                continue;
+            }
+            materialized.push(await this.materializer.materialize({
+                task,
+                context,
+                trigger: {
+                    kind: task.triggerKind,
+                    scheduledFor: task.nextRunAt ?? now,
+                },
+            }));
+        }
+        return materialized;
+    }
+    async materializeEventTasks(input) {
+        const tasks = await this.store.listTasks({
+            status: schema_1.TaskStatus.ACTIVE,
+            triggerKind: schema_1.TaskTriggerKind.EVENT,
+            eventName: input.eventName,
+        }, input.context);
+        const materialized = [];
+        for (const task of tasks) {
+            materialized.push(await this.materializer.materialize({
+                task,
+                context: input.context,
+                trigger: {
+                    kind: 'event',
+                    eventName: input.eventName,
+                    payload: input.payload,
+                },
+            }));
+        }
+        return materialized;
+    }
+    async createTaskThread(input) {
+        const now = (0, types_1.nowTimestamp)();
+        const thread = {
+            id: `task/${input.surfaceId}/index.ttl#${(0, types_1.generateId)('thread')}`,
+            title: input.title,
+            status: { type: 'active' },
+            workspace: input.workspace,
+            created_at: now,
+            updated_at: now,
+            metadata: {
+                ...(input.metadata ?? {}),
+                commandKind: 'task',
+                surface_id: input.surfaceId,
+                chat_id: input.surfaceId,
+                taskId: input.taskId,
+                runtime: {
+                    workspace: input.workspace,
+                    runner: this.parseRunnerMetadata(input.runner),
+                },
+            },
+        };
+        await this.store.saveThread(thread, input.context);
+        return thread;
+    }
+    validateTrigger(input, triggerKind) {
+        if (!input.authBinding) {
+            throw new Error('Task auth binding is required');
+        }
+        if (triggerKind === schema_1.TaskTriggerKind.INTERVAL && (!input.intervalSeconds || input.intervalSeconds <= 0)) {
+            throw new Error('intervalSeconds must be a positive number for interval tasks');
+        }
+        if (triggerKind === schema_1.TaskTriggerKind.CRON && !input.cron?.trim()) {
+            throw new Error('cron is required for cron tasks');
+        }
+        if (triggerKind === schema_1.TaskTriggerKind.EVENT && !input.eventName?.trim()) {
+            throw new Error('eventName is required for event tasks');
+        }
+    }
+    normalizeAuthBinding(input) {
+        if (!input.id.trim()) {
+            throw new Error('Task auth binding id is required');
+        }
+        if (!input.webId.trim()) {
+            throw new Error('Task auth binding webId is required');
+        }
+        if (!input.clientId.trim()) {
+            throw new Error('Task auth binding clientId is required');
+        }
+        return { ...input };
+    }
+    initialNextRunAt(input, triggerKind, now) {
+        if (triggerKind === schema_1.TaskTriggerKind.INTERVAL) {
+            return input.startAt ?? now;
+        }
+        if (triggerKind === schema_1.TaskTriggerKind.CRON) {
+            return input.startAt ?? now;
+        }
+        return undefined;
+    }
+    parseRunnerMetadata(runner) {
+        const [protocol, type] = runner.split(':');
+        return {
+            protocol: protocol === 'acp' ? 'acp' : 'pi',
+            type: type || 'pi',
+        };
+    }
+    normalizeSurfaceId(value) {
+        return value.trim().replace(/[^A-Za-z0-9._~-]+/g, '-').replace(/^-+|-+$/g, '') || 'default';
+    }
+    resolveThreadUri(thread, context) {
+        const podBaseUrl = this.resolvePodBaseUrl(context);
+        const surfaceId = typeof thread.metadata?.surface_id === 'string'
+            ? thread.metadata.surface_id
+            : (typeof thread.metadata?.chat_id === 'string' ? thread.metadata.chat_id : types_1.DEFAULT_THREAD_CHAT_ID);
+        if (podBaseUrl) {
+            if (thread.id.includes('#') && !thread.id.startsWith('#')) {
+                return (0, store_1.resolveDataResourceIri)(podBaseUrl, thread.id);
+            }
+            return `${podBaseUrl}/.data/task/${surfaceId}/index.ttl#${thread.id}`;
+        }
+        return `urn:xpod:thread:task:${encodeURIComponent(surfaceId)}:${encodeURIComponent(thread.id)}`;
+    }
+    resolvePodBaseUrl(context) {
+        const webId = this.resolveWebId(context);
+        if (!webId) {
+            return undefined;
+        }
+        try {
+            const url = new URL(webId);
+            url.hash = '';
+            url.search = '';
+            const normalizedPath = url.pathname.replace(/\/+$/, '');
+            if (!normalizedPath.endsWith('/profile/card')) {
+                return undefined;
+            }
+            const podPath = normalizedPath.slice(0, -'/profile/card'.length) || '/';
+            url.pathname = podPath;
+            return url.toString().replace(/\/$/, '');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    resolveWebId(context) {
+        const auth = context.auth;
+        return typeof auth?.webId === 'string' ? auth.webId : undefined;
+    }
+}
+exports.TaskService = TaskService;
+//# sourceMappingURL=TaskService.js.map

package/dist/api/tasks/TaskService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskService.js","sourceRoot":"","sources":["../../../src/api/tasks/TaskService.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChatKitStore, StoreContext } from '../chatkit/store';\nimport type { ThreadMetadata } from '../chatkit/types';\nimport {\n  DEFAULT_THREAD_CHAT_ID,\n  generateId,\n  nowTimestamp,\n} from '../chatkit/types';\nimport type { RunExecutionBackend } from '../runs/RunExecutionBackend';\nimport { resolveDataResourceIri, type RunStore } from '../runs/store';\nimport { isWorkspaceUri, type WorkspaceUri } from '../workspace/types';\nimport { TaskMaterializer, type MaterializedTaskRun } from './TaskMaterializer';\nimport { TaskStatus, TaskTriggerKind, type TaskTriggerKindType } from './schema';\nimport type { TaskAuthBindingSnapshot } from './TaskAuthBinding';\nimport { generateTaskResourceId, type TaskRecordData, type TaskStore } from './store';\n\nexport interface CreateTaskInput {\n  surfaceId?: string;\n  title?: string;\n  prompt: string;\n  workspace: WorkspaceUri;\n  runner?: string;\n  triggerKind?: TaskTriggerKindType;\n  cron?: string;\n  intervalSeconds?: number;\n  eventName?: string;\n  startAt?: number;\n  authBinding: TaskAuthBindingSnapshot;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CreateTaskResult {\n  task: TaskRecordData;\n  run?: MaterializedTaskRun['run'];\n}\n\nexport interface TaskServiceOptions<TContext = StoreContext> {\n  store: ChatKitStore<TContext> & RunStore<TContext> & TaskStore<TContext>;\n  executionBackend?: RunExecutionBackend;\n  executeRuns?: boolean;\n}\n\nexport class TaskService<TContext = StoreContext> {\n  private readonly store: ChatKitStore<TContext> & RunStore<TContext> & TaskStore<TContext>;\n  private readonly materializer: TaskMaterializer<TContext>;\n\n  public constructor(options: TaskServiceOptions<TContext>) {\n    this.store = options.store;\n    this.materializer = new TaskMaterializer({\n      store: options.store,\n      executionBackend: options.executionBackend,\n      executeRuns: options.executeRuns,\n    });\n  }\n\n  public async createTask(input: CreateTaskInput, context: TContext): Promise<CreateTaskResult> {\n    if (!input.prompt.trim()) {\n      throw new Error('Task prompt is required');\n    }\n    if (!isWorkspaceUri(input.workspace)) {\n      throw new Error('Task workspace URI is required');\n    }\n\n    const triggerKind = input.triggerKind ?? TaskTriggerKind.ONCE;\n    this.validateTrigger(input, triggerKind);\n    const authBinding = this.normalizeAuthBinding(input.authBinding);\n\n    const now = nowTimestamp();\n    const taskId = generateTaskResourceId(generateId('task'));\n    const surfaceId = this.normalizeSurfaceId(input.surfaceId ?? 'default');\n    const thread = await this.createTaskThread({\n      taskId,\n      surfaceId,\n      title: input.title,\n      workspace: input.workspace,\n      runner: input.runner ?? 'pi:pi',\n      metadata: input.metadata,\n      context,\n    });\n\n    const task: TaskRecordData = {\n      id: taskId,\n      surfaceId,\n      title: input.title,\n      prompt: input.prompt,\n      thread: this.resolveThreadUri(thread, context),\n      workspace: input.workspace,\n      runner: input.runner ?? 'pi:pi',\n      status: TaskStatus.ACTIVE,\n      triggerKind,\n      cron: input.cron,\n      intervalSeconds: input.intervalSeconds,\n      eventName: input.eventName,\n      nextRunAt: this.initialNextRunAt(input, triggerKind, now),\n      authBinding,\n      metadata: {\n        ...(input.metadata ?? {}),\n        authBinding,\n      },\n      createdAt: now,\n      updatedAt: now,\n    };\n\n    await this.store.saveTask(task, context);\n\n    if (triggerKind === TaskTriggerKind.ONCE) {\n      const materialized = await this.materializer.materialize({\n        task,\n        context,\n        trigger: {\n          kind: 'once',\n          scheduledFor: now,\n        },\n      });\n      return { task: materialized.task, run: materialized.run };\n    }\n\n    return { task };\n  }\n\n  public async loadTask(taskId: string, context: TContext): Promise<TaskRecordData> {\n    return this.store.loadTask(taskId, context);\n  }\n\n  public async listTasks(context: TContext): Promise<TaskRecordData[]> {\n    return this.store.listTasks({}, context);\n  }\n\n  public async materializeDueTasks(\n    context: TContext,\n    options: { now?: number; limit?: number } = {},\n  ): Promise<MaterializedTaskRun[]> {\n    const now = options.now ?? nowTimestamp();\n    const dueTasks = await this.store.listTasks({\n      status: TaskStatus.ACTIVE,\n      dueAt: now,\n      limit: options.limit,\n    }, context);\n\n    const materialized: MaterializedTaskRun[] = [];\n    for (const task of dueTasks) {\n      if (task.triggerKind !== TaskTriggerKind.INTERVAL && task.triggerKind !== TaskTriggerKind.CRON) {\n        continue;\n      }\n      materialized.push(await this.materializer.materialize({\n        task,\n        context,\n        trigger: {\n          kind: task.triggerKind,\n          scheduledFor: task.nextRunAt ?? now,\n        },\n      }));\n    }\n    return materialized;\n  }\n\n  public async materializeEventTasks(input: {\n    eventName: string;\n    payload?: Record<string, unknown>;\n    context: TContext;\n  }): Promise<MaterializedTaskRun[]> {\n    const tasks = await this.store.listTasks({\n      status: TaskStatus.ACTIVE,\n      triggerKind: TaskTriggerKind.EVENT,\n      eventName: input.eventName,\n    }, input.context);\n\n    const materialized: MaterializedTaskRun[] = [];\n    for (const task of tasks) {\n      materialized.push(await this.materializer.materialize({\n        task,\n        context: input.context,\n        trigger: {\n          kind: 'event',\n          eventName: input.eventName,\n          payload: input.payload,\n        },\n      }));\n    }\n    return materialized;\n  }\n\n  private async createTaskThread(input: {\n    taskId: string;\n    surfaceId: string;\n    title?: string;\n    workspace: WorkspaceUri;\n    runner: string;\n    metadata?: Record<string, unknown>;\n    context: TContext;\n  }): Promise<ThreadMetadata> {\n    const now = nowTimestamp();\n    const thread: ThreadMetadata = {\n      id: `task/${input.surfaceId}/index.ttl#${generateId('thread')}`,\n      title: input.title,\n      status: { type: 'active' },\n      workspace: input.workspace,\n      created_at: now,\n      updated_at: now,\n      metadata: {\n        ...(input.metadata ?? {}),\n        commandKind: 'task',\n        surface_id: input.surfaceId,\n        chat_id: input.surfaceId,\n        taskId: input.taskId,\n        runtime: {\n          workspace: input.workspace,\n          runner: this.parseRunnerMetadata(input.runner),\n        },\n      },\n    };\n    await this.store.saveThread(thread, input.context);\n    return thread;\n  }\n\n  private validateTrigger(input: CreateTaskInput, triggerKind: TaskTriggerKindType): void {\n    if (!input.authBinding) {\n      throw new Error('Task auth binding is required');\n    }\n    if (triggerKind === TaskTriggerKind.INTERVAL && (!input.intervalSeconds || input.intervalSeconds <= 0)) {\n      throw new Error('intervalSeconds must be a positive number for interval tasks');\n    }\n    if (triggerKind === TaskTriggerKind.CRON && !input.cron?.trim()) {\n      throw new Error('cron is required for cron tasks');\n    }\n    if (triggerKind === TaskTriggerKind.EVENT && !input.eventName?.trim()) {\n      throw new Error('eventName is required for event tasks');\n    }\n  }\n\n  private normalizeAuthBinding(input: TaskAuthBindingSnapshot): TaskAuthBindingSnapshot {\n    if (!input.id.trim()) {\n      throw new Error('Task auth binding id is required');\n    }\n    if (!input.webId.trim()) {\n      throw new Error('Task auth binding webId is required');\n    }\n    if (!input.clientId.trim()) {\n      throw new Error('Task auth binding clientId is required');\n    }\n    return { ...input };\n  }\n\n  private initialNextRunAt(input: CreateTaskInput, triggerKind: TaskTriggerKindType, now: number): number | undefined {\n    if (triggerKind === TaskTriggerKind.INTERVAL) {\n      return input.startAt ?? now;\n    }\n    if (triggerKind === TaskTriggerKind.CRON) {\n      return input.startAt ?? now;\n    }\n    return undefined;\n  }\n\n  private parseRunnerMetadata(runner: string): { protocol: string; type: string } {\n    const [protocol, type] = runner.split(':');\n    return {\n      protocol: protocol === 'acp' ? 'acp' : 'pi',\n      type: type || 'pi',\n    };\n  }\n\n  private normalizeSurfaceId(value: string): string {\n    return value.trim().replace(/[^A-Za-z0-9._~-]+/g, '-').replace(/^-+|-+$/g, '') || 'default';\n  }\n\n  private resolveThreadUri(thread: ThreadMetadata, context: TContext): string {\n    const podBaseUrl = this.resolvePodBaseUrl(context);\n    const surfaceId = typeof thread.metadata?.surface_id === 'string'\n      ? thread.metadata.surface_id\n      : (typeof thread.metadata?.chat_id === 'string' ? thread.metadata.chat_id : DEFAULT_THREAD_CHAT_ID);\n    if (podBaseUrl) {\n      if (thread.id.includes('#') && !thread.id.startsWith('#')) {\n        return resolveDataResourceIri(podBaseUrl, thread.id);\n      }\n      return `${podBaseUrl}/.data/task/${surfaceId}/index.ttl#${thread.id}`;\n    }\n    return `urn:xpod:thread:task:${encodeURIComponent(surfaceId)}:${encodeURIComponent(thread.id)}`;\n  }\n\n  private resolvePodBaseUrl(context: TContext): string | undefined {\n    const webId = this.resolveWebId(context);\n    if (!webId) {\n      return undefined;\n    }\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      const podPath = normalizedPath.slice(0, -'/profile/card'.length) || '/';\n      url.pathname = podPath;\n      return url.toString().replace(/\\/$/, '');\n    } catch {\n      return undefined;\n    }\n  }\n\n  private resolveWebId(context: TContext): string | undefined {\n    const auth = (context as Record<string, unknown>).auth as { webId?: unknown } | undefined;\n    return typeof auth?.webId === 'string' ? auth.webId : undefined;\n  }\n}\n"]}

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

@@ -0,0 +1,6 @@
+export { Task, TaskStatus, TaskTriggerKind, type TaskRecord, type TaskStatusType, type TaskTriggerKindType, } from './schema';
+export { type TaskListOptions, type TaskRecordData, type TaskStore, } from './store';
+export { TaskMaterializer, type MaterializedTaskRun, type TaskMaterializerOptions, } from './TaskMaterializer';
+export { TaskService, type CreateTaskInput, type CreateTaskResult, type TaskServiceOptions, } from './TaskService';
+export { TASK_AUTH_CREDENTIAL_SERVICE, TaskAuthBindingKind, TaskAuthBindingService, TaskAuthBindingStatus, encodeClientCredentialsApiKey, parseClientCredentialsApiKey, type CreateTaskAuthBindingInput, type TaskAuthBindingKindType, type TaskAuthBindingRepository, type TaskAuthBindingServiceOptions, type TaskAuthBindingSnapshot, type TaskAuthBindingStatusType, type TaskAuthCredentialRecord, } from './TaskAuthBinding';
+export { InngestTaskScheduler, XPOD_TASK_MATERIALIZE_DUE_EVENT, XPOD_TASK_EVENT, XPOD_TASK_EVENT_FUNCTION_ID, XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID, type XpodTaskMaterializeDueEvent, type XpodTaskMaterializeDueEventData, type XpodTaskEvent, type XpodTaskEventData, type InngestTaskSchedulerOptions, } from './InngestTaskScheduler';

package/dist/api/tasks/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID = exports.XPOD_TASK_EVENT_FUNCTION_ID = exports.XPOD_TASK_EVENT = exports.XPOD_TASK_MATERIALIZE_DUE_EVENT = exports.InngestTaskScheduler = exports.parseClientCredentialsApiKey = exports.encodeClientCredentialsApiKey = exports.TaskAuthBindingStatus = exports.TaskAuthBindingService = exports.TaskAuthBindingKind = exports.TASK_AUTH_CREDENTIAL_SERVICE = exports.TaskService = exports.TaskMaterializer = exports.TaskTriggerKind = exports.TaskStatus = exports.Task = void 0;
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "Task", { enumerable: true, get: function () { return schema_1.Task; } });
+Object.defineProperty(exports, "TaskStatus", { enumerable: true, get: function () { return schema_1.TaskStatus; } });
+Object.defineProperty(exports, "TaskTriggerKind", { enumerable: true, get: function () { return schema_1.TaskTriggerKind; } });
+var TaskMaterializer_1 = require("./TaskMaterializer");
+Object.defineProperty(exports, "TaskMaterializer", { enumerable: true, get: function () { return TaskMaterializer_1.TaskMaterializer; } });
+var TaskService_1 = require("./TaskService");
+Object.defineProperty(exports, "TaskService", { enumerable: true, get: function () { return TaskService_1.TaskService; } });
+var TaskAuthBinding_1 = require("./TaskAuthBinding");
+Object.defineProperty(exports, "TASK_AUTH_CREDENTIAL_SERVICE", { enumerable: true, get: function () { return TaskAuthBinding_1.TASK_AUTH_CREDENTIAL_SERVICE; } });
+Object.defineProperty(exports, "TaskAuthBindingKind", { enumerable: true, get: function () { return TaskAuthBinding_1.TaskAuthBindingKind; } });
+Object.defineProperty(exports, "TaskAuthBindingService", { enumerable: true, get: function () { return TaskAuthBinding_1.TaskAuthBindingService; } });
+Object.defineProperty(exports, "TaskAuthBindingStatus", { enumerable: true, get: function () { return TaskAuthBinding_1.TaskAuthBindingStatus; } });
+Object.defineProperty(exports, "encodeClientCredentialsApiKey", { enumerable: true, get: function () { return TaskAuthBinding_1.encodeClientCredentialsApiKey; } });
+Object.defineProperty(exports, "parseClientCredentialsApiKey", { enumerable: true, get: function () { return TaskAuthBinding_1.parseClientCredentialsApiKey; } });
+var InngestTaskScheduler_1 = require("./InngestTaskScheduler");
+Object.defineProperty(exports, "InngestTaskScheduler", { enumerable: true, get: function () { return InngestTaskScheduler_1.InngestTaskScheduler; } });
+Object.defineProperty(exports, "XPOD_TASK_MATERIALIZE_DUE_EVENT", { enumerable: true, get: function () { return InngestTaskScheduler_1.XPOD_TASK_MATERIALIZE_DUE_EVENT; } });
+Object.defineProperty(exports, "XPOD_TASK_EVENT", { enumerable: true, get: function () { return InngestTaskScheduler_1.XPOD_TASK_EVENT; } });
+Object.defineProperty(exports, "XPOD_TASK_EVENT_FUNCTION_ID", { enumerable: true, get: function () { return InngestTaskScheduler_1.XPOD_TASK_EVENT_FUNCTION_ID; } });
+Object.defineProperty(exports, "XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID", { enumerable: true, get: function () { return InngestTaskScheduler_1.XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/tasks/index.ts"],"names":[],"mappings":";;;AAAA,mCAOkB;AANhB,8FAAA,IAAI,OAAA;AACJ,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AAUjB,uDAI4B;AAH1B,oHAAA,gBAAgB,OAAA;AAIlB,6CAKuB;AAJrB,0GAAA,WAAW,OAAA;AAKb,qDAc2B;AAbzB,+HAAA,4BAA4B,OAAA;AAC5B,sHAAA,mBAAmB,OAAA;AACnB,yHAAA,sBAAsB,OAAA;AACtB,wHAAA,qBAAqB,OAAA;AACrB,gIAAA,6BAA6B,OAAA;AAC7B,+HAAA,4BAA4B,OAAA;AAS9B,+DAWgC;AAV9B,4HAAA,oBAAoB,OAAA;AACpB,uIAAA,+BAA+B,OAAA;AAC/B,uHAAA,eAAe,OAAA;AACf,mIAAA,2BAA2B,OAAA;AAC3B,6IAAA,qCAAqC,OAAA","sourcesContent":["export {\n  Task,\n  TaskStatus,\n  TaskTriggerKind,\n  type TaskRecord,\n  type TaskStatusType,\n  type TaskTriggerKindType,\n} from './schema';\nexport {\n  type TaskListOptions,\n  type TaskRecordData,\n  type TaskStore,\n} from './store';\nexport {\n  TaskMaterializer,\n  type MaterializedTaskRun,\n  type TaskMaterializerOptions,\n} from './TaskMaterializer';\nexport {\n  TaskService,\n  type CreateTaskInput,\n  type CreateTaskResult,\n  type TaskServiceOptions,\n} from './TaskService';\nexport {\n  TASK_AUTH_CREDENTIAL_SERVICE,\n  TaskAuthBindingKind,\n  TaskAuthBindingService,\n  TaskAuthBindingStatus,\n  encodeClientCredentialsApiKey,\n  parseClientCredentialsApiKey,\n  type CreateTaskAuthBindingInput,\n  type TaskAuthBindingKindType,\n  type TaskAuthBindingRepository,\n  type TaskAuthBindingServiceOptions,\n  type TaskAuthBindingSnapshot,\n  type TaskAuthBindingStatusType,\n  type TaskAuthCredentialRecord,\n} from './TaskAuthBinding';\nexport {\n  InngestTaskScheduler,\n  XPOD_TASK_MATERIALIZE_DUE_EVENT,\n  XPOD_TASK_EVENT,\n  XPOD_TASK_EVENT_FUNCTION_ID,\n  XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID,\n  type XpodTaskMaterializeDueEvent,\n  type XpodTaskMaterializeDueEventData,\n  type XpodTaskEvent,\n  type XpodTaskEventData,\n  type InngestTaskSchedulerOptions,\n} from './InngestTaskScheduler';\n"]}

package/dist/api/tasks/schema.d.ts

@@ -0,0 +1,23 @@
+import { TaskStatus, TaskTriggerKind, type TaskRow, type TaskStatusType, type TaskTriggerKindType } from '@undefineds.co/models';
+export declare const Task: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
+    id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
+    surfaceId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
+    title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    prompt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
+    thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    workspace: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+    runner: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
+    status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
+    triggerKind: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
+    cron: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    intervalSeconds: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"integer", null, false, false>;
+    eventName: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    nextRunAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    lastRunAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    metadata: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"object", null, false, false>;
+    createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+    updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+}>>;
+export { TaskStatus, TaskTriggerKind };
+export type TaskRecord = TaskRow;
+export type { TaskStatusType, TaskTriggerKindType, };

package/dist/api/tasks/schema.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskTriggerKind = exports.TaskStatus = exports.Task = void 0;
+const models_1 = require("@undefineds.co/models");
+Object.defineProperty(exports, "TaskStatus", { enumerable: true, get: function () { return models_1.TaskStatus; } });
+Object.defineProperty(exports, "TaskTriggerKind", { enumerable: true, get: function () { return models_1.TaskTriggerKind; } });
+exports.Task = models_1.taskResource;
+//# sourceMappingURL=schema.js.map

package/dist/api/tasks/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/api/tasks/schema.ts"],"names":[],"mappings":";;;AAAA,kDAO+B;AAItB,2FAVP,mBAAU,OAUO;AAAE,gGATnB,wBAAe,OASmB;AAFvB,QAAA,IAAI,GAAG,qBAAY,CAAC","sourcesContent":["import {\n  TaskStatus,\n  TaskTriggerKind,\n  taskResource,\n  type TaskRow,\n  type TaskStatusType,\n  type TaskTriggerKindType,\n} from '@undefineds.co/models';\n\nexport const Task = taskResource;\n\nexport { TaskStatus, TaskTriggerKind };\n\nexport type TaskRecord = TaskRow;\nexport type {\n  TaskStatusType,\n  TaskTriggerKindType,\n};\n"]}

package/dist/api/tasks/store.d.ts

@@ -0,0 +1,40 @@
+import type { WorkspaceUri } from '../workspace/types';
+import type { TaskAuthBindingSnapshot } from './TaskAuthBinding';
+import type { TaskStatusType, TaskTriggerKindType } from './schema';
+export interface TaskRecordData {
+    /** Base-relative Solid resource id, e.g. `index.ttl#task_x`. */
+    id: string;
+    surfaceId: string;
+    title?: string;
+    prompt: string;
+    thread: string;
+    workspace: WorkspaceUri;
+    runner: string;
+    status: TaskStatusType;
+    triggerKind: TaskTriggerKindType;
+    cron?: string;
+    intervalSeconds?: number;
+    eventName?: string;
+    nextRunAt?: number;
+    lastRunAt?: number;
+    authBinding?: TaskAuthBindingSnapshot;
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface TaskListOptions {
+    status?: TaskStatusType;
+    triggerKind?: TaskTriggerKindType;
+    eventName?: string;
+    dueAt?: number;
+    limit?: number;
+}
+export interface TaskStore<TContext> {
+    saveTask(task: TaskRecordData, context: TContext): Promise<void>;
+    loadTask(taskId: string, context: TContext): Promise<TaskRecordData>;
+    listTasks(options: TaskListOptions, context: TContext): Promise<TaskRecordData[]>;
+}
+export declare function buildTaskResourceId(id: string): string;
+export declare function generateTaskResourceId(key: string): string;
+export declare function resolveTaskResourceIri(podBaseUrl: string, taskId: string): string;
+export declare function resolveTaskUrn(taskId: string): string;

package/dist/api/tasks/store.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTaskResourceId = buildTaskResourceId;
+exports.generateTaskResourceId = generateTaskResourceId;
+exports.resolveTaskResourceIri = resolveTaskResourceIri;
+exports.resolveTaskUrn = resolveTaskUrn;
+const models_1 = require("@undefineds.co/models");
+function buildTaskResourceId(id) {
+    if (!/^index\.ttl#[^#/]+$/.test(id)) {
+        throw new Error(`Task id must be a complete Task resource id under index.ttl: ${id}`);
+    }
+    return id;
+}
+function generateTaskResourceId(key) {
+    if (/^index\.ttl#[^#/]+$/.test(key)) {
+        throw new Error(`Task id generator requires a local key, got resource id: ${key}`);
+    }
+    if (/\.ttl(?:#|$)/i.test(key) || key.includes('/') || key.includes('#')) {
+        throw new Error(`Task id generator requires a local key: ${key}`);
+    }
+    return (0, models_1.taskResourceId)(key);
+}
+function resolveTaskResourceIri(podBaseUrl, taskId) {
+    if (/^https?:\/\//.test(taskId)) {
+        return taskId;
+    }
+    const base = podBaseUrl.replace(/\/$/, '');
+    const relative = buildTaskResourceId(taskId).replace(/^\/+/, '');
+    return `${base}/.data/task/${relative}`;
+}
+function resolveTaskUrn(taskId) {
+    return `urn:xpod:task:${encodeURIComponent(buildTaskResourceId(taskId))}`;
+}
+//# sourceMappingURL=store.js.map

package/dist/api/tasks/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/api/tasks/store.ts"],"names":[],"mappings":";;AAyCA,kDAKC;AAED,wDAQC;AAED,wDAOC;AAED,wCAEC;AApED,kDAAuD;AAwCvD,SAAgB,mBAAmB,CAAC,EAAU;IAC5C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,gEAAgE,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,sBAAsB,CAAC,GAAW;IAChD,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,4DAA4D,GAAG,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,IAAA,uBAAc,EAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,SAAgB,sBAAsB,CAAC,UAAkB,EAAE,MAAc;IACvE,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjE,OAAO,GAAG,IAAI,eAAe,QAAQ,EAAE,CAAC;AAC1C,CAAC;AAED,SAAgB,cAAc,CAAC,MAAc;IAC3C,OAAO,iBAAiB,kBAAkB,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC","sourcesContent":["import type { WorkspaceUri } from '../workspace/types';\nimport { taskResourceId } from '@undefineds.co/models';\nimport type { TaskAuthBindingSnapshot } from './TaskAuthBinding';\nimport type { TaskStatusType, TaskTriggerKindType } from './schema';\n\nexport interface TaskRecordData {\n  /** Base-relative Solid resource id, e.g. `index.ttl#task_x`. */\n  id: string;\n  surfaceId: string;\n  title?: string;\n  prompt: string;\n  thread: string;\n  workspace: WorkspaceUri;\n  runner: string;\n  status: TaskStatusType;\n  triggerKind: TaskTriggerKindType;\n  cron?: string;\n  intervalSeconds?: number;\n  eventName?: string;\n  nextRunAt?: number;\n  lastRunAt?: number;\n  authBinding?: TaskAuthBindingSnapshot;\n  metadata?: Record<string, unknown>;\n  createdAt: number;\n  updatedAt: number;\n}\n\nexport interface TaskListOptions {\n  status?: TaskStatusType;\n  triggerKind?: TaskTriggerKindType;\n  eventName?: string;\n  dueAt?: number;\n  limit?: number;\n}\n\nexport interface TaskStore<TContext> {\n  saveTask(task: TaskRecordData, context: TContext): Promise<void>;\n  loadTask(taskId: string, context: TContext): Promise<TaskRecordData>;\n  listTasks(options: TaskListOptions, context: TContext): Promise<TaskRecordData[]>;\n}\n\nexport function buildTaskResourceId(id: string): string {\n  if (!/^index\\.ttl#[^#/]+$/.test(id)) {\n    throw new Error(`Task id must be a complete Task resource id under index.ttl: ${id}`);\n  }\n  return id;\n}\n\nexport function generateTaskResourceId(key: string): string {\n  if (/^index\\.ttl#[^#/]+$/.test(key)) {\n    throw new Error(`Task id generator requires a local key, got resource id: ${key}`);\n  }\n  if (/\\.ttl(?:#|$)/i.test(key) || key.includes('/') || key.includes('#')) {\n    throw new Error(`Task id generator requires a local key: ${key}`);\n  }\n  return taskResourceId(key);\n}\n\nexport function resolveTaskResourceIri(podBaseUrl: string, taskId: string): string {\n  if (/^https?:\\/\\//.test(taskId)) {\n    return taskId;\n  }\n  const base = podBaseUrl.replace(/\\/$/, '');\n  const relative = buildTaskResourceId(taskId).replace(/^\\/+/, '');\n  return `${base}/.data/task/${relative}`;\n}\n\nexport function resolveTaskUrn(taskId: string): string {\n  return `urn:xpod:task:${encodeURIComponent(buildTaskResourceId(taskId))}`;\n}\n"]}

package/dist/api/workspace/types.d.ts

@@ -0,0 +1,3 @@
+export type WorkspaceUri = string;
+export declare function isWorkspaceUri(value: unknown): value is WorkspaceUri;
+export declare function assertWorkspaceUri(value: unknown, label?: string): WorkspaceUri;

package/dist/api/workspace/types.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWorkspaceUri = isWorkspaceUri;
+exports.assertWorkspaceUri = assertWorkspaceUri;
+function isWorkspaceUri(value) {
+    if (typeof value !== 'string' || value.length === 0) {
+        return false;
+    }
+    try {
+        const url = new URL(value);
+        return url.protocol === 'http:' || url.protocol === 'https:' || url.protocol === 'file:';
+    }
+    catch {
+        return false;
+    }
+}
+function assertWorkspaceUri(value, label = 'workspace') {
+    if (isWorkspaceUri(value)) {
+        return value;
+    }
+    throw new Error(`${label} must be an http(s):// or file:// URI`);
+}
+//# sourceMappingURL=types.js.map

package/dist/api/workspace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api/workspace/types.ts"],"names":[],"mappings":";;AAEA,wCAWC;AAED,gDAKC;AAlBD,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc,EAAE,KAAK,GAAG,WAAW;IACpE,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,uCAAuC,CAAC,CAAC;AACnE,CAAC","sourcesContent":["export type WorkspaceUri = string;\n\nexport function isWorkspaceUri(value: unknown): value is WorkspaceUri {\n  if (typeof value !== 'string' || value.length === 0) {\n    return false;\n  }\n\n  try {\n    const url = new URL(value);\n    return url.protocol === 'http:' || url.protocol === 'https:' || url.protocol === 'file:';\n  } catch {\n    return false;\n  }\n}\n\nexport function assertWorkspaceUri(value: unknown, label = 'workspace'): WorkspaceUri {\n  if (isWorkspaceUri(value)) {\n    return value;\n  }\n  throw new Error(`${label} must be an http(s):// or file:// URI`);\n}\n"]}

package/dist/cli/commands/config.d.ts

@@ -3,10 +3,10 @@ interface ConfigArgs {
     url?: string;
 }
 /**
- * Config 子命令：配置 SecretaryAI 使用的 AI 服务。
+ * Config 子命令：配置 Pod 中的 AI provider。
  *
  * 写入 Pod 的两个资源，与服务端 PodChatKitStore.getAiConfig() 对齐：
- *   /settings/ai/providers.ttl#{provider}       — Provider (baseUrl, displayName)
+ *   /settings/providers/{provider}.ttl          — Provider + optional Model
  *   /settings/credentials.ttl#cred-{provider}   — Credential (apiKey, service=ai, status=active, provider link)
  *
  * 用法:
@@ -15,17 +15,18 @@ interface ConfigArgs {
  *   xpod config show
  *   xpod config reset
  */
-export declare const UDFS_NS = "https://undefineds.co/ns#";
+export declare const AI_NS: string;
+export declare const CREDENTIAL_NS: string;
 /** provider name → default baseUrl */
 export declare const PROVIDER_BASE_URLS: Record<string, string>;
-/** OAuth providers that require browser login */
-export declare const OAUTH_PROVIDERS: Set<string>;
 export declare function maskSecret(value: string): string;
 export declare function credentialId(provider: string): string;
 /**
- * Build SPARQL UPDATE to upsert a Provider at /settings/ai/providers.ttl#{id}
+ * Build SPARQL UPDATE to upsert a Provider at /settings/providers/{id}.ttl
  */
-export declare function buildProviderSparql(resourceUrl: string, providerId: string): string;
+export declare function buildProviderSparql(resourceUrl: string, providerId: string, fields?: {
+    model?: string;
+}): string;
 /**
  * Build SPARQL UPDATE to upsert a Credential at /settings/credentials.ttl#cred-{provider}
  */