@onkeiki/agents 0.1.0

package/dist/Alert.d.ts

@@ -0,0 +1,56 @@
+import { Effect } from 'effect';
+export type AlertSchedule = {
+    readonly type: 'cron';
+    readonly expression: string;
+    readonly timezone?: string;
+} | {
+    readonly type: 'interval';
+    readonly every: string;
+} | {
+    readonly type: 'webhook';
+    readonly path: string;
+};
+export type AlertMedia = {
+    readonly url: string;
+    readonly mimeType: string;
+};
+/** One outbound message of a multi-message alert. */
+export type AlertMessage = {
+    readonly text: string;
+    readonly media?: ReadonlyArray<AlertMedia>;
+};
+export type AlertContent = {
+    readonly text: string;
+    readonly media?: AlertMedia;
+    /** Additional messages delivered after the first, in order. */
+    readonly messages?: ReadonlyArray<AlertMessage>;
+};
+/** Durable per-(alert, subscriber) KV state, persisted across runs. */
+export interface AlertStateService {
+    readonly get: (key: string) => Effect.Effect<unknown>;
+    readonly set: (key: string, value: unknown) => Effect.Effect<void>;
+}
+export type AlertContext = {
+    readonly subscriber: {
+        phone: string;
+        chatId: string;
+        preferences: Record<string, unknown>;
+    };
+    readonly now: Date;
+    /** Developer secrets synced to the platform, resolved for this run. */
+    readonly secrets: Readonly<Record<string, string>>;
+    readonly state: AlertStateService;
+};
+export type AlertDefinition = {
+    readonly name: string;
+    readonly description: string;
+    readonly schedule: AlertSchedule;
+    readonly dedupKey?: (ctx: AlertContext) => string;
+    readonly shouldSend?: (ctx: AlertContext) => Effect.Effect<boolean>;
+    readonly generate: (ctx: AlertContext) => Effect.Effect<AlertContent | null>;
+};
+/**
+ * Define a scheduled or triggered alert.
+ */
+export declare function defineAlert(def: AlertDefinition): AlertDefinition;
+//# sourceMappingURL=Alert.d.ts.map

package/dist/Alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../src/Alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvD,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5E,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CAChD,CAAA;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACrD,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CACnE;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;IAC5F,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,CAAA;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnE,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;CAC7E,CAAA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CAEjE"}

package/dist/Alert.js

@@ -0,0 +1,8 @@
+import { Effect } from 'effect';
+/**
+ * Define a scheduled or triggered alert.
+ */
+export function defineAlert(def) {
+    return def;
+}
+//# sourceMappingURL=Alert.js.map

package/dist/Alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alert.js","sourceRoot":"","sources":["../src/Alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AA6C/B;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAoB;IAC9C,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/Entity.d.ts

@@ -0,0 +1,158 @@
+import { Effect, Schema } from 'effect';
+import { type ToolDefinition } from './Tool.js';
+import type { PluginDbService, PluginMigration } from './services/PluginDb.js';
+import { StorageError } from './services/Storage.js';
+/**
+ * Entities — typed, tenant-scoped persistence for agents.
+ *
+ * An entity is a named, schema-validated collection stored in the plugin
+ * database. Declaring an entity gives you:
+ *
+ * - A migration creating its table (`entityMigrations`)
+ * - Bounded, tenant-scoped CRUD tools for the model (`entityTools`)
+ * - A typed database API for codemode / programmatic use (`createEntityDb`)
+ *
+ * The model never sees SQL: every read and write goes through generated
+ * tools that validate against the schema and are scoped to the current
+ * user (phone). Rows are soft-deleted, versioned for optimistic
+ * concurrency, and audited.
+ *
+ * The generated SQL targets Postgres (JSONB, GIN indexes,
+ * `gen_random_uuid()`); other storage adapters are not supported yet.
+ *
+ * @example
+ * ```ts
+ * const reminders = defineEntity({
+ *   name: 'reminders',
+ *   description: 'Scheduled reminders for the user',
+ *   schema: Schema.Struct({
+ *     text: Schema.String,
+ *     dueAt: Schema.String,
+ *     done: Schema.Boolean,
+ *   }),
+ *   indexes: ['dueAt'],
+ * })
+ * ```
+ */
+export type EntityDefinition<A extends Record<string, unknown> = Record<string, unknown>> = {
+    /** Unique entity name — lowercase snake_case (becomes part of the table name). */
+    readonly name: string;
+    /** What this entity stores, shown to the model in generated tool descriptions. */
+    readonly description: string;
+    /** Effect Schema describing a row's data. Validated on every write. */
+    readonly schema: Schema.Schema<A, any>;
+    /** Field names to index for query filters (expression indexes on the JSONB data). */
+    readonly indexes?: ReadonlyArray<string>;
+    /** Maximum rows per user. Creates beyond this fail. Default 10 000. */
+    readonly maxRowsPerUser?: number;
+};
+export declare function defineEntity<A extends Record<string, unknown>>(def: EntityDefinition<A>): EntityDefinition<A>;
+/** A stored entity row, as returned to the model and codemode. */
+export type EntityRow<A> = {
+    readonly id: string;
+    readonly version: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly data: A;
+};
+/**
+ * Build the plugin migrations for a set of entities. Pass the result to a
+ * plugin's `migrations` (or spread into an existing list). Each entity's
+ * migration version is derived from its name, so the list can be reordered
+ * or extended freely without shifting versions of already-applied entities.
+ */
+export declare function entityMigrations(entities: ReadonlyArray<EntityDefinition<any>>, startVersion?: number): PluginMigration[];
+/** Raw stored row shape exchanged with an {@link EntityStore}. */
+export type EntityStoreRow = {
+    id: string;
+    version: number;
+    created_at: string;
+    updated_at: string;
+    data: unknown;
+};
+/**
+ * Storage backend for entity rows. `makeAccessor` handles validation,
+ * quotas, merge semantics and audit *decisions*; a store only persists.
+ * Two implementations exist: `sqlEntityStore` (direct SQL over the plugin
+ * database, used by SDK-local execution) and the actor host bridge (cloud
+ * bundle execution, proxied through the platform's actor-runtime API).
+ * Promise-based so it can cross the actor host boundary unchanged.
+ */
+export interface EntityStore {
+    get(entityName: string, phone: string, id: string): Promise<EntityStoreRow | null>;
+    query(entityName: string, phone: string, opts: {
+        filter?: Record<string, unknown>;
+        limit: number;
+        orderBy?: {
+            field: string;
+            direction: 'asc' | 'desc';
+        };
+    }): Promise<EntityStoreRow[]>;
+    count(entityName: string, phone: string): Promise<number>;
+    insert(entityName: string, phone: string, data: Record<string, unknown>): Promise<EntityStoreRow>;
+    /** Full-row replace with version bump. Returns null when the row is gone or `expectedVersion` no longer matches. */
+    update(entityName: string, phone: string, id: string, data: Record<string, unknown>, expectedVersion?: number): Promise<EntityStoreRow | null>;
+    softDelete(entityName: string, phone: string, id: string): Promise<boolean>;
+    audit(entityName: string, phone: string, rowId: string, op: string, patch?: unknown): Promise<void>;
+}
+/** EntityStore over the plugin database (the per-entity `smskit_entity_*` tables). */
+export declare function sqlEntityStore(db: PluginDbService): EntityStore;
+export declare class EntityError extends Error {
+    readonly code: 'not_found' | 'conflict' | 'quota' | 'validation';
+    constructor(message: string, code: 'not_found' | 'conflict' | 'quota' | 'validation');
+}
+/**
+ * Tenant-scoped typed accessor for one entity. All operations are scoped
+ * to a single user (phone), bounded, soft-deleting, and audited.
+ *
+ * Representation convention: write inputs (`create` data, `update` patch)
+ * and `query` filters are in the schema's ENCODED (JSON) representation —
+ * what the model produces and what is stored. Returned rows carry the
+ * DECODED representation in `data`.
+ */
+export type EntityAccessError = EntityError | StorageError;
+export type EntityAccessor<A extends Record<string, unknown>> = {
+    readonly get: (id: string) => Effect.Effect<EntityRow<A> | null, EntityAccessError>;
+    /** Equality filters on indexed fields; bounded to 100 rows. */
+    readonly query: (opts?: {
+        readonly filter?: Partial<A>;
+        readonly limit?: number;
+        readonly orderBy?: {
+            readonly field: string;
+            readonly direction?: 'asc' | 'desc';
+        };
+    }) => Effect.Effect<EntityRow<A>[], EntityAccessError>;
+    readonly create: (data: A) => Effect.Effect<EntityRow<A>, EntityAccessError>;
+    /**
+     * Merge-patch a row. If `expectedVersion` is given the update fails with
+     * a conflict error when the row has changed since it was read.
+     */
+    readonly update: (id: string, patch: Partial<A>, opts?: {
+        readonly expectedVersion?: number;
+    }) => Effect.Effect<EntityRow<A>, EntityAccessError>;
+    /** Soft-delete a row. */
+    readonly delete: (id: string) => Effect.Effect<boolean, EntityAccessError>;
+};
+export type EntityDb<E extends Record<string, EntityDefinition<any>>> = {
+    readonly [K in keyof E]: E[K] extends EntityDefinition<infer A> ? EntityAccessor<A & Record<string, unknown>> : never;
+};
+/**
+ * Build the typed entity database for a user. This is what codemode and
+ * loops use: `db.reminders.query({ filter: { done: false } })`.
+ */
+export declare function createEntityDb<E extends Record<string, EntityDefinition<any>>>(entities: E, db: PluginDbService | EntityStore, phone: string): EntityDb<E>;
+/**
+ * The entity store for a tool context: the actor host bridge when the tool is
+ * running as a cloud bundle, otherwise direct SQL over the plugin database.
+ */
+export declare function contextEntityStore(ctx: {
+    entityStore?: EntityStore;
+    db: PluginDbService;
+}): EntityStore;
+/**
+ * Generate the model-facing CRUD tools for an entity:
+ * `<name>_query`, `<name>_create`, `<name>_update`, `<name>_delete`.
+ * All are tenant-scoped to the current user and bounded.
+ */
+export declare function entityTools<A extends Record<string, unknown>>(entity: EntityDefinition<A>): ToolDefinition<any, any>[];
+//# sourceMappingURL=Entity.d.ts.map

package/dist/Entity.d.ts.map

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

package/dist/Entity.js

@@ -0,0 +1,289 @@
+import { Effect, Schema } from 'effect';
+import { defineTool } from './Tool.js';
+import { StorageError } from './services/Storage.js';
+export function defineEntity(def) {
+    if (!/^[a-z][a-z0-9_]*$/.test(def.name)) {
+        throw new Error(`Entity name must be lowercase snake_case: ${def.name}`);
+    }
+    for (const field of def.indexes ?? []) {
+        if (!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(field) || field.length > 40) {
+            throw new Error(`Entity index field must be a short identifier: ${field}`);
+        }
+    }
+    return def;
+}
+const DEFAULT_MAX_ROWS = 10_000;
+const MAX_QUERY_LIMIT = 100;
+const DEFAULT_QUERY_LIMIT = 25;
+function tableName(entity) {
+    return `smskit_entity_${entity}`;
+}
+function entityVersion(name, startVersion) {
+    let hash = 2166136261;
+    for (let i = 0; i < name.length; i++) {
+        hash ^= name.charCodeAt(i);
+        hash = Math.imul(hash, 16777619);
+    }
+    return startVersion + 1 + ((hash >>> 0) % 1_000_000_000);
+}
+/**
+ * Build the plugin migrations for a set of entities. Pass the result to a
+ * plugin's `migrations` (or spread into an existing list). Each entity's
+ * migration version is derived from its name, so the list can be reordered
+ * or extended freely without shifting versions of already-applied entities.
+ */
+export function entityMigrations(entities, startVersion = 1) {
+    const versions = new Map();
+    const migrations = [
+        {
+            version: startVersion,
+            name: 'entity-audit-log',
+            up: `CREATE TABLE IF NOT EXISTS smskit_entity_audit (
+        id BIGSERIAL PRIMARY KEY,
+        entity TEXT NOT NULL,
+        row_id TEXT NOT NULL,
+        phone TEXT NOT NULL,
+        op TEXT NOT NULL,
+        patch JSONB,
+        at TIMESTAMPTZ NOT NULL DEFAULT now()
+      )`,
+        },
+    ];
+    for (const entity of entities) {
+        defineEntity(entity);
+        const version = entityVersion(entity.name, startVersion);
+        const clash = versions.get(version);
+        if (clash) {
+            throw new Error(`Entity migration version collision between ${clash} and ${entity.name}; rename one of them`);
+        }
+        versions.set(version, entity.name);
+        const table = tableName(entity.name);
+        const indexes = (entity.indexes ?? [])
+            .map((field) => `CREATE INDEX IF NOT EXISTS ${table}_${field}_idx ON ${table} ((data->>'${field}'))`)
+            .join('; ');
+        migrations.push({
+            version,
+            name: `entity-${entity.name}`,
+            up: `CREATE TABLE IF NOT EXISTS ${table} (
+        id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+        phone TEXT NOT NULL,
+        data JSONB NOT NULL,
+        version INT NOT NULL DEFAULT 1,
+        created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+        updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+        deleted_at TIMESTAMPTZ
+      );
+      CREATE INDEX IF NOT EXISTS ${table}_phone_idx ON ${table} (phone) WHERE deleted_at IS NULL;
+      CREATE INDEX IF NOT EXISTS ${table}_data_gin_idx ON ${table} USING GIN (data jsonb_path_ops)${indexes ? '; ' + indexes : ''}`,
+        });
+    }
+    return migrations;
+}
+/** EntityStore over the plugin database (the per-entity `smskit_entity_*` tables). */
+export function sqlEntityStore(db) {
+    const run = (effect) => Effect.runPromise(effect);
+    return {
+        get: (entityName, phone, id) => run(db.queryOne(`SELECT id, version, created_at, updated_at, data FROM ${tableName(entityName)}
+           WHERE id = $1 AND phone = $2 AND deleted_at IS NULL`, [id, phone])),
+        query: (entityName, phone, opts) => {
+            const params = [phone];
+            let where = `phone = $1 AND deleted_at IS NULL`;
+            if (opts.filter && Object.keys(opts.filter).length > 0) {
+                params.push(JSON.stringify(opts.filter));
+                where += ` AND data @> $${params.length}::jsonb`;
+            }
+            let order = `updated_at DESC`;
+            if (opts.orderBy) {
+                order = `data->>'${opts.orderBy.field}' ${opts.orderBy.direction === 'asc' ? 'ASC' : 'DESC'}`;
+            }
+            params.push(opts.limit);
+            return run(db.query(`SELECT id, version, created_at, updated_at, data FROM ${tableName(entityName)}
+           WHERE ${where} ORDER BY ${order} LIMIT $${params.length}`, params));
+        },
+        count: async (entityName, phone) => {
+            const row = await run(db.queryOne(`SELECT count(*)::text AS n FROM ${tableName(entityName)} WHERE phone = $1 AND deleted_at IS NULL`, [phone]));
+            return row ? Number(row.n) : 0;
+        },
+        insert: async (entityName, phone, data) => {
+            const raw = await run(db.queryOne(`INSERT INTO ${tableName(entityName)} (phone, data) VALUES ($1, $2)
+           RETURNING id, version, created_at, updated_at, data`, [phone, JSON.stringify(data)]));
+            if (!raw)
+                throw new Error('Insert returned no row');
+            return raw;
+        },
+        update: (entityName, phone, id, data, expectedVersion) => {
+            const versionClause = expectedVersion !== undefined ? ` AND version = $4` : '';
+            const params = [JSON.stringify(data), id, phone];
+            if (expectedVersion !== undefined)
+                params.push(expectedVersion);
+            return run(db.queryOne(`UPDATE ${tableName(entityName)} SET data = $1, version = version + 1, updated_at = now()
+           WHERE id = $2 AND phone = $3 AND deleted_at IS NULL${versionClause}
+           RETURNING id, version, created_at, updated_at, data`, params));
+        },
+        softDelete: async (entityName, phone, id) => {
+            const raw = await run(db.queryOne(`UPDATE ${tableName(entityName)} SET deleted_at = now()
+           WHERE id = $1 AND phone = $2 AND deleted_at IS NULL RETURNING id`, [id, phone]));
+            return raw !== null;
+        },
+        audit: (entityName, phone, rowId, op, patch) => run(db
+            .execute(`INSERT INTO smskit_entity_audit (entity, row_id, phone, op, patch) VALUES ($1, $2, $3, $4, $5)`, [entityName, rowId, phone, op, patch === undefined ? null : JSON.stringify(patch)])
+            .pipe(Effect.catchAll(() => Effect.void))),
+    };
+}
+function toRow(entity, raw) {
+    return Schema.decodeUnknown(entity.schema)(raw.data).pipe(Effect.mapError((e) => new EntityError(`Stored ${entity.name} row ${raw.id} no longer matches its schema: ${e.message}`, 'validation')), Effect.map((data) => ({
+        id: raw.id,
+        version: raw.version,
+        createdAt: toIso(raw.created_at),
+        updatedAt: toIso(raw.updated_at),
+        data: data,
+    })));
+}
+function toIso(value) {
+    return value instanceof Date ? value.toISOString() : String(value);
+}
+export class EntityError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'EntityError';
+    }
+}
+function storeCall(what, run) {
+    return Effect.tryPromise({
+        try: run,
+        catch: (e) => new StorageError(`Entity store ${what} failed: ${e instanceof Error ? e.message : String(e)}`, e),
+    });
+}
+function makeAccessor(entity, store, phone) {
+    defineEntity(entity);
+    // Validate then persist the ENCODED form, so transforming schemas
+    // (NumberFromString, date transforms, ...) round-trip through storage.
+    const validateToStored = (data) => Schema.decodeUnknown(entity.schema)(data).pipe(Effect.flatMap((decoded) => Schema.encode(entity.schema)(decoded)), Effect.mapError((e) => new EntityError(`Invalid ${entity.name} data: ${e.message}`, 'validation')));
+    const audit = (rowId, op, patch) => storeCall('audit', () => store.audit(entity.name, phone, rowId, op, patch)).pipe(Effect.catchAll(() => Effect.void));
+    return {
+        get: (id) => storeCall('get', () => store.get(entity.name, phone, id)).pipe(Effect.flatMap((raw) => (raw ? toRow(entity, raw) : Effect.succeed(null)))),
+        query: (opts) => Effect.gen(function* () {
+            const limit = Math.min(Math.max(opts?.limit ?? DEFAULT_QUERY_LIMIT, 1), MAX_QUERY_LIMIT);
+            let orderBy;
+            if (opts?.orderBy) {
+                if (!/^[a-zA-Z0-9_]+$/.test(opts.orderBy.field)) {
+                    return yield* Effect.fail(new EntityError(`Invalid order field`, 'validation'));
+                }
+                orderBy = { field: opts.orderBy.field, direction: opts.orderBy.direction === 'asc' ? 'asc' : 'desc' };
+            }
+            const rows = yield* storeCall('query', () => store.query(entity.name, phone, {
+                filter: opts?.filter,
+                limit,
+                orderBy,
+            }));
+            return yield* Effect.all(rows.map((raw) => toRow(entity, raw)));
+        }),
+        create: (data) => Effect.gen(function* () {
+            const stored = yield* validateToStored(data);
+            const max = entity.maxRowsPerUser ?? DEFAULT_MAX_ROWS;
+            const count = yield* storeCall('count', () => store.count(entity.name, phone));
+            if (count >= max) {
+                return yield* Effect.fail(new EntityError(`Row quota reached for ${entity.name} (${max})`, 'quota'));
+            }
+            const raw = yield* storeCall('insert', () => store.insert(entity.name, phone, stored));
+            yield* audit(raw.id, 'create', stored);
+            return yield* toRow(entity, raw);
+        }),
+        update: (id, patch, opts) => Effect.gen(function* () {
+            const existing = yield* storeCall('get', () => store.get(entity.name, phone, id));
+            if (!existing) {
+                return yield* Effect.fail(new EntityError(`${entity.name} row not found: ${id}`, 'not_found'));
+            }
+            // Merge in the encoded representation: stored JSON + encoded patch.
+            const merged = yield* validateToStored({
+                ...existing.data,
+                ...patch,
+            });
+            const raw = yield* storeCall('update', () => store.update(entity.name, phone, id, merged, opts?.expectedVersion));
+            if (!raw) {
+                return yield* Effect.fail(new EntityError(`${entity.name} row ${id} changed since it was read`, 'conflict'));
+            }
+            yield* audit(id, 'update', patch);
+            return yield* toRow(entity, raw);
+        }),
+        delete: (id) => Effect.gen(function* () {
+            const deleted = yield* storeCall('delete', () => store.softDelete(entity.name, phone, id));
+            if (deleted)
+                yield* audit(id, 'delete');
+            return deleted;
+        }),
+    };
+}
+/**
+ * Build the typed entity database for a user. This is what codemode and
+ * loops use: `db.reminders.query({ filter: { done: false } })`.
+ */
+export function createEntityDb(entities, db, phone) {
+    const store = isEntityStore(db) ? db : sqlEntityStore(db);
+    const out = {};
+    for (const [key, entity] of Object.entries(entities)) {
+        out[key] = makeAccessor(entity, store, phone);
+    }
+    return out;
+}
+function isEntityStore(db) {
+    return 'softDelete' in db;
+}
+/**
+ * The entity store for a tool context: the actor host bridge when the tool is
+ * running as a cloud bundle, otherwise direct SQL over the plugin database.
+ */
+export function contextEntityStore(ctx) {
+    return ctx.entityStore ?? sqlEntityStore(ctx.db);
+}
+/**
+ * Generate the model-facing CRUD tools for an entity:
+ * `<name>_query`, `<name>_create`, `<name>_update`, `<name>_delete`.
+ * All are tenant-scoped to the current user and bounded.
+ */
+export function entityTools(entity) {
+    const jsonSchema = Schema.Record({ key: Schema.String, value: Schema.Unknown });
+    const query = defineTool({
+        name: `${entity.name}_query`,
+        description: `Query ${entity.name}. ${entity.description} Returns up to ${MAX_QUERY_LIMIT} rows for the current user, newest first. Filter is an equality match on fields.`,
+        input: Schema.Struct({
+            filter: Schema.optional(jsonSchema),
+            limit: Schema.optional(Schema.Number),
+        }),
+        execute: (input, ctx) => makeAccessor(entity, contextEntityStore(ctx), ctx.phone)
+            .query({ filter: input.filter, limit: input.limit })
+            .pipe(Effect.catchAll((e) => Effect.succeed({ error: e.message }))),
+    });
+    const create = defineTool({
+        name: `${entity.name}_create`,
+        description: `Create a ${entity.name} row for the current user. ${entity.description}`,
+        input: Schema.Struct({ data: jsonSchema }),
+        execute: (input, ctx) => makeAccessor(entity, contextEntityStore(ctx), ctx.phone)
+            .create(input.data)
+            .pipe(Effect.catchAll((e) => Effect.succeed({ error: e.message }))),
+    });
+    const update = defineTool({
+        name: `${entity.name}_update`,
+        description: `Update a ${entity.name} row by id (merge-patch). Fails if the row was changed since read when expectedVersion is provided.`,
+        input: Schema.Struct({
+            id: Schema.String,
+            patch: jsonSchema,
+            expectedVersion: Schema.optional(Schema.Number),
+        }),
+        execute: (input, ctx) => makeAccessor(entity, contextEntityStore(ctx), ctx.phone)
+            .update(input.id, input.patch, { expectedVersion: input.expectedVersion })
+            .pipe(Effect.catchAll((e) => Effect.succeed({ error: e.message }))),
+    });
+    const del = defineTool({
+        name: `${entity.name}_delete`,
+        description: `Delete a ${entity.name} row by id (soft delete).`,
+        input: Schema.Struct({ id: Schema.String }),
+        execute: (input, ctx) => makeAccessor(entity, contextEntityStore(ctx), ctx.phone)
+            .delete(input.id)
+            .pipe(Effect.map((deleted) => ({ deleted })), Effect.catchAll((e) => Effect.succeed({ error: e.message }))),
+    });
+    return [query, create, update, del];
+}
+//# sourceMappingURL=Entity.js.map

package/dist/Entity.js.map

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