@kelpie/server 0.1.0

package/dist/modules/agent-tasks/routes.js

@@ -0,0 +1,173 @@
+import { AGENT_RUN_STATUSES, AGENT_TASK_TARGET_TYPES } from '@kelpie/schemas';
+import { z } from 'zod';
+import { AppError } from '../../lib/errors.js';
+import { pageBody, readJsonBody, readListParameters } from '../../lib/http.js';
+import { endpointUrlProblem } from '../../lib/url.js';
+import { resolveActorFrom } from '../auth/credentials.js';
+import { resolvedTaskResponse } from './wire.js';
+/**
+ * Wire shapes for `/v1/agent-tasks`, `/v1/agent-runs` and `/v1/agents`.
+ *
+ * Bodies are strict: `api.md` makes an unknown field a 422 rather than
+ * something dropped in silence. Everything is `snake_case` on the wire —
+ * `agent-tasks.md`'s examples predate that convention and `api.md` wins.
+ */
+const CREDENTIALS_MESSAGE = 'Remove the credentials from the URL; use auth_header instead';
+const endpointField = z
+    .string()
+    .refine((value) => endpointUrlProblem(value, CREDENTIALS_MESSAGE) === undefined, {
+    error: (issue) => endpointUrlProblem(String(issue.input), CREDENTIALS_MESSAGE)?.message ?? 'Invalid URL',
+});
+const targetTypeField = z.enum(AGENT_TASK_TARGET_TYPES);
+export const resolveBody = z.strictObject({
+    target_type: targetTypeField,
+    target_id: z.string().min(1),
+});
+export const runBody = z.strictObject({
+    target_type: targetTypeField,
+    target_id: z.string().min(1),
+    agent_id: z.string().min(1),
+});
+export const createAgentBody = z.strictObject({
+    name: z.string().min(1),
+    endpoint: endpointField,
+    auth_header: z.string().min(1).optional(),
+});
+/** `auth_header: null` clears the stored header; a string replaces it. */
+export const updateAgentBody = z
+    .strictObject({
+    name: z.string().min(1),
+    endpoint: endpointField,
+    auth_header: z.string().min(1).nullable(),
+})
+    .partial();
+export function taskDefinitionResponse(definition) {
+    return {
+        id: definition.id,
+        label: definition.label,
+        description: definition.description,
+        target_types: definition.targetTypes,
+        placement: definition.placement,
+        handbook_slugs: definition.handbookSlugs,
+        instructions: definition.instructions,
+        write_policy: definition.writePolicy,
+    };
+}
+export function agentResponse(agent) {
+    return {
+        id: agent.id,
+        name: agent.name,
+        endpoint: agent.endpoint,
+        has_auth_header: agent.hasAuthHeader,
+        last_run_at: agent.lastRunAt === null ? null : agent.lastRunAt.toISOString(),
+        created_at: agent.createdAt.toISOString(),
+        updated_at: agent.updatedAt.toISOString(),
+    };
+}
+export function runResponse(run) {
+    return {
+        id: run.id,
+        agent_id: run.agentId,
+        task_id: run.taskId,
+        target_type: run.targetType,
+        target_id: run.targetId,
+        status: run.status,
+        prompt: run.prompt,
+        failure_reason: run.failureReason,
+        created_at: run.createdAt.toISOString(),
+        updated_at: run.updatedAt.toISOString(),
+    };
+}
+/**
+ * Reads an optional query value against a fixed list.
+ *
+ * @throws AppError 422 for a value outside the list. Answering it with an empty
+ *   result would read as "none of those" rather than "no such value".
+ */
+function readEnumFilter(context, name, values) {
+    const raw = context.req.query(name);
+    if (raw === undefined) {
+        return undefined;
+    }
+    const parsed = z.enum(values).safeParse(raw);
+    if (!parsed.success) {
+        throw AppError.validationFailed(`That is not a ${name.replace('_', ' ')}`, [
+            { field: name, message: `Use one of: ${values.join(', ')}` },
+        ]);
+    }
+    return parsed.data;
+}
+/** A blank id filter asks a different question than the one intended, per `api.md`. */
+function readIdQuery(context, name) {
+    const raw = context.req.query(name);
+    if (raw === undefined) {
+        return undefined;
+    }
+    if (raw.length === 0) {
+        throw AppError.validationFailed(`${name} must not be blank`, [
+            { field: name, message: 'Provide an id or omit the parameter' },
+        ]);
+    }
+    return raw;
+}
+export function mountAgentTasksRoutes(router, dependencies) {
+    const requireActor = (context) => resolveActorFrom(dependencies, context);
+    /**
+     * The catalog, optionally narrowed to one target type. Code, not rows: the
+     * whole list rides in one response with no cursor, the `/v1/mcp/tools` shape.
+     */
+    router.get('/agent-tasks', async (context) => {
+        const targetType = readEnumFilter(context, 'target_type', AGENT_TASK_TARGET_TYPES);
+        const tasks = await dependencies.service.listTasks(await requireActor(context), targetType);
+        return context.json({ data: tasks.map(taskDefinitionResponse), next_cursor: null });
+    });
+    router.post('/agent-tasks/:taskId/resolve', async (context) => {
+        const body = await readJsonBody(context, resolveBody);
+        const resolved = await dependencies.service.resolve(await requireActor(context), context.req.param('taskId'), { targetType: body.target_type, targetId: body.target_id });
+        return context.json(resolvedTaskResponse(resolved));
+    });
+    /** Creates the run and answers `queued`; the dispatch happens after. */
+    router.post('/agent-tasks/:taskId/run', async (context) => {
+        const body = await readJsonBody(context, runBody);
+        const run = await dependencies.service.run(await requireActor(context), context.req.param('taskId'), { targetType: body.target_type, targetId: body.target_id, agentId: body.agent_id });
+        return context.json(runResponse(run), 201);
+    });
+    router.get('/agent-runs', async (context) => {
+        const page = await dependencies.service.listRuns(await requireActor(context), {
+            agentId: readIdQuery(context, 'agent_id'),
+            status: readEnumFilter(context, 'status', AGENT_RUN_STATUSES),
+        }, readListParameters(context));
+        return context.json(pageBody(page, runResponse));
+    });
+    router.get('/agent-runs/:id', async (context) => {
+        const run = await dependencies.service.getRun(await requireActor(context), context.req.param('id'));
+        return context.json(runResponse(run));
+    });
+    router.get('/agents', async (context) => {
+        const page = await dependencies.service.listAgents(await requireActor(context), readListParameters(context));
+        return context.json(pageBody(page, agentResponse));
+    });
+    router.post('/agents', async (context) => {
+        const body = await readJsonBody(context, createAgentBody);
+        const agent = await dependencies.service.createAgent(await requireActor(context), {
+            name: body.name,
+            endpoint: body.endpoint,
+            authHeader: body.auth_header,
+        });
+        return context.json(agentResponse(agent), 201);
+    });
+    router.get('/agents/:id', async (context) => {
+        const agent = await dependencies.service.getAgent(await requireActor(context), context.req.param('id'));
+        return context.json(agentResponse(agent));
+    });
+    router.patch('/agents/:id', async (context) => {
+        const body = await readJsonBody(context, updateAgentBody);
+        const agent = await dependencies.service.updateAgent(await requireActor(context), context.req.param('id'), { name: body.name, endpoint: body.endpoint, authHeader: body.auth_header });
+        return context.json(agentResponse(agent));
+    });
+    router.delete('/agents/:id', async (context) => {
+        await dependencies.service.removeAgent(await requireActor(context), context.req.param('id'));
+        return context.body(null, 204);
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/modules/agent-tasks/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/modules/agent-tasks/routes.ts"],"names":[],"mappings":"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"}

package/dist/modules/agent-tasks/schema.d.ts

@@ -0,0 +1,346 @@
+/**
+ * Agents the workspace has registered to receive task dispatches. Kelpie bundles
+ * no AI; these are the customer's own agents.
+ */
+export declare const agentRegistrations: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "agent_registrations";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "agent_registrations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "agent_registrations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: import("drizzle-orm/pg-core").PgColumn<{
+            name: "name";
+            tableName: "agent_registrations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        endpoint: import("drizzle-orm/pg-core").PgColumn<{
+            name: "endpoint";
+            tableName: "agent_registrations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        authHeaderEncrypted: import("drizzle-orm/pg-core").PgColumn<{
+            name: "auth_header_encrypted";
+            tableName: "agent_registrations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastRunAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "agent_registrations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "agent_registrations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "agent_registrations";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;
+/**
+ * `task_id` is a catalog string, not a foreign key: the task catalog ships in
+ * code, so a run outlives any catalog edit.
+ */
+export declare const agentRuns: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "agent_runs";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        agentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "agent_id";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        taskId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "task_id";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        targetType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "target_type";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        targetId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "target_id";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        prompt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "prompt";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        failureReason: import("drizzle-orm/pg-core").PgColumn<{
+            name: "failure_reason";
+            tableName: "agent_runs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "agent_runs";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "agent_runs";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/modules/agent-tasks/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-tasks/schema.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe9B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBrB,CAAA"}

package/dist/modules/agent-tasks/schema.js

@@ -0,0 +1,47 @@
+import { AGENT_RUN_STATUSES } from '@kelpie/schemas';
+import { index, pgTable, text } from 'drizzle-orm/pg-core';
+import { checkOneOf, createdAt, moment, primaryId, updatedAt } from '../../lib/columns.js';
+import { workspaces } from '../workspace/schema.js';
+/**
+ * Agents the workspace has registered to receive task dispatches. Kelpie bundles
+ * no AI; these are the customer's own agents.
+ */
+export const agentRegistrations = pgTable('agent_registrations', {
+    id: primaryId(),
+    workspaceId: text('workspace_id')
+        .notNull()
+        .references(() => workspaces.id, { onDelete: 'cascade' }),
+    name: text('name').notNull(),
+    endpoint: text('endpoint').notNull(),
+    authHeaderEncrypted: text('auth_header_encrypted'),
+    lastRunAt: moment('last_run_at'),
+    createdAt: createdAt(),
+    updatedAt: updatedAt(),
+}, (table) => [index('agent_registrations_workspace_idx').on(table.workspaceId)]);
+/**
+ * `task_id` is a catalog string, not a foreign key: the task catalog ships in
+ * code, so a run outlives any catalog edit.
+ */
+export const agentRuns = pgTable('agent_runs', {
+    id: primaryId(),
+    workspaceId: text('workspace_id')
+        .notNull()
+        .references(() => workspaces.id, { onDelete: 'cascade' }),
+    agentId: text('agent_id')
+        .notNull()
+        .references(() => agentRegistrations.id, { onDelete: 'cascade' }),
+    taskId: text('task_id').notNull(),
+    targetType: text('target_type').notNull(),
+    targetId: text('target_id').notNull(),
+    status: text('status').notNull().default('queued'),
+    prompt: text('prompt').notNull(),
+    /** Set only on `failed`: what the dispatch hit, for the run log. */
+    failureReason: text('failure_reason'),
+    createdAt: createdAt(),
+    updatedAt: updatedAt(),
+}, (table) => [
+    index('agent_runs_workspace_idx').on(table.workspaceId),
+    index('agent_runs_agent_idx').on(table.agentId),
+    checkOneOf('agent_runs_status_check', table.status, AGENT_RUN_STATUSES),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/modules/agent-tasks/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/modules/agent-tasks/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CACvC,qBAAqB,EACrB;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC3D,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACpC,mBAAmB,EAAE,IAAI,CAAC,uBAAuB,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC,aAAa,CAAC;IAChC,SAAS,EAAE,SAAS,EAAE;IACtB,SAAS,EAAE,SAAS,EAAE;CACvB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAC9E,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAC9B,YAAY,EACZ;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC3D,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;SACtB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACnE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IACjC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IAClD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,oEAAoE;IACpE,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,SAAS,EAAE,SAAS,EAAE;IACtB,SAAS,EAAE,SAAS,EAAE;CACvB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;IACvD,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;IAC/C,UAAU,CAAC,yBAAyB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACxE,CACF,CAAA"}

package/dist/modules/agent-tasks/service.d.ts

@@ -0,0 +1,79 @@
+import type { AgentRunStatus, AgentTaskDefinition, AgentTaskTargetType } from '@kelpie/schemas';
+import type { Database } from '../../lib/database.ts';
+import type { IdFactory } from '../../lib/ids.ts';
+import type { Logger } from '../../lib/logger.ts';
+import type { ListQueryParameters, Page } from '../../lib/pagination.ts';
+import type { SecretCipher } from '../../lib/secrets.ts';
+import type { TransactionScope } from '../../runtime/transaction.ts';
+import type { Actor } from '../auth/actor.ts';
+import type { DispatchEngine } from './dispatch.ts';
+import type { RunRecord } from './repository.ts';
+import type { ResolvedTaskView } from './wire.ts';
+/**
+ * Agent tasks: the catalog, resolve, run dispatch, and registered agents.
+ *
+ * Roles split by verb, deliberately not the webhooks all-verbs-admin rule.
+ * Managing a registration is admin work — its endpoint is where workspace data
+ * gets POSTed. But *reading* the list is what the Run dialog on every record
+ * page does, and running a task is the product's core loop, so members read
+ * agents, resolve tasks, run them, and read the run log. The auth header is the
+ * one secret in the module and it is sealed and never returned, so a member
+ * reading the list learns an endpoint name, not a credential.
+ */
+export interface AgentTasksDependencies {
+    readonly db: Database;
+    readonly transaction: TransactionScope;
+    readonly createId: IdFactory;
+    readonly now: () => Date;
+    readonly cipher: SecretCipher;
+    readonly engine: DispatchEngine;
+    readonly log: Logger;
+}
+/** An agent as the API returns one: never the header, never the tenancy column. */
+export interface AgentView {
+    readonly id: string;
+    readonly name: string;
+    readonly endpoint: string;
+    readonly hasAuthHeader: boolean;
+    readonly lastRunAt: Date | null;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+}
+export type RunView = Omit<RunRecord, 'workspaceId'>;
+export interface ResolveTargetInput {
+    readonly targetType: AgentTaskTargetType;
+    readonly targetId: string;
+}
+export interface RunTaskInput extends ResolveTargetInput {
+    readonly agentId: string;
+}
+export interface CreateAgentInput {
+    readonly name: string;
+    readonly endpoint: string;
+    readonly authHeader?: string | undefined;
+}
+export interface UpdateAgentInput {
+    readonly name?: string | undefined;
+    readonly endpoint?: string | undefined;
+    /** A string replaces the stored header; `null` clears it. */
+    readonly authHeader?: string | null | undefined;
+}
+export interface RunListFilters {
+    readonly agentId?: string | undefined;
+    readonly status?: AgentRunStatus | undefined;
+}
+export interface AgentTasksService {
+    listTasks(actor: Actor, targetType?: AgentTaskTargetType): Promise<readonly AgentTaskDefinition[]>;
+    resolve(actor: Actor, taskId: string, target: ResolveTargetInput): Promise<ResolvedTaskView>;
+    /** Creates the run, answers `queued`, and dispatches after the transaction commits. */
+    run(actor: Actor, taskId: string, input: RunTaskInput): Promise<RunView>;
+    getRun(actor: Actor, id: string): Promise<RunView>;
+    listRuns(actor: Actor, filters: RunListFilters, query: ListQueryParameters): Promise<Page<RunView>>;
+    listAgents(actor: Actor, query: ListQueryParameters): Promise<Page<AgentView>>;
+    getAgent(actor: Actor, id: string): Promise<AgentView>;
+    createAgent(actor: Actor, input: CreateAgentInput): Promise<AgentView>;
+    updateAgent(actor: Actor, id: string, changes: UpdateAgentInput): Promise<AgentView>;
+    removeAgent(actor: Actor, id: string): Promise<void>;
+}
+export declare function createAgentTasksService(dependencies: AgentTasksDependencies): AgentTasksService;
+//# sourceMappingURL=service.d.ts.map