@undefineds.co/xpod 0.2.45 → 0.3.0

package/dist/api/tasks/InngestTaskScheduler.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InngestTaskScheduler = exports.XPOD_TASK_EVENT_FUNCTION_ID = exports.XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID = exports.XPOD_TASK_EVENT = exports.XPOD_TASK_MATERIALIZE_DUE_EVENT = void 0;
+const types_1 = require("../chatkit/types");
+exports.XPOD_TASK_MATERIALIZE_DUE_EVENT = 'xpod/task.materialize_due';
+exports.XPOD_TASK_EVENT = 'xpod/task.event';
+exports.XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID = 'xpod-task-materialize-due-runs';
+exports.XPOD_TASK_EVENT_FUNCTION_ID = 'xpod-task-event';
+class InngestTaskScheduler {
+    constructor(options) {
+        this.pendingDueTasks = new Map();
+        this.pendingTaskEvents = new Map();
+        this.taskService = options.taskService;
+        this.getContext = options.getContext ?? (() => undefined);
+        this.getContexts = options.getContexts;
+        this.resolveContext = options.resolveContext;
+        this.recordContext = options.recordContext;
+        this.durableDelivery = options.durableDelivery ?? true;
+        this.executeInline = options.executeInline ?? true;
+        this.client = options.backend.getClient();
+        this.materializeDueRunsFunction = this.client.createFunction({
+            id: exports.XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID,
+            name: 'Xpod Task Materialize Due Runs',
+            triggers: [
+                { cron: '*/1 * * * *' },
+                { event: exports.XPOD_TASK_MATERIALIZE_DUE_EVENT },
+            ],
+        }, (ctx) => this.handleDueTasks(ctx));
+        this.eventTaskFunction = this.client.createFunction({
+            id: exports.XPOD_TASK_EVENT_FUNCTION_ID,
+            name: 'Xpod Task Event',
+            triggers: [{ event: exports.XPOD_TASK_EVENT }],
+        }, (ctx) => this.handleTaskEvent(ctx));
+    }
+    getFunctions() {
+        return [this.materializeDueRunsFunction, this.eventTaskFunction];
+    }
+    async materializeDueTasks(context, options = {}) {
+        const requestId = (0, types_1.generateId)('task-due');
+        this.recordContext?.(context);
+        this.pendingDueTasks.set(requestId, { context, ...options });
+        try {
+            if (this.durableDelivery) {
+                await this.client.send({
+                    id: requestId,
+                    name: exports.XPOD_TASK_MATERIALIZE_DUE_EVENT,
+                    data: {
+                        requestId,
+                        now: options.now,
+                        limit: options.limit,
+                        ...this.contextEventData(context),
+                    },
+                });
+            }
+            if (!this.executeInline) {
+                return [];
+            }
+            return this.handleDueTasks(this.createInlineDueContext(requestId, options));
+        }
+        catch (error) {
+            this.pendingDueTasks.delete(requestId);
+            throw error;
+        }
+    }
+    async materializeEventTasks(input) {
+        const requestId = (0, types_1.generateId)('task-event');
+        this.recordContext?.(input.context);
+        this.pendingTaskEvents.set(requestId, input);
+        try {
+            if (this.durableDelivery) {
+                await this.client.send({
+                    id: requestId,
+                    name: exports.XPOD_TASK_EVENT,
+                    data: {
+                        requestId,
+                        ...this.contextEventData(input.context),
+                        eventName: input.eventName,
+                        payload: input.payload,
+                    },
+                });
+            }
+            if (!this.executeInline) {
+                return [];
+            }
+            return this.handleTaskEvent(this.createInlineEventContext(requestId, input));
+        }
+        catch (error) {
+            this.pendingTaskEvents.delete(requestId);
+            throw error;
+        }
+    }
+    async handleDueTasks(ctx) {
+        const requestId = ctx.event?.data?.requestId;
+        const pending = requestId ? this.pendingDueTasks.get(requestId) : undefined;
+        const contexts = await this.resolveDueContexts(pending?.context, ctx.event?.data);
+        if (contexts.length === 0) {
+            return [];
+        }
+        try {
+            return await ctx.step.run('materialize-due-tasks', async () => {
+                const runs = [];
+                for (const context of contexts) {
+                    runs.push(...await this.taskService.materializeDueTasks(context, {
+                        now: pending?.now ?? ctx.event?.data?.now,
+                        limit: pending?.limit ?? ctx.event?.data?.limit,
+                    }));
+                }
+                return runs;
+            });
+        }
+        finally {
+            if (requestId) {
+                this.pendingDueTasks.delete(requestId);
+            }
+        }
+    }
+    async handleTaskEvent(ctx) {
+        const requestId = ctx.event.data?.requestId;
+        const pending = requestId ? this.pendingTaskEvents.get(requestId) : undefined;
+        const eventName = pending?.eventName ?? ctx.event.data?.eventName;
+        if (!eventName) {
+            return [];
+        }
+        const context = pending?.context ?? await this.resolveSingleContext(ctx.event.data);
+        if (!context) {
+            return [];
+        }
+        try {
+            return await ctx.step.run('materialize-event-tasks', async () => this.taskService.materializeEventTasks({
+                eventName,
+                payload: pending?.payload ?? ctx.event.data?.payload,
+                context,
+            }));
+        }
+        finally {
+            if (requestId) {
+                this.pendingTaskEvents.delete(requestId);
+            }
+        }
+    }
+    createInlineDueContext(requestId, options) {
+        const pending = this.pendingDueTasks.get(requestId);
+        return {
+            event: {
+                id: requestId,
+                name: exports.XPOD_TASK_MATERIALIZE_DUE_EVENT,
+                data: {
+                    requestId,
+                    now: options.now,
+                    limit: options.limit,
+                    ...(pending ? this.contextEventData(pending.context) : {}),
+                },
+            },
+            step: {
+                run: async (_id, fn) => fn(),
+            },
+        };
+    }
+    createInlineEventContext(requestId, input) {
+        const pending = this.pendingTaskEvents.get(requestId);
+        return {
+            event: {
+                id: requestId,
+                name: exports.XPOD_TASK_EVENT,
+                data: {
+                    requestId,
+                    ...(pending ? this.contextEventData(pending.context) : {}),
+                    eventName: input.eventName,
+                    payload: input.payload,
+                },
+            },
+            step: {
+                run: async (_id, fn) => fn(),
+            },
+        };
+    }
+    async resolveDueContexts(pendingContext, eventData) {
+        if (pendingContext) {
+            return [pendingContext];
+        }
+        const eventContext = await this.resolveSingleContext(eventData);
+        if (eventContext) {
+            return [eventContext];
+        }
+        if (this.getContexts) {
+            return Array.from(await this.getContexts());
+        }
+        const fallback = this.getContext();
+        return fallback ? [fallback] : [];
+    }
+    async resolveSingleContext(eventData) {
+        const resolved = eventData ? await this.resolveContext?.(eventData) : undefined;
+        return resolved ?? this.getContext();
+    }
+    contextEventData(context) {
+        const auth = context.auth;
+        const data = {};
+        const authBindingId = context.authBindingId;
+        if (typeof authBindingId === 'string' && authBindingId.length > 0) {
+            data.authBindingId = authBindingId;
+        }
+        if (auth?.type === 'solid' && typeof auth.webId === 'string') {
+            data.webId = auth.webId;
+        }
+        return data;
+    }
+}
+exports.InngestTaskScheduler = InngestTaskScheduler;
+//# sourceMappingURL=InngestTaskScheduler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InngestTaskScheduler.js","sourceRoot":"","sources":["../../../src/api/tasks/InngestTaskScheduler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventPayload } from 'inngest/types';\nimport type { InngestRunExecutionBackend } from '../runs/InngestRunExecutionBackend';\nimport type { StoreContext } from '../chatkit/store';\nimport { generateId } from '../chatkit/types';\nimport type { TaskService } from './TaskService';\nimport type { MaterializedTaskRun } from './TaskMaterializer';\n\nexport const XPOD_TASK_MATERIALIZE_DUE_EVENT = 'xpod/task.materialize_due';\nexport const XPOD_TASK_EVENT = 'xpod/task.event';\nexport const XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID = 'xpod-task-materialize-due-runs';\nexport const XPOD_TASK_EVENT_FUNCTION_ID = 'xpod-task-event';\n\nexport interface XpodTaskMaterializeDueEventData {\n  requestId?: string;\n  now?: number;\n  limit?: number;\n  authBindingId?: string;\n  webId?: string;\n}\n\nexport type XpodTaskMaterializeDueEvent = EventPayload<XpodTaskMaterializeDueEventData> & {\n  name: typeof XPOD_TASK_MATERIALIZE_DUE_EVENT;\n};\n\nexport interface XpodTaskEventData {\n  requestId?: string;\n  authBindingId?: string;\n  webId?: string;\n  eventName: string;\n  payload?: Record<string, unknown>;\n}\n\nexport type XpodTaskEvent = EventPayload<XpodTaskEventData> & {\n  name: typeof XPOD_TASK_EVENT;\n};\n\nexport interface InngestTaskSchedulerOptions<TContext = StoreContext> {\n  backend: InngestRunExecutionBackend;\n  taskService: TaskService<TContext>;\n  getContext?: () => TContext | undefined;\n  getContexts?: () => Iterable<TContext> | Promise<Iterable<TContext>>;\n  resolveContext?: (\n    data: Partial<XpodTaskMaterializeDueEventData & XpodTaskEventData>,\n  ) => TContext | Promise<TContext | undefined> | undefined;\n  recordContext?: (context: TContext | undefined) => void;\n  durableDelivery?: boolean;\n  executeInline?: boolean;\n}\n\ntype InngestTaskEventContext = {\n  event: XpodTaskEvent;\n  step: {\n    run<T>(id: string, fn: () => Promise<T> | T): Promise<T>;\n  };\n};\n\ntype InngestCronContext = {\n  event?: XpodTaskMaterializeDueEvent;\n  step: {\n    run<T>(id: string, fn: () => Promise<T> | T): Promise<T>;\n  };\n};\n\nexport class InngestTaskScheduler<TContext = StoreContext> {\n  public readonly materializeDueRunsFunction;\n  public readonly eventTaskFunction;\n\n  private readonly taskService: TaskService<TContext>;\n  private readonly getContext: () => TContext | undefined;\n  private readonly getContexts?: () => Iterable<TContext> | Promise<Iterable<TContext>>;\n  private readonly resolveContext?: InngestTaskSchedulerOptions<TContext>['resolveContext'];\n  private readonly recordContext?: InngestTaskSchedulerOptions<TContext>['recordContext'];\n  private readonly durableDelivery: boolean;\n  private readonly executeInline: boolean;\n  private readonly pendingDueTasks = new Map<string, { context: TContext; now?: number; limit?: number }>();\n  private readonly pendingTaskEvents = new Map<string, { context: TContext; eventName: string; payload?: Record<string, unknown> }>();\n  private readonly client: ReturnType<InngestRunExecutionBackend['getClient']>;\n\n  public constructor(options: InngestTaskSchedulerOptions<TContext>) {\n    this.taskService = options.taskService;\n    this.getContext = options.getContext ?? (() => undefined);\n    this.getContexts = options.getContexts;\n    this.resolveContext = options.resolveContext;\n    this.recordContext = options.recordContext;\n    this.durableDelivery = options.durableDelivery ?? true;\n    this.executeInline = options.executeInline ?? true;\n    this.client = options.backend.getClient();\n\n    this.materializeDueRunsFunction = this.client.createFunction(\n      {\n        id: XPOD_TASK_MATERIALIZE_DUE_FUNCTION_ID,\n        name: 'Xpod Task Materialize Due Runs',\n        triggers: [\n          { cron: '*/1 * * * *' },\n          { event: XPOD_TASK_MATERIALIZE_DUE_EVENT },\n        ],\n      },\n      (ctx: any) => this.handleDueTasks(ctx as InngestCronContext),\n    );\n\n    this.eventTaskFunction = this.client.createFunction(\n      {\n        id: XPOD_TASK_EVENT_FUNCTION_ID,\n        name: 'Xpod Task Event',\n        triggers: [{ event: XPOD_TASK_EVENT }],\n      },\n      (ctx: any) => this.handleTaskEvent(ctx as InngestTaskEventContext),\n    );\n  }\n\n  public getFunctions(): unknown[] {\n    return [this.materializeDueRunsFunction, this.eventTaskFunction];\n  }\n\n  public async materializeDueTasks(\n    context: TContext,\n    options: { now?: number; limit?: number } = {},\n  ): Promise<MaterializedTaskRun[]> {\n    const requestId = generateId('task-due');\n    this.recordContext?.(context);\n    this.pendingDueTasks.set(requestId, { context, ...options });\n    try {\n      if (this.durableDelivery) {\n        await this.client.send({\n          id: requestId,\n          name: XPOD_TASK_MATERIALIZE_DUE_EVENT,\n          data: {\n            requestId,\n            now: options.now,\n            limit: options.limit,\n            ...this.contextEventData(context),\n          },\n        });\n      }\n      if (!this.executeInline) {\n        return [];\n      }\n      return this.handleDueTasks(this.createInlineDueContext(requestId, options));\n    } catch (error) {\n      this.pendingDueTasks.delete(requestId);\n      throw error;\n    }\n  }\n\n  public async materializeEventTasks(input: {\n    eventName: string;\n    payload?: Record<string, unknown>;\n    context: TContext;\n  }): Promise<MaterializedTaskRun[]> {\n    const requestId = generateId('task-event');\n    this.recordContext?.(input.context);\n    this.pendingTaskEvents.set(requestId, input);\n    try {\n      if (this.durableDelivery) {\n        await this.client.send({\n          id: requestId,\n          name: XPOD_TASK_EVENT,\n          data: {\n            requestId,\n            ...this.contextEventData(input.context),\n            eventName: input.eventName,\n            payload: input.payload,\n          },\n        });\n      }\n      if (!this.executeInline) {\n        return [];\n      }\n      return this.handleTaskEvent(this.createInlineEventContext(requestId, input));\n    } catch (error) {\n      this.pendingTaskEvents.delete(requestId);\n      throw error;\n    }\n  }\n\n  private async handleDueTasks(ctx: InngestCronContext): Promise<MaterializedTaskRun[]> {\n    const requestId = ctx.event?.data?.requestId;\n    const pending = requestId ? this.pendingDueTasks.get(requestId) : undefined;\n    const contexts = await this.resolveDueContexts(pending?.context, ctx.event?.data);\n    if (contexts.length === 0) {\n      return [];\n    }\n    try {\n      return await ctx.step.run('materialize-due-tasks', async () => {\n        const runs: MaterializedTaskRun[] = [];\n        for (const context of contexts) {\n          runs.push(...await this.taskService.materializeDueTasks(context, {\n            now: pending?.now ?? ctx.event?.data?.now,\n            limit: pending?.limit ?? ctx.event?.data?.limit,\n          }));\n        }\n        return runs;\n      });\n    } finally {\n      if (requestId) {\n        this.pendingDueTasks.delete(requestId);\n      }\n    }\n  }\n\n  private async handleTaskEvent(ctx: InngestTaskEventContext): Promise<MaterializedTaskRun[]> {\n    const requestId = ctx.event.data?.requestId;\n    const pending = requestId ? this.pendingTaskEvents.get(requestId) : undefined;\n    const eventName = pending?.eventName ?? ctx.event.data?.eventName;\n    if (!eventName) {\n      return [];\n    }\n    const context = pending?.context ?? await this.resolveSingleContext(ctx.event.data);\n    if (!context) {\n      return [];\n    }\n    try {\n      return await ctx.step.run('materialize-event-tasks', async () => this.taskService.materializeEventTasks({\n        eventName,\n        payload: pending?.payload ?? ctx.event.data?.payload,\n        context,\n      }));\n    } finally {\n      if (requestId) {\n        this.pendingTaskEvents.delete(requestId);\n      }\n    }\n  }\n\n  private createInlineDueContext(requestId: string, options: { now?: number; limit?: number }): InngestCronContext {\n    const pending = this.pendingDueTasks.get(requestId);\n    return {\n      event: {\n        id: requestId,\n        name: XPOD_TASK_MATERIALIZE_DUE_EVENT,\n        data: {\n          requestId,\n          now: options.now,\n          limit: options.limit,\n          ...(pending ? this.contextEventData(pending.context) : {}),\n        },\n      },\n      step: {\n        run: async <T>(_id: string, fn: () => Promise<T> | T): Promise<T> => fn(),\n      },\n    };\n  }\n\n  private createInlineEventContext(\n    requestId: string,\n    input: {\n      eventName: string;\n      payload?: Record<string, unknown>;\n    },\n  ): InngestTaskEventContext {\n    const pending = this.pendingTaskEvents.get(requestId);\n    return {\n      event: {\n        id: requestId,\n        name: XPOD_TASK_EVENT,\n        data: {\n          requestId,\n          ...(pending ? this.contextEventData(pending.context) : {}),\n          eventName: input.eventName,\n          payload: input.payload,\n        },\n      },\n      step: {\n        run: async <T>(_id: string, fn: () => Promise<T> | T): Promise<T> => fn(),\n      },\n    };\n  }\n\n  private async resolveDueContexts(\n    pendingContext: TContext | undefined,\n    eventData: XpodTaskMaterializeDueEventData | undefined,\n  ): Promise<TContext[]> {\n    if (pendingContext) {\n      return [pendingContext];\n    }\n    const eventContext = await this.resolveSingleContext(eventData);\n    if (eventContext) {\n      return [eventContext];\n    }\n    if (this.getContexts) {\n      return Array.from(await this.getContexts());\n    }\n    const fallback = this.getContext();\n    return fallback ? [fallback] : [];\n  }\n\n  private async resolveSingleContext(\n    eventData: Partial<XpodTaskMaterializeDueEventData & XpodTaskEventData> | undefined,\n  ): Promise<TContext | undefined> {\n    const resolved = eventData ? await this.resolveContext?.(eventData) : undefined;\n    return resolved ?? this.getContext();\n  }\n\n  private contextEventData(context: TContext): Partial<XpodTaskMaterializeDueEventData & XpodTaskEventData> {\n    const auth = (context as Record<string, unknown>).auth as { type?: unknown; webId?: unknown } | undefined;\n    const data: Partial<XpodTaskMaterializeDueEventData & XpodTaskEventData> = {};\n    const authBindingId = (context as Record<string, unknown>).authBindingId;\n    if (typeof authBindingId === 'string' && authBindingId.length > 0) {\n      data.authBindingId = authBindingId;\n    }\n    if (auth?.type === 'solid' && typeof auth.webId === 'string') {\n      data.webId = auth.webId;\n    }\n    return data;\n  }\n}\n"]}

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

@@ -0,0 +1,68 @@
+import type { StoreContext } from '../chatkit/store';
+export declare const TaskAuthBindingKind: {
+    readonly SOLID_CLIENT_CREDENTIALS: "solid-client-credentials";
+};
+export declare const TaskAuthBindingStatus: {
+    readonly ACTIVE: "active";
+    readonly REVOKED: "revoked";
+};
+export declare const TASK_AUTH_CREDENTIAL_SERVICE = "task-auth";
+export type TaskAuthBindingKindType = (typeof TaskAuthBindingKind)[keyof typeof TaskAuthBindingKind];
+export type TaskAuthBindingStatusType = (typeof TaskAuthBindingStatus)[keyof typeof TaskAuthBindingStatus];
+export interface TaskAuthBindingSnapshot {
+    /** Credential resource id understood by the shared Credential model. */
+    id: string;
+    kind: TaskAuthBindingKindType;
+    webId: string;
+    clientId: string;
+    displayName?: string;
+    status: TaskAuthBindingStatusType;
+    createdAt: number;
+    expiresAt?: number;
+}
+export interface CreateTaskAuthBindingInput {
+    id?: string;
+    webId?: string;
+    clientId?: string;
+    clientSecret?: string;
+    displayName?: string;
+    expiresAt?: number;
+}
+export interface TaskAuthCredentialRecord {
+    id: string;
+    service: string;
+    status: string;
+    apiKey?: string | null;
+    label?: string | null;
+    oauthExpiresAt?: string | Date | null;
+    createdAt?: string | Date | null;
+}
+export interface TaskAuthBindingRepository<TContext extends StoreContext = StoreContext> {
+    saveTaskAuthCredential(input: {
+        id: string;
+        apiKey: string;
+        displayName?: string;
+        expiresAt?: number;
+    }, context: TContext): Promise<TaskAuthCredentialRecord>;
+    loadTaskAuthCredential(id: string, context: TContext): Promise<TaskAuthCredentialRecord | undefined>;
+}
+export interface TaskAuthBindingServiceOptions<TContext extends StoreContext = StoreContext> {
+    repository: TaskAuthBindingRepository<TContext>;
+    buildContext?: (binding: TaskAuthBindingSnapshot, clientSecret: string, context: TContext) => TContext;
+}
+export declare class TaskAuthBindingService<TContext extends StoreContext = StoreContext> {
+    private readonly repository;
+    private readonly buildContext;
+    constructor(options: TaskAuthBindingServiceOptions<TContext>);
+    createBinding(input: CreateTaskAuthBindingInput, context: TContext): Promise<TaskAuthBindingSnapshot>;
+    loadBinding(id: string, context: TContext): Promise<TaskAuthBindingSnapshot>;
+    resolveRunContext(bindingId: string, context: TContext): Promise<TContext | undefined>;
+    private snapshotFromCredential;
+    private solidAuthFromContext;
+    private defaultBuildContext;
+}
+export declare function encodeClientCredentialsApiKey(clientId: string, clientSecret: string): string;
+export declare function parseClientCredentialsApiKey(value: unknown): {
+    clientId: string;
+    clientSecret: string;
+} | undefined;

package/dist/api/tasks/TaskAuthBinding.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskAuthBindingService = exports.TASK_AUTH_CREDENTIAL_SERVICE = exports.TaskAuthBindingStatus = exports.TaskAuthBindingKind = void 0;
+exports.encodeClientCredentialsApiKey = encodeClientCredentialsApiKey;
+exports.parseClientCredentialsApiKey = parseClientCredentialsApiKey;
+const node_crypto_1 = require("node:crypto");
+const AuthContext_1 = require("../auth/AuthContext");
+exports.TaskAuthBindingKind = {
+    SOLID_CLIENT_CREDENTIALS: 'solid-client-credentials',
+};
+exports.TaskAuthBindingStatus = {
+    ACTIVE: 'active',
+    REVOKED: 'revoked',
+};
+exports.TASK_AUTH_CREDENTIAL_SERVICE = 'task-auth';
+class TaskAuthBindingService {
+    constructor(options) {
+        this.repository = options.repository;
+        this.buildContext = options.buildContext ?? this.defaultBuildContext;
+    }
+    async createBinding(input, context) {
+        const auth = this.solidAuthFromContext(context);
+        const webId = input.webId ?? auth?.webId;
+        const clientId = input.clientId ?? auth?.clientId;
+        const clientSecret = input.clientSecret ?? auth?.clientSecret;
+        if (!webId) {
+            throw new Error('Task auth credential requires a Solid webId');
+        }
+        if (auth?.webId && webId !== auth.webId) {
+            throw new Error('Task auth credential webId must match the authenticated caller');
+        }
+        if (!clientId || !clientSecret) {
+            throw new Error('Task auth credential creation requires Solid client credentials');
+        }
+        const credential = await this.repository.saveTaskAuthCredential({
+            id: normalizeCredentialId(input.id) ?? `task-auth_${(0, node_crypto_1.randomUUID)()}`,
+            apiKey: encodeClientCredentialsApiKey(clientId, clientSecret),
+            displayName: input.displayName,
+            expiresAt: input.expiresAt,
+        }, context);
+        return this.snapshotFromCredential(credential, context);
+    }
+    async loadBinding(id, context) {
+        const credential = await this.repository.loadTaskAuthCredential(id, context);
+        if (!credential) {
+            throw new Error(`Task auth credential not found: ${id}`);
+        }
+        return this.snapshotFromCredential(credential, context);
+    }
+    async resolveRunContext(bindingId, context) {
+        const credential = await this.repository.loadTaskAuthCredential(bindingId, context);
+        if (!credential) {
+            return undefined;
+        }
+        const snapshot = this.snapshotFromCredential(credential, context);
+        if (snapshot.status !== exports.TaskAuthBindingStatus.ACTIVE) {
+            return undefined;
+        }
+        if (snapshot.expiresAt && snapshot.expiresAt <= nowTimestamp()) {
+            return undefined;
+        }
+        const parsed = parseClientCredentialsApiKey(credential.apiKey);
+        if (!parsed) {
+            return undefined;
+        }
+        return this.buildContext(snapshot, parsed.clientSecret, context);
+    }
+    snapshotFromCredential(credential, context) {
+        if (credential.service !== exports.TASK_AUTH_CREDENTIAL_SERVICE) {
+            throw new Error(`Credential is not a task auth credential: ${credential.id}`);
+        }
+        const parsed = parseClientCredentialsApiKey(credential.apiKey);
+        if (!parsed) {
+            throw new Error(`Task auth credential is missing client credentials: ${credential.id}`);
+        }
+        const auth = this.solidAuthFromContext(context);
+        const webId = auth?.webId;
+        if (!webId) {
+            throw new Error('Task auth credential resolution requires a Solid webId');
+        }
+        const status = credential.status === 'active'
+            ? exports.TaskAuthBindingStatus.ACTIVE
+            : exports.TaskAuthBindingStatus.REVOKED;
+        const expiresAt = isoToTimestamp(credential.oauthExpiresAt);
+        if (expiresAt && expiresAt <= nowTimestamp()) {
+            return {
+                id: credential.id,
+                kind: exports.TaskAuthBindingKind.SOLID_CLIENT_CREDENTIALS,
+                webId,
+                clientId: parsed.clientId,
+                displayName: credential.label ?? undefined,
+                status: exports.TaskAuthBindingStatus.REVOKED,
+                createdAt: isoToTimestamp(credential.createdAt) ?? nowTimestamp(),
+                expiresAt,
+            };
+        }
+        return {
+            id: credential.id,
+            kind: exports.TaskAuthBindingKind.SOLID_CLIENT_CREDENTIALS,
+            webId,
+            clientId: parsed.clientId,
+            displayName: credential.label ?? undefined,
+            status,
+            createdAt: isoToTimestamp(credential.createdAt) ?? nowTimestamp(),
+            expiresAt,
+        };
+    }
+    solidAuthFromContext(context) {
+        const auth = context.auth;
+        return auth && (0, AuthContext_1.isSolidAuth)(auth) ? auth : undefined;
+    }
+    defaultBuildContext(binding, clientSecret, context) {
+        return {
+            ...context,
+            userId: typeof context.userId === 'string' ? context.userId : binding.webId,
+            auth: {
+                type: 'solid',
+                webId: binding.webId,
+                accountId: binding.webId,
+                clientId: binding.clientId,
+                clientSecret,
+                viaApiKey: true,
+            },
+        };
+    }
+}
+exports.TaskAuthBindingService = TaskAuthBindingService;
+function encodeClientCredentialsApiKey(clientId, clientSecret) {
+    return `sk-${Buffer.from(`${clientId}:${clientSecret}`, 'utf8').toString('base64')}`;
+}
+function parseClientCredentialsApiKey(value) {
+    if (typeof value !== 'string' || !value.startsWith('sk-')) {
+        return undefined;
+    }
+    const decoded = Buffer.from(value.slice(3), 'base64').toString('utf8');
+    const separator = decoded.indexOf(':');
+    if (separator <= 0) {
+        return undefined;
+    }
+    const clientId = decoded.slice(0, separator);
+    const clientSecret = decoded.slice(separator + 1);
+    return clientId && clientSecret ? { clientId, clientSecret } : undefined;
+}
+function normalizeCredentialId(value) {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    return trimmed.startsWith('#') ? trimmed.slice(1) : trimmed;
+}
+function isoToTimestamp(value) {
+    if (!value) {
+        return undefined;
+    }
+    const date = value instanceof Date ? value : new Date(value);
+    const time = date.getTime();
+    return Number.isNaN(time) ? undefined : Math.floor(time / 1000);
+}
+function nowTimestamp() {
+    return Math.floor(Date.now() / 1000);
+}
+//# sourceMappingURL=TaskAuthBinding.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskAuthBinding.js","sourceRoot":"","sources":["../../../src/api/tasks/TaskAuthBinding.ts"],"names":[],"mappings":";;;AAoMA,sEAEC;AAED,oEAYC;AApND,6CAAyC;AAGzC,qDAAkD;AAErC,QAAA,mBAAmB,GAAG;IACjC,wBAAwB,EAAE,0BAA0B;CAC5C,CAAC;AAEE,QAAA,qBAAqB,GAAG;IACnC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC;AAEE,QAAA,4BAA4B,GAAG,WAAW,CAAC;AAmDxD,MAAa,sBAAsB;IAIjC,YAAmB,OAAgD;QACjE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,mBAAmB,CAAC;IACvE,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,KAAiC,EAAE,OAAiB;QAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,KAAK,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,EAAE,QAAQ,CAAC;QAClD,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,IAAI,EAAE,YAAY,CAAC;QAE9D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,EAAE,KAAK,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAC9D,EAAE,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,aAAa,IAAA,wBAAU,GAAE,EAAE;YAClE,MAAM,EAAE,6BAA6B,CAAC,QAAQ,EAAE,YAAY,CAAC;YAC7D,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,EAAE,OAAO,CAAC,CAAC;QAEZ,OAAO,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,EAAU,EAAE,OAAiB;QACpD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,SAAiB,EAAE,OAAiB;QACjE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,6BAAqB,CAAC,MAAM,EAAE,CAAC;YACrD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,IAAI,YAAY,EAAE,EAAE,CAAC;YAC/D,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,4BAA4B,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAEO,sBAAsB,CAC5B,UAAoC,EACpC,OAAiB;QAEjB,IAAI,UAAU,CAAC,OAAO,KAAK,oCAA4B,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,6CAA6C,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,MAAM,GAAG,4BAA4B,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uDAAuD,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,KAAK,QAAQ;YAC3C,CAAC,CAAC,6BAAqB,CAAC,MAAM;YAC9B,CAAC,CAAC,6BAAqB,CAAC,OAAO,CAAC;QAClC,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,SAAS,IAAI,SAAS,IAAI,YAAY,EAAE,EAAE,CAAC;YAC7C,OAAO;gBACL,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,IAAI,EAAE,2BAAmB,CAAC,wBAAwB;gBAClD,KAAK;gBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,UAAU,CAAC,KAAK,IAAI,SAAS;gBAC1C,MAAM,EAAE,6BAAqB,CAAC,OAAO;gBACrC,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,YAAY,EAAE;gBACjE,SAAS;aACV,CAAC;QACJ,CAAC;QAED,OAAO;YACL,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,IAAI,EAAE,2BAAmB,CAAC,wBAAwB;YAClD,KAAK;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,UAAU,CAAC,KAAK,IAAI,SAAS;YAC1C,MAAM;YACN,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,YAAY,EAAE;YACjE,SAAS;SACV,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,OAAiB;QAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAoC,CAAC;QAC1D,OAAO,IAAI,IAAI,IAAA,yBAAW,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC;IAEO,mBAAmB,CAAC,OAAgC,EAAE,YAAoB,EAAE,OAAiB;QACnG,OAAO;YACL,GAAG,OAAO;YACV,MAAM,EAAE,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;YAC3E,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,SAAS,EAAE,OAAO,CAAC,KAAK;gBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,YAAY;gBACZ,SAAS,EAAE,IAAI;aAChB;SACqB,CAAC;IAC3B,CAAC;CACF;AAjID,wDAiIC;AAED,SAAgB,6BAA6B,CAAC,QAAgB,EAAE,YAAoB;IAClF,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,YAAY,EAAE,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AACvF,CAAC;AAED,SAAgB,4BAA4B,CAAC,KAAc;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAClD,OAAO,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAyB;IACtD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9D,CAAC;AAED,SAAS,cAAc,CAAC,KAAuC;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AACvC,CAAC","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { StoreContext } from '../chatkit/store';\nimport type { SolidAuthContext } from '../auth/AuthContext';\nimport { isSolidAuth } from '../auth/AuthContext';\n\nexport const TaskAuthBindingKind = {\n  SOLID_CLIENT_CREDENTIALS: 'solid-client-credentials',\n} as const;\n\nexport const TaskAuthBindingStatus = {\n  ACTIVE: 'active',\n  REVOKED: 'revoked',\n} as const;\n\nexport const TASK_AUTH_CREDENTIAL_SERVICE = 'task-auth';\n\nexport type TaskAuthBindingKindType = (typeof TaskAuthBindingKind)[keyof typeof TaskAuthBindingKind];\nexport type TaskAuthBindingStatusType = (typeof TaskAuthBindingStatus)[keyof typeof TaskAuthBindingStatus];\n\nexport interface TaskAuthBindingSnapshot {\n  /** Credential resource id understood by the shared Credential model. */\n  id: string;\n  kind: TaskAuthBindingKindType;\n  webId: string;\n  clientId: string;\n  displayName?: string;\n  status: TaskAuthBindingStatusType;\n  createdAt: number;\n  expiresAt?: number;\n}\n\nexport interface CreateTaskAuthBindingInput {\n  id?: string;\n  webId?: string;\n  clientId?: string;\n  clientSecret?: string;\n  displayName?: string;\n  expiresAt?: number;\n}\n\nexport interface TaskAuthCredentialRecord {\n  id: string;\n  service: string;\n  status: string;\n  apiKey?: string | null;\n  label?: string | null;\n  oauthExpiresAt?: string | Date | null;\n  createdAt?: string | Date | null;\n}\n\nexport interface TaskAuthBindingRepository<TContext extends StoreContext = StoreContext> {\n  saveTaskAuthCredential(input: {\n    id: string;\n    apiKey: string;\n    displayName?: string;\n    expiresAt?: number;\n  }, context: TContext): Promise<TaskAuthCredentialRecord>;\n  loadTaskAuthCredential(id: string, context: TContext): Promise<TaskAuthCredentialRecord | undefined>;\n}\n\nexport interface TaskAuthBindingServiceOptions<TContext extends StoreContext = StoreContext> {\n  repository: TaskAuthBindingRepository<TContext>;\n  buildContext?: (binding: TaskAuthBindingSnapshot, clientSecret: string, context: TContext) => TContext;\n}\n\nexport class TaskAuthBindingService<TContext extends StoreContext = StoreContext> {\n  private readonly repository: TaskAuthBindingRepository<TContext>;\n  private readonly buildContext: (binding: TaskAuthBindingSnapshot, clientSecret: string, context: TContext) => TContext;\n\n  public constructor(options: TaskAuthBindingServiceOptions<TContext>) {\n    this.repository = options.repository;\n    this.buildContext = options.buildContext ?? this.defaultBuildContext;\n  }\n\n  public async createBinding(input: CreateTaskAuthBindingInput, context: TContext): Promise<TaskAuthBindingSnapshot> {\n    const auth = this.solidAuthFromContext(context);\n    const webId = input.webId ?? auth?.webId;\n    const clientId = input.clientId ?? auth?.clientId;\n    const clientSecret = input.clientSecret ?? auth?.clientSecret;\n\n    if (!webId) {\n      throw new Error('Task auth credential requires a Solid webId');\n    }\n    if (auth?.webId && webId !== auth.webId) {\n      throw new Error('Task auth credential webId must match the authenticated caller');\n    }\n    if (!clientId || !clientSecret) {\n      throw new Error('Task auth credential creation requires Solid client credentials');\n    }\n\n    const credential = await this.repository.saveTaskAuthCredential({\n      id: normalizeCredentialId(input.id) ?? `task-auth_${randomUUID()}`,\n      apiKey: encodeClientCredentialsApiKey(clientId, clientSecret),\n      displayName: input.displayName,\n      expiresAt: input.expiresAt,\n    }, context);\n\n    return this.snapshotFromCredential(credential, context);\n  }\n\n  public async loadBinding(id: string, context: TContext): Promise<TaskAuthBindingSnapshot> {\n    const credential = await this.repository.loadTaskAuthCredential(id, context);\n    if (!credential) {\n      throw new Error(`Task auth credential not found: ${id}`);\n    }\n    return this.snapshotFromCredential(credential, context);\n  }\n\n  public async resolveRunContext(bindingId: string, context: TContext): Promise<TContext | undefined> {\n    const credential = await this.repository.loadTaskAuthCredential(bindingId, context);\n    if (!credential) {\n      return undefined;\n    }\n    const snapshot = this.snapshotFromCredential(credential, context);\n    if (snapshot.status !== TaskAuthBindingStatus.ACTIVE) {\n      return undefined;\n    }\n    if (snapshot.expiresAt && snapshot.expiresAt <= nowTimestamp()) {\n      return undefined;\n    }\n    const parsed = parseClientCredentialsApiKey(credential.apiKey);\n    if (!parsed) {\n      return undefined;\n    }\n    return this.buildContext(snapshot, parsed.clientSecret, context);\n  }\n\n  private snapshotFromCredential(\n    credential: TaskAuthCredentialRecord,\n    context: TContext,\n  ): TaskAuthBindingSnapshot {\n    if (credential.service !== TASK_AUTH_CREDENTIAL_SERVICE) {\n      throw new Error(`Credential is not a task auth credential: ${credential.id}`);\n    }\n\n    const parsed = parseClientCredentialsApiKey(credential.apiKey);\n    if (!parsed) {\n      throw new Error(`Task auth credential is missing client credentials: ${credential.id}`);\n    }\n\n    const auth = this.solidAuthFromContext(context);\n    const webId = auth?.webId;\n    if (!webId) {\n      throw new Error('Task auth credential resolution requires a Solid webId');\n    }\n\n    const status = credential.status === 'active'\n      ? TaskAuthBindingStatus.ACTIVE\n      : TaskAuthBindingStatus.REVOKED;\n    const expiresAt = isoToTimestamp(credential.oauthExpiresAt);\n    if (expiresAt && expiresAt <= nowTimestamp()) {\n      return {\n        id: credential.id,\n        kind: TaskAuthBindingKind.SOLID_CLIENT_CREDENTIALS,\n        webId,\n        clientId: parsed.clientId,\n        displayName: credential.label ?? undefined,\n        status: TaskAuthBindingStatus.REVOKED,\n        createdAt: isoToTimestamp(credential.createdAt) ?? nowTimestamp(),\n        expiresAt,\n      };\n    }\n\n    return {\n      id: credential.id,\n      kind: TaskAuthBindingKind.SOLID_CLIENT_CREDENTIALS,\n      webId,\n      clientId: parsed.clientId,\n      displayName: credential.label ?? undefined,\n      status,\n      createdAt: isoToTimestamp(credential.createdAt) ?? nowTimestamp(),\n      expiresAt,\n    };\n  }\n\n  private solidAuthFromContext(context: TContext): SolidAuthContext | undefined {\n    const auth = context.auth as SolidAuthContext | undefined;\n    return auth && isSolidAuth(auth) ? auth : undefined;\n  }\n\n  private defaultBuildContext(binding: TaskAuthBindingSnapshot, clientSecret: string, context: TContext): TContext {\n    return {\n      ...context,\n      userId: typeof context.userId === 'string' ? context.userId : binding.webId,\n      auth: {\n        type: 'solid',\n        webId: binding.webId,\n        accountId: binding.webId,\n        clientId: binding.clientId,\n        clientSecret,\n        viaApiKey: true,\n      },\n    } as unknown as TContext;\n  }\n}\n\nexport function encodeClientCredentialsApiKey(clientId: string, clientSecret: string): string {\n  return `sk-${Buffer.from(`${clientId}:${clientSecret}`, 'utf8').toString('base64')}`;\n}\n\nexport function parseClientCredentialsApiKey(value: unknown): { clientId: string; clientSecret: string } | undefined {\n  if (typeof value !== 'string' || !value.startsWith('sk-')) {\n    return undefined;\n  }\n  const decoded = Buffer.from(value.slice(3), 'base64').toString('utf8');\n  const separator = decoded.indexOf(':');\n  if (separator <= 0) {\n    return undefined;\n  }\n  const clientId = decoded.slice(0, separator);\n  const clientSecret = decoded.slice(separator + 1);\n  return clientId && clientSecret ? { clientId, clientSecret } : undefined;\n}\n\nfunction normalizeCredentialId(value: string | undefined): string | undefined {\n  const trimmed = value?.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n  return trimmed.startsWith('#') ? trimmed.slice(1) : trimmed;\n}\n\nfunction isoToTimestamp(value: string | Date | null | undefined): number | undefined {\n  if (!value) {\n    return undefined;\n  }\n  const date = value instanceof Date ? value : new Date(value);\n  const time = date.getTime();\n  return Number.isNaN(time) ? undefined : Math.floor(time / 1000);\n}\n\nfunction nowTimestamp(): number {\n  return Math.floor(Date.now() / 1000);\n}\n"]}

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

@@ -0,0 +1,55 @@
+import type { ChatKitStore, StoreContext } from '../chatkit/store';
+import type { ThreadItem } from '../chatkit/types';
+import type { RunExecutionBackend } from '../runs/RunExecutionBackend';
+import { type RunRecordData, type RunStore } from '../runs/store';
+import { type TaskRecordData } from './store';
+export interface MaterializedTaskRun {
+    task: TaskRecordData;
+    run: RunRecordData;
+    assistant?: ThreadItem;
+}
+export interface TaskMaterializerOptions<TContext = StoreContext> {
+    store: ChatKitStore<TContext> & RunStore<TContext>;
+    executionBackend?: RunExecutionBackend;
+    executeRuns?: boolean;
+}
+export declare class TaskMaterializer<TContext = StoreContext> {
+    private readonly store;
+    private readonly executionBackend;
+    private readonly executeRuns;
+    constructor(options: TaskMaterializerOptions<TContext>);
+    materialize(input: {
+        task: TaskRecordData;
+        context: TContext;
+        trigger: {
+            kind: 'once' | 'interval' | 'cron' | 'event' | 'manual';
+            scheduledFor?: number;
+            eventName?: string;
+            payload?: Record<string, unknown>;
+        };
+    }): Promise<MaterializedTaskRun>;
+    private executeRun;
+    private ensureThread;
+    private createRun;
+    private markRunStarted;
+    private finishRun;
+    private isWaitingStatus;
+    private stepTypeForStatus;
+    private appendRunStep;
+    private createUserMessage;
+    private buildPrompt;
+    private createAssistantMessage;
+    private loadConversation;
+    private buildRuntimeConfig;
+    private parseRunner;
+    private isRunnerType;
+    private computeNextIntervalRunAt;
+    private computeNextCronRunAt;
+    private threadRefFromTask;
+    private parseThreadUri;
+    private extractThreadId;
+    private resolveTaskUri;
+    private resolveRunUri;
+    private resolvePodBaseUrl;
+    private hasSaveTask;
+}