@kelpie/server 0.1.0

package/dist/modules/activities/routes.js

@@ -0,0 +1,45 @@
+import { AppError } from '../../lib/errors.js';
+import { pageBody, readListParameters } from '../../lib/http.js';
+import { resolveActorFrom } from '../auth/credentials.js';
+import { isRecordTargetType } from '../recordTargets.js';
+export function activityResponse(activity) {
+    return {
+        id: activity.id,
+        target_type: activity.targetType,
+        target_id: activity.targetId,
+        kind: activity.kind,
+        actor_member_id: activity.actorMemberId,
+        actor_label: activity.actorLabel,
+        action: activity.action,
+        detail: activity.detail,
+        created_at: activity.createdAt.toISOString(),
+    };
+}
+/**
+ * @throws AppError 422 when either half of the target is missing or the type is
+ *   not one a record can be attached to.
+ */
+function readTarget(context) {
+    const targetType = context.req.query('target_type');
+    const targetId = context.req.query('target_id');
+    if (targetType === undefined || targetId === undefined || targetId.length === 0) {
+        throw AppError.validationFailed('A timeline is always a timeline of something', [
+            { field: 'target_type', message: 'Required' },
+            { field: 'target_id', message: 'Required' },
+        ]);
+    }
+    if (!isRecordTargetType(targetType)) {
+        throw AppError.validationFailed('That is not a record type activity attaches to', [
+            { field: 'target_type', message: `Unknown target type "${targetType}"` },
+        ]);
+    }
+    return { targetType, targetId };
+}
+export function mountActivitiesRoutes(router, dependencies) {
+    const requireActor = (context) => resolveActorFrom(dependencies, context);
+    router.get('/activities', async (context) => {
+        const page = await dependencies.service.list(await requireActor(context), readTarget(context), readListParameters(context));
+        return context.json(pageBody(page, activityResponse));
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/modules/activities/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/modules/activities/routes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAiBxD,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IACrD,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,WAAW,EAAE,QAAQ,CAAC,UAAU;QAChC,SAAS,EAAE,QAAQ,CAAC,QAAQ;QAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,eAAe,EAAE,QAAQ,CAAC,aAAa;QACvC,WAAW,EAAE,QAAQ,CAAC,UAAU;QAChC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE;KAC7C,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,OAAgB;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IAE/C,IAAI,UAAU,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChF,MAAM,QAAQ,CAAC,gBAAgB,CAAC,8CAA8C,EAAE;YAC9E,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE;YAC7C,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE;SAC5C,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,QAAQ,CAAC,gBAAgB,CAAC,gDAAgD,EAAE;YAChF,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,wBAAwB,UAAU,GAAG,EAAE;SACzE,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAY,EACZ,YAA0C;IAE1C,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAkB,EAAE,CAAC,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IAElG,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAC1C,MAAM,YAAY,CAAC,OAAO,CAAC,EAC3B,UAAU,CAAC,OAAO,CAAC,EACnB,kBAAkB,CAAC,OAAO,CAAC,CAC5B,CAAA;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/modules/activities/schema.d.ts

@@ -0,0 +1,188 @@
+/** Re-exported for the routes and service that constrain themselves to this table. */
+export { ACTIVITY_KINDS } from '@kelpie/schemas';
+export type { ActivityKind } from '@kelpie/schemas';
+/**
+ * System history, rolled up onto person and company timelines. Append-only: there
+ * is no update route and no `updated_at`.
+ *
+ * `actor_label` carries the display name when there is no member behind the
+ * action, e.g. "Form" or "Gmail".
+ */
+export declare const activities: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "activities";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "activities";
+            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: "activities";
+            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: "activities";
+            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: "activities";
+            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;
+        }, {}, {}>;
+        kind: import("drizzle-orm/pg-core").PgColumn<{
+            name: "kind";
+            tableName: "activities";
+            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;
+        }, {}, {}>;
+        actorMemberId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_member_id";
+            tableName: "activities";
+            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;
+        }, {}, {}>;
+        actorLabel: import("drizzle-orm/pg-core").PgColumn<{
+            name: "actor_label";
+            tableName: "activities";
+            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;
+        }, {}, {}>;
+        action: import("drizzle-orm/pg-core").PgColumn<{
+            name: "action";
+            tableName: "activities";
+            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;
+        }, {}, {}>;
+        detail: import("drizzle-orm/pg-core").PgColumn<{
+            name: "detail";
+            tableName: "activities";
+            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: "activities";
+            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/activities/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/activities/schema.ts"],"names":[],"mappings":"AAMA,sFAAsF;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBtB,CAAA"}

package/dist/modules/activities/schema.js

@@ -0,0 +1,34 @@
+import { ACTIVITY_KINDS, RECORD_TARGET_TYPES } from '@kelpie/schemas';
+import { index, pgTable, text } from 'drizzle-orm/pg-core';
+import { checkOneOf, createdAt, primaryId } from '../../lib/columns.js';
+import { workspaceMembers, workspaces } from '../workspace/schema.js';
+/** Re-exported for the routes and service that constrain themselves to this table. */
+export { ACTIVITY_KINDS } from '@kelpie/schemas';
+/**
+ * System history, rolled up onto person and company timelines. Append-only: there
+ * is no update route and no `updated_at`.
+ *
+ * `actor_label` carries the display name when there is no member behind the
+ * action, e.g. "Form" or "Gmail".
+ */
+export const activities = pgTable('activities', {
+    id: primaryId(),
+    workspaceId: text('workspace_id')
+        .notNull()
+        .references(() => workspaces.id, { onDelete: 'cascade' }),
+    targetType: text('target_type').notNull(),
+    targetId: text('target_id').notNull(),
+    kind: text('kind').notNull(),
+    actorMemberId: text('actor_member_id').references(() => workspaceMembers.id, {
+        onDelete: 'set null',
+    }),
+    actorLabel: text('actor_label'),
+    action: text('action').notNull(),
+    detail: text('detail'),
+    createdAt: createdAt(),
+}, (table) => [
+    index('activities_target_idx').on(table.workspaceId, table.targetType, table.targetId),
+    checkOneOf('activities_target_type_check', table.targetType, RECORD_TARGET_TYPES),
+    checkOneOf('activities_kind_check', table.kind, ACTIVITY_KINDS),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/modules/activities/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/modules/activities/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAErE,sFAAsF;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAC/B,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,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACrC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,aAAa,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE;QAC3E,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;IAC/B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;IACtB,SAAS,EAAE,SAAS,EAAE;CACvB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;IACtF,UAAU,CAAC,8BAA8B,EAAE,KAAK,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACjF,UAAU,CAAC,uBAAuB,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC;CAChE,CACF,CAAA"}

package/dist/modules/activities/service.d.ts

@@ -0,0 +1,32 @@
+import type { Database } from '../../lib/database.ts';
+import type { ListQueryParameters, Page } from '../../lib/pagination.ts';
+import type { Actor } from '../auth/actor.ts';
+import type { RecordTargetType } from '../recordTargets.ts';
+import type { ActivityRecord } from './repository.ts';
+/**
+ * Activity: what happened, and who did it.
+ *
+ * Read-only. Rows are written by the services that make the change, through the
+ * recorder, inside the same transaction (`recorder.ts`). There is deliberately
+ * no create, update or delete route: a history a client can edit is not a
+ * history, and `schema.md` gives the table no `updated_at` to support one.
+ *
+ * A timeline is not only the rows filed against the record. A person's timeline
+ * includes the deals and partnerships they are on; a company's includes its
+ * deals, opportunities and partnerships. The roll-up is resolved here rather
+ * than in the browser, which is the point of moving `activitiesFor` server-side.
+ */
+export interface ActivitiesDependencies {
+    readonly db: Database;
+}
+/** An activity as the API returns one: the stored row minus the tenancy column. */
+export type ActivityView = Omit<ActivityRecord, 'workspaceId'>;
+export interface ActivityTimelineQuery {
+    readonly targetType: RecordTargetType;
+    readonly targetId: string;
+}
+export interface ActivitiesService {
+    list(actor: Actor, timeline: ActivityTimelineQuery, query: ListQueryParameters): Promise<Page<ActivityView>>;
+}
+export declare function createActivitiesService(dependencies: ActivitiesDependencies): ActivitiesService;
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/activities/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/activities/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAGrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAG3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;CACtB;AAED,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAA;AAE9D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CACF,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;CAC/B;AAQD,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,sBAAsB,GACnC,iBAAiB,CAsCnB"}

package/dist/modules/activities/service.js

@@ -0,0 +1,28 @@
+import { AppError } from '../../lib/errors.js';
+import { mapPage, readListWindow, toPage } from '../../lib/pagination.js';
+import { requireWorkspaceId } from '../auth/actor.js';
+import { targetExists } from '../recordTargets.js';
+import * as repository from './repository.js';
+import { DEFAULT_ACTIVITY_SORT, ACTIVITY_SORTS } from './repository.js';
+function toView(record) {
+    const { workspaceId: _workspaceId, ...view } = record;
+    return view;
+}
+export function createActivitiesService(dependencies) {
+    return {
+        async list(actor, timeline, query) {
+            const workspaceId = requireWorkspaceId(actor);
+            // Without this an unknown id answers an empty timeline, which reads as
+            // "nothing has happened" rather than "there is no such record".
+            const exists = await targetExists(dependencies.db, workspaceId, timeline.targetType, timeline.targetId);
+            if (!exists) {
+                throw AppError.notFound('Record not found');
+            }
+            const rolledUp = await repository.listRolledUpTargets(dependencies.db, workspaceId, timeline.targetType, timeline.targetId);
+            const window = readListWindow(query, ACTIVITY_SORTS, DEFAULT_ACTIVITY_SORT);
+            const rows = await repository.listActivities(dependencies.db, workspaceId, [{ targetType: timeline.targetType, targetId: timeline.targetId }, ...rolledUp], window);
+            return mapPage(toPage(rows, window, (activity) => activity.id), toView);
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/modules/activities/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/modules/activities/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAqCvE,SAAS,MAAM,CAAC,MAAsB;IACpC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;IAErD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,YAAoC;IAEpC,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK;YAC/B,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;YAE7C,uEAAuE;YACvE,gEAAgE;YAChE,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,YAAY,CAAC,EAAE,EACf,WAAW,EACX,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,QAAQ,CAClB,CAAA;YAED,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;YAC7C,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,mBAAmB,CACnD,YAAY,CAAC,EAAE,EACf,WAAW,EACX,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,QAAQ,CAClB,CAAA;YACD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,qBAAqB,CAAC,CAAA;YAC3E,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,cAAc,CAC1C,YAAY,CAAC,EAAE,EACf,WAAW,EACX,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,EAC/E,MAAM,CACP,CAAA;YAED,OAAO,OAAO,CACZ,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAC/C,MAAM,CACP,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/modules/activities/tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolRegistry } from '../../runtime/module.ts';
+import type { ActivitiesService } from './service.ts';
+export declare function registerActivitiesTools(mcp: McpToolRegistry, service: ActivitiesService): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/modules/activities/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/modules/activities/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAG9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAgBrD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAiB9F"}

package/dist/modules/activities/tools.js

@@ -0,0 +1,26 @@
+import { RECORD_TARGET_TYPES } from '@kelpie/schemas';
+import { z } from 'zod';
+import { idArg, listWindowShape, pageResult, toListQuery } from '../crudTools.js';
+import { activityResponse } from './routes.js';
+/**
+ * `activities_list`, and nothing else.
+ *
+ * Activity is written by the services that cause it, inside their own
+ * transaction. There is no REST endpoint that writes one, so there is no tool
+ * that does either.
+ */
+const listArgs = z.strictObject({
+    ...listWindowShape,
+    target_type: z.enum(RECORD_TARGET_TYPES).describe('The kind of record whose timeline to read.'),
+    target_id: idArg.describe('The record whose timeline to read.'),
+});
+export function registerActivitiesTools(mcp, service) {
+    mcp.tool({
+        name: 'activities_list',
+        description: 'Read one record\'s timeline: what changed, who changed it, and when. Always names ' +
+            'a record; there is no workspace-wide feed. Cursor paged. Mirrors GET /v1/activities.',
+        inputSchema: listArgs,
+        invoke: async (args, actor) => pageResult(await service.list(actor, { targetType: args.target_type, targetId: args.target_id }, toListQuery(args)), activityResponse),
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/modules/activities/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/modules/activities/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C;;;;;;GAMG;AAEH,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9B,GAAG,eAAe;IAClB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC/F,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAChE,CAAC,CAAA;AAEF,MAAM,UAAU,uBAAuB,CAAC,GAAoB,EAAE,OAA0B;IACtF,GAAG,CAAC,IAAI,CAAC;QACP,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,oFAAoF;YACpF,sFAAsF;QACxF,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAC5B,UAAU,CACR,MAAM,OAAO,CAAC,IAAI,CAChB,KAAK,EACL,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,EAC1D,WAAW,CAAC,IAAI,CAAC,CAClB,EACD,gBAAgB,CACjB;KACJ,CAAC,CAAA;AACJ,CAAC"}

package/dist/modules/activities/wording.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The sentence an activity row carries.
+ *
+ * The timeline renders `<actor> <action>` with `detail` beneath it, so the
+ * phrasing is data, not presentation, and it is decided here rather than in
+ * five services. Pure functions with no database and no clock: what a person
+ * sees on a timeline is worth a unit test, and this is the shape that gets one.
+ *
+ * The phrasings match the ones the mockup's seeded activity carries
+ * (`mockups/src/data/seed.ts`), because that seed is what the panel was designed
+ * against.
+ */
+/** What an activity says happened, ready to store. */
+export interface ActivityWording {
+    readonly action: string;
+    readonly detail: string | null;
+}
+/** Human labels for the fields of one resource, keyed by their `camelCase` column name. */
+export type FieldLabels = Readonly<Record<string, string>>;
+/** `created Person`, `created Company`. */
+export declare function describeCreation(objectLabel: string): ActivityWording;
+/**
+ * `Submitted via Website contact`, with the first answers beneath it.
+ *
+ * Reads as the submitter's own action rather than as "created Person", because
+ * the row lands on a person's timeline and the person is usually not new: a
+ * returning lead filling the form in again is the same sentence either way.
+ */
+export declare function describeFormSubmission(formName: string, answers: string | null): ActivityWording;
+/**
+ * `created Deal via Website contact`, `created Company via acme-companies.csv`.
+ *
+ * @param sourceName What brought the record in: a form's name, an import's file
+ *   name. Named on the row because a record nobody typed in needs to say where
+ *   it came from, and the actor column only says who pressed the button.
+ */
+export declare function describeCreationVia(objectLabel: string, sourceName: string): ActivityWording;
+/**
+ * `updated Company via acme-companies.csv`.
+ *
+ * A bulk update names no fields, unlike `describeUpdate`. One import row can
+ * move a dozen columns at once, and a timeline listing them says less than the
+ * file that carried them: the job's own row-by-row account is where that detail
+ * belongs.
+ */
+export declare function describeUpdateVia(objectLabel: string, sourceName: string): ActivityWording;
+/**
+ * One changed field reads as itself; several read as a count.
+ *
+ * `changed Influence` with `influencer → decision_maker` says more than
+ * `changed 1 attribute`, and past one field the before-and-after stops fitting
+ * on a line, so the detail becomes the list of what moved.
+ *
+ * @param changed The field names `changedKeys` returned, in `camelCase`.
+ * @param before The stored record, for the single-field before-and-after.
+ * @param after The values being written.
+ */
+export declare function describeUpdate(changed: readonly string[], labels: FieldLabels, before: Readonly<Record<string, unknown>>, after: Readonly<Record<string, unknown>>): ActivityWording;
+/** `linked to company` with the far side's name beneath it. */
+export declare function describeLink(relatedLabel: string, relatedName: string): ActivityWording;
+/**
+ * `unlinked from company`, the mirror of `describeLink`.
+ *
+ * The far side is named for the same reason it is named on the link: the row
+ * lands on each end's timeline, and `unlinked from company` alone leaves the
+ * reader asking which one.
+ */
+export declare function describeUnlink(relatedLabel: string, relatedName: string): ActivityWording;
+/** `moved to Proposal`, with where it came from beneath. */
+export declare function describeStageChange(fromStage: string, toStage: string): ActivityWording;
+/**
+ * `added a note`, with the opening of the note beneath it.
+ *
+ * The excerpt is what makes the row worth reading without leaving the timeline.
+ * It is truncated on a character count rather than a word boundary because a
+ * note has no guaranteed whitespace.
+ */
+export declare function describeNote(body: string): ActivityWording;
+//# sourceMappingURL=wording.d.ts.map

package/dist/modules/activities/wording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wording.d.ts","sourceRoot":"","sources":["../../../src/modules/activities/wording.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAkC1D,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAE5F;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAE1F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,eAAe,CAiBjB;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,CAEvF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,CAEzF;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAEvF;AAKD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAQ1D"}

package/dist/modules/activities/wording.js

@@ -0,0 +1,134 @@
+/**
+ * The sentence an activity row carries.
+ *
+ * The timeline renders `<actor> <action>` with `detail` beneath it, so the
+ * phrasing is data, not presentation, and it is decided here rather than in
+ * five services. Pure functions with no database and no clock: what a person
+ * sees on a timeline is worth a unit test, and this is the shape that gets one.
+ *
+ * The phrasings match the ones the mockup's seeded activity carries
+ * (`mockups/src/data/seed.ts`), because that seed is what the panel was designed
+ * against.
+ */
+/**
+ * A value fit to print inside `old → new`.
+ *
+ * Arrays and objects are excluded on purpose. A tags array rendered as JSON is
+ * noise on a timeline, and there is no short honest rendering of "these five
+ * social profiles became those four", so the change is reported without a
+ * before-and-after rather than with an unreadable one.
+ */
+function printable(value) {
+    if (value === null) {
+        return 'none';
+    }
+    if (typeof value === 'string') {
+        return value.length === 0 ? 'none' : value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    return undefined;
+}
+function labelFor(labels, field) {
+    return labels[field] ?? field;
+}
+/** `created Person`, `created Company`. */
+export function describeCreation(objectLabel) {
+    return { action: `created ${objectLabel}`, detail: null };
+}
+/**
+ * `Submitted via Website contact`, with the first answers beneath it.
+ *
+ * Reads as the submitter's own action rather than as "created Person", because
+ * the row lands on a person's timeline and the person is usually not new: a
+ * returning lead filling the form in again is the same sentence either way.
+ */
+export function describeFormSubmission(formName, answers) {
+    return { action: `Submitted via ${formName}`, detail: answers };
+}
+/**
+ * `created Deal via Website contact`, `created Company via acme-companies.csv`.
+ *
+ * @param sourceName What brought the record in: a form's name, an import's file
+ *   name. Named on the row because a record nobody typed in needs to say where
+ *   it came from, and the actor column only says who pressed the button.
+ */
+export function describeCreationVia(objectLabel, sourceName) {
+    return { action: `created ${objectLabel} via ${sourceName}`, detail: null };
+}
+/**
+ * `updated Company via acme-companies.csv`.
+ *
+ * A bulk update names no fields, unlike `describeUpdate`. One import row can
+ * move a dozen columns at once, and a timeline listing them says less than the
+ * file that carried them: the job's own row-by-row account is where that detail
+ * belongs.
+ */
+export function describeUpdateVia(objectLabel, sourceName) {
+    return { action: `updated ${objectLabel} via ${sourceName}`, detail: null };
+}
+/**
+ * One changed field reads as itself; several read as a count.
+ *
+ * `changed Influence` with `influencer → decision_maker` says more than
+ * `changed 1 attribute`, and past one field the before-and-after stops fitting
+ * on a line, so the detail becomes the list of what moved.
+ *
+ * @param changed The field names `changedKeys` returned, in `camelCase`.
+ * @param before The stored record, for the single-field before-and-after.
+ * @param after The values being written.
+ */
+export function describeUpdate(changed, labels, before, after) {
+    const first = changed[0];
+    if (changed.length === 1 && first !== undefined) {
+        const from = printable(before[first]);
+        const to = printable(after[first]);
+        return {
+            action: `changed ${labelFor(labels, first)}`,
+            detail: from === undefined || to === undefined ? null : `${from} → ${to}`,
+        };
+    }
+    return {
+        action: `changed ${String(changed.length)} attributes`,
+        detail: changed.map((field) => labelFor(labels, field)).join(', '),
+    };
+}
+/** `linked to company` with the far side's name beneath it. */
+export function describeLink(relatedLabel, relatedName) {
+    return { action: `linked to ${relatedLabel}`, detail: relatedName };
+}
+/**
+ * `unlinked from company`, the mirror of `describeLink`.
+ *
+ * The far side is named for the same reason it is named on the link: the row
+ * lands on each end's timeline, and `unlinked from company` alone leaves the
+ * reader asking which one.
+ */
+export function describeUnlink(relatedLabel, relatedName) {
+    return { action: `unlinked from ${relatedLabel}`, detail: relatedName };
+}
+/** `moved to Proposal`, with where it came from beneath. */
+export function describeStageChange(fromStage, toStage) {
+    return { action: `moved to ${toStage}`, detail: `${fromStage} → ${toStage}` };
+}
+/** How much of a note's body the timeline repeats before trailing off. */
+const NOTE_EXCERPT_LENGTH = 120;
+/**
+ * `added a note`, with the opening of the note beneath it.
+ *
+ * The excerpt is what makes the row worth reading without leaving the timeline.
+ * It is truncated on a character count rather than a word boundary because a
+ * note has no guaranteed whitespace.
+ */
+export function describeNote(body) {
+    const trimmed = body.trim();
+    const excerpt = trimmed.length > NOTE_EXCERPT_LENGTH
+        ? `${trimmed.slice(0, NOTE_EXCERPT_LENGTH).trimEnd()}…`
+        : trimmed;
+    return { action: 'added a note', detail: excerpt.length === 0 ? null : excerpt };
+}
+//# sourceMappingURL=wording.js.map

package/dist/modules/activities/wording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wording.js","sourceRoot":"","sources":["../../../src/modules/activities/wording.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;IAC5C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAA;IAC5B,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,MAAmB,EAAE,KAAa;IAClD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAA;AAC/B,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,EAAE,MAAM,EAAE,WAAW,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,OAAsB;IAC7E,OAAO,EAAE,MAAM,EAAE,iBAAiB,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AACjE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,UAAkB;IACzE,OAAO,EAAE,MAAM,EAAE,WAAW,WAAW,QAAQ,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AAC7E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,UAAkB;IACvE,OAAO,EAAE,MAAM,EAAE,WAAW,WAAW,QAAQ,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AAC7E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA0B,EAC1B,MAAmB,EACnB,MAAyC,EACzC,KAAwC;IAExC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAExB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACrC,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;QAElC,OAAO;YACL,MAAM,EAAE,WAAW,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;YAC5C,MAAM,EAAE,IAAI,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,EAAE,EAAE;SAC1E,CAAA;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,WAAW,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa;QACtD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACnE,CAAA;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,YAAoB,EAAE,WAAmB;IACpE,OAAO,EAAE,MAAM,EAAE,aAAa,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,WAAmB;IACtE,OAAO,EAAE,MAAM,EAAE,iBAAiB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;AACzE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,OAAe;IACpE,OAAO,EAAE,MAAM,EAAE,YAAY,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,OAAO,EAAE,EAAE,CAAA;AAC/E,CAAC;AAED,0EAA0E;AAC1E,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,MAAM,OAAO,GACX,OAAO,CAAC,MAAM,GAAG,mBAAmB;QAClC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,OAAO,EAAE,GAAG;QACvD,CAAC,CAAC,OAAO,CAAA;IAEb,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;AAClF,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { AgentTaskDefinition, AgentTaskTargetType } from '@kelpie/schemas';
+/**
+ * The task catalog, ported from `mockups/src/data/agentTasks.ts`. Ids, labels,
+ * instructions and handbook slugs match `agent-tasks.md` exactly.
+ *
+ * The catalog ships in code rather than in a table: a task is a prompt recipe
+ * the product defines, not workspace data. `agent_runs.task_id` is therefore a
+ * catalog string with no foreign key, so a recorded run outlives any catalog
+ * edit.
+ */
+/** Embedded in every resolved prompt, per `agent-tasks.md`'s conventions. */
+export declare const SHARED_WRITE_POLICY = "- Prefer appending a Note over inventing facts.\n- Do not invent pricing, legal commitments, or security certifications not in the handbook or notes.\n- Do not change pipeline stage unless the human confirmed or this task explicitly allows it with evidence.\n- Respect open Decisions; do not contradict them.\n- Job titles live on Position, never on Person.\n- Prefer dated Plan items over a free-text next-step field.\n- Draft outreach is draft-only; do not send email.";
+export declare const AGENT_TASK_DEFINITIONS: readonly AgentTaskDefinition[];
+export declare function findTask(id: string): AgentTaskDefinition | undefined;
+export declare function tasksFor(targetType: AgentTaskTargetType): readonly AgentTaskDefinition[];
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-tasks/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE/E;;;;;;;;GAQG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,2dAMmB,CAAA;AAUnD,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAkqBhE,CAAA;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEpE;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,SAAS,mBAAmB,EAAE,CAExF"}