@assemblyline-agents/postgres 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenEve contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# @assemblyline-agents/postgres
+
+Official Assembly Line Postgres durable-state and scheduler plugin.
+
+It implements the runtime's state adapter interfaces on top of Postgres: runs, conversations and messages, checkpoints, delivery, memory, grants, sandbox records, settings, and miscellaneous state, plus schema migrations and ready-made presets. Usage observations have unique idempotency keys, exact integer micro-dollar fields for provider-reported cash, explicit unavailable provenance, and transactional receipt reconciliation across replicas. They do not reserve quota or gate requests. Use it to give a deployed Assembly Line agent durable storage and scheduling backed by a Postgres database.
+
+## Install
+
+```sh
+npm install @assemblyline-agents/postgres
+```
+
+## Part of Assembly Line
+
+This package is part of [Assembly Line](https://github.com/jasonbadeaux/openeve), a vendor-neutral, filesystem-first framework for durable AI agents. See the developer documentation in [docs/developers/](https://github.com/jasonbadeaux/openeve/tree/main/docs/developers) for setup, agent authoring, and deployment guides.
+
+## License
+
+MIT

package/dist/adapter-checkpoints.d.ts

@@ -0,0 +1,6 @@
+import type { CheckpointRecord, CheckpointRetentionOptions, CheckpointRetentionResult } from "@assemblyline-agents/runtime";
+import type { QueryClient } from "./client-types.js";
+export declare function createCheckpoint(client: QueryClient, input: Omit<CheckpointRecord, "id" | "createdAt">): Promise<CheckpointRecord>;
+export declare function listCheckpoints(client: QueryClient, runId: string): Promise<CheckpointRecord[]>;
+export declare function compactCheckpoints(client: QueryClient, options?: CheckpointRetentionOptions): Promise<CheckpointRetentionResult>;
+//# sourceMappingURL=adapter-checkpoints.d.ts.map

package/dist/adapter-checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-checkpoints.d.ts","sourceRoot":"","sources":["../src/adapter-checkpoints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgBrD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAOxI;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAGrG;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAuB1I"}

package/dist/adapter-checkpoints.js

@@ -0,0 +1,110 @@
+import { randomUUID } from "node:crypto";
+import { mapCheckpoint } from "./row-mappers.js";
+import { addCheckpointRetentionStats, checkpointNowMs, emptyCheckpointRetentionResult, numberValue, positiveLimit, timestamp, ttlCutoffIso } from "./sql-helpers.js";
+const ACTIVE_CHECKPOINT_STATUSES = ["created", "running", "waiting_for_approval", "waiting_for_input", "waiting_for_connection", "suspended"];
+const TERMINAL_CHECKPOINT_STATUSES = ["completed", "failed", "cancelled"];
+export async function createCheckpoint(client, input) {
+    const checkpoint = { ...input, id: randomUUID(), createdAt: timestamp() };
+    await client.query("insert into openeve_checkpoints (id, run_id, name, data, created_at) values ($1,$2,$3,$4::jsonb,$5)", [checkpoint.id, checkpoint.runId, checkpoint.name, JSON.stringify(checkpoint.data), checkpoint.createdAt]);
+    return checkpoint;
+}
+export async function listCheckpoints(client, runId) {
+    const result = await client.query("select * from openeve_checkpoints where run_id=$1 order by created_at asc", [runId]);
+    return result.rows.map(mapCheckpoint);
+}
+export async function compactCheckpoints(client, options = {}) {
+    const dryRun = options.dryRun === true;
+    const result = emptyCheckpointRetentionResult(dryRun);
+    const maxActive = options.maxActivePerRunName === undefined ? 0 : positiveLimit(options.maxActivePerRunName, 1);
+    if (maxActive > 0) {
+        addCheckpointRetentionStats(result, "active_compaction", await compactActiveCheckpoints(client, maxActive, options, dryRun));
+    }
+    if (options.terminalTtlMs !== undefined ||
+        options.failedRunTtlMs !== undefined ||
+        options.scheduledRunTtlMs !== undefined) {
+        addCheckpointRetentionStats(result, "terminal_ttl", await compactTerminalCheckpoints(client, options, dryRun));
+    }
+    return result;
+}
+async function compactActiveCheckpoints(client, maxActive, options, dryRun) {
+    const params = [maxActive, ACTIVE_CHECKPOINT_STATUSES];
+    const where = ["r.status = any($2)"];
+    if (options.runId) {
+        params.push(options.runId);
+        where.push(`c.run_id=$${params.length}`);
+    }
+    if (options.activeNames && options.activeNames.length > 0) {
+        params.push(options.activeNames);
+        where.push(`c.name = any($${params.length})`);
+    }
+    const candidates = `
+    with ranked as (
+      select c.id,
+             pg_column_size(c.data)::bigint as bytes,
+             row_number() over (partition by c.run_id, c.name order by c.created_at desc, c.id desc) as rn
+      from openeve_checkpoints c
+      join openeve_runs r on r.id = c.run_id
+      where ${where.join(" and ")}
+    ),
+    candidates as (
+      select id, bytes from ranked where rn > $1
+    )
+  `;
+    return checkpointCandidateStats(client, candidates, params, dryRun);
+}
+async function compactTerminalCheckpoints(client, options, dryRun) {
+    const nowMs = checkpointNowMs(options.now);
+    const terminalCutoff = ttlCutoffIso(nowMs, options.terminalTtlMs);
+    const failedCutoff = ttlCutoffIso(nowMs, options.failedRunTtlMs ?? options.terminalTtlMs);
+    const scheduledCutoff = ttlCutoffIso(nowMs, options.scheduledRunTtlMs);
+    const params = [TERMINAL_CHECKPOINT_STATUSES, terminalCutoff, failedCutoff, scheduledCutoff];
+    const where = ["r.status = any($1)"];
+    if (options.runId) {
+        params.push(options.runId);
+        where.push(`c.run_id=$${params.length}`);
+    }
+    const candidates = `
+    with candidates as (
+      select c.id, pg_column_size(c.data)::bigint as bytes
+      from openeve_checkpoints c
+      join openeve_runs r on r.id = c.run_id
+      where ${where.join(" and ")}
+        and (
+          (
+            $4::timestamptz is not null
+            and (
+              r.input->>'channel' = 'schedule'
+              or exists (select 1 from openeve_schedule_runs sr where sr.run_id = r.id)
+            )
+            and r.updated_at <= $4::timestamptz
+          )
+          or (
+            $3::timestamptz is not null
+            and r.status = 'failed'
+            and r.updated_at <= $3::timestamptz
+          )
+          or (
+            $2::timestamptz is not null
+            and r.status in ('completed', 'cancelled')
+            and r.updated_at <= $2::timestamptz
+          )
+        )
+    )
+  `;
+    return checkpointCandidateStats(client, candidates, params, dryRun);
+}
+async function checkpointCandidateStats(client, candidatesCte, params, dryRun) {
+    const sql = dryRun
+        ? `${candidatesCte} select count(*)::int as rows, coalesce(sum(bytes), 0)::bigint as bytes from candidates`
+        : `${candidatesCte},
+       deleted as (
+         delete from openeve_checkpoints c
+         using candidates
+         where c.id = candidates.id
+         returning pg_column_size(c.data)::bigint as bytes
+       )
+       select count(*)::int as rows, coalesce(sum(bytes), 0)::bigint as bytes from deleted`;
+    const row = (await client.query(sql, params)).rows[0] ?? {};
+    return { rows: numberValue(row.rows), bytes: numberValue(row.bytes) };
+}
+//# sourceMappingURL=adapter-checkpoints.js.map

package/dist/adapter-checkpoints.js.map

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

package/dist/adapter-conversation-turns.d.ts

@@ -0,0 +1,20 @@
+import type { ConversationTurnRecord, ConversationTurnStatus, ConversationTurnStore } from "@assemblyline-agents/runtime";
+import type { QueryClient } from "./client-types.js";
+export declare function enqueueConversationTurn(client: QueryClient, input: Parameters<ConversationTurnStore["enqueueConversationTurn"]>[0]): ReturnType<ConversationTurnStore["enqueueConversationTurn"]>;
+export declare function leaseNextConversationTurn(client: QueryClient, options: Parameters<ConversationTurnStore["leaseNextConversationTurn"]>[0]): ReturnType<ConversationTurnStore["leaseNextConversationTurn"]>;
+export declare function attachConversationTurnRun(client: QueryClient, id: string, leaseToken: string, runId: string): Promise<ConversationTurnRecord>;
+export declare function settleConversationTurn(client: QueryClient, id: string, leaseToken: string, status: "blocked" | "completed" | "failed" | "cancelled", options?: {
+    runId?: string;
+    error?: string;
+}): Promise<ConversationTurnRecord>;
+export declare function settleConversationTurnByRunId(client: QueryClient, runId: string, status: "blocked" | "completed" | "failed" | "cancelled", options?: {
+    error?: string;
+}): Promise<ConversationTurnRecord | undefined>;
+export declare function retryConversationTurn(client: QueryClient, id: string, leaseToken: string, error: string): Promise<ConversationTurnRecord>;
+export declare function recoverExpiredConversationTurns(client: QueryClient, now?: Date): Promise<ConversationTurnRecord[]>;
+export declare function listConversationTurns(client: QueryClient, options?: {
+    agentScope?: string;
+    conversationId?: string;
+    status?: ConversationTurnStatus;
+}): Promise<ConversationTurnRecord[]>;
+//# sourceMappingURL=adapter-conversation-turns.d.ts.map

package/dist/adapter-conversation-turns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-conversation-turns.d.ts","sourceRoot":"","sources":["../src/adapter-conversation-turns.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA6BrD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,GACrE,UAAU,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAC,CAkC9D;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,UAAU,CAAC,qBAAqB,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,GACzE,UAAU,CAAC,qBAAqB,CAAC,2BAA2B,CAAC,CAAC,CAgDhE;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC,CAWjC;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,EACxD,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,OAAO,CAAC,sBAAsB,CAAC,CAgBjC;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,EACxD,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAc7C;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC,CAoBjC;AAED,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACf,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAkCnC;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,sBAAsB,CAAC;CAC5B,GACL,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAqBnC"}

package/dist/adapter-conversation-turns.js

@@ -0,0 +1,216 @@
+import { randomUUID } from "node:crypto";
+import { normalizeJsonObject, timestamp, toIso } from "./sql-helpers.js";
+function mapConversationTurn(row) {
+    const record = {
+        id: String(row.id),
+        agentScope: String(row.agent_scope),
+        conversationId: String(row.conversation_id),
+        channel: String(row.channel),
+        eventId: String(row.event_id),
+        payload: normalizeJsonObject(row.payload),
+        idempotencyScope: String(row.idempotency_scope),
+        idempotencyKey: String(row.idempotency_key),
+        status: String(row.status),
+        attemptCount: Number(row.attempt_count ?? 0),
+        maxAttempts: Number(row.max_attempts ?? 5),
+        nextAttemptAt: toIso(row.next_attempt_at),
+        createdAt: toIso(row.created_at),
+        updatedAt: toIso(row.updated_at)
+    };
+    if (row.run_id)
+        record.runId = String(row.run_id);
+    if (row.lease_token)
+        record.leaseToken = String(row.lease_token);
+    if (row.lease_expires_at)
+        record.leaseExpiresAt = toIso(row.lease_expires_at);
+    if (row.last_error)
+        record.lastError = String(row.last_error);
+    return record;
+}
+export async function enqueueConversationTurn(client, input) {
+    const now = timestamp();
+    const id = randomUUID();
+    const result = await client.query(`insert into openeve_conversation_turns
+       (id, agent_scope, conversation_id, channel, event_id, payload,
+        idempotency_scope, idempotency_key, status, attempt_count, max_attempts,
+        next_attempt_at, created_at, updated_at)
+     values ($1,$2,$3,$4,$5,$6::jsonb,$7,$8,'pending',0,$9,$10,$10,$10)
+     on conflict (agent_scope, idempotency_scope, idempotency_key) do nothing
+     returning *`, [
+        id,
+        input.agentScope,
+        input.conversationId,
+        input.channel,
+        input.eventId,
+        JSON.stringify(input.payload),
+        input.idempotencyScope,
+        input.idempotencyKey,
+        Math.max(1, Math.floor(input.maxAttempts ?? 5)),
+        now
+    ]);
+    const inserted = result.rows[0];
+    if (inserted)
+        return { turn: mapConversationTurn(inserted), inserted: true };
+    const existing = await client.query(`select * from openeve_conversation_turns
+     where agent_scope=$1 and idempotency_scope=$2 and idempotency_key=$3`, [input.agentScope, input.idempotencyScope, input.idempotencyKey]);
+    const row = existing.rows[0];
+    if (!row)
+        throw new Error("Conversation turn idempotency conflict could not be reloaded.");
+    return { turn: mapConversationTurn(row), inserted: false };
+}
+export async function leaseNextConversationTurn(client, options) {
+    const now = options.now ?? new Date();
+    const leaseToken = randomUUID();
+    const leaseExpiresAt = new Date(now.getTime() + Math.max(1, options.leaseForMs)).toISOString();
+    try {
+        const result = await client.query(`with candidate as (
+         select turn.id
+         from openeve_conversation_turns turn
+         where turn.agent_scope=$1
+           and turn.status='pending'
+           and turn.next_attempt_at <= $2
+           and not exists (
+             select 1 from openeve_conversation_turns active
+             where active.agent_scope=turn.agent_scope
+               and active.conversation_id=turn.conversation_id
+               and active.status in ('running','blocked')
+           )
+           and not exists (
+             select 1 from openeve_conversation_turns earlier
+             where earlier.agent_scope=turn.agent_scope
+               and earlier.conversation_id=turn.conversation_id
+               and earlier.status='pending'
+               and earlier.enqueue_sequence < turn.enqueue_sequence
+           )
+         order by turn.enqueue_sequence asc
+         for update skip locked
+         limit 1
+       )
+       update openeve_conversation_turns turn
+       set status='running',
+           attempt_count=turn.attempt_count + 1,
+           lease_token=$3,
+           lease_expires_at=$4,
+           updated_at=$2
+       from candidate
+       where turn.id=candidate.id
+       returning turn.*`, [options.agentScope, now.toISOString(), leaseToken, leaseExpiresAt]);
+        const row = result.rows[0];
+        return row ? mapConversationTurn(row) : undefined;
+    }
+    catch (error) {
+        // Two replicas may race on different pending rows for the same
+        // conversation. The partial unique index is the final arbiter.
+        if (error.code === "23505")
+            return undefined;
+        throw error;
+    }
+}
+export async function attachConversationTurnRun(client, id, leaseToken, runId) {
+    const result = await client.query(`update openeve_conversation_turns
+     set run_id=$3, updated_at=$4
+     where id=$1 and status='running' and lease_token=$2
+     returning *`, [id, leaseToken, runId, timestamp()]);
+    const row = result.rows[0];
+    if (!row)
+        throw new Error(`Conversation turn lease mismatch: ${id}`);
+    return mapConversationTurn(row);
+}
+export async function settleConversationTurn(client, id, leaseToken, status, options = {}) {
+    const result = await client.query(`update openeve_conversation_turns
+     set status=$3,
+         run_id=coalesce($4, run_id),
+         last_error=coalesce($5, last_error),
+         lease_token=null,
+         lease_expires_at=null,
+         updated_at=$6
+     where id=$1 and status='running' and lease_token=$2
+     returning *`, [id, leaseToken, status, options.runId ?? null, options.error ?? null, timestamp()]);
+    const row = result.rows[0];
+    if (!row)
+        throw new Error(`Conversation turn lease mismatch: ${id}`);
+    return mapConversationTurn(row);
+}
+export async function settleConversationTurnByRunId(client, runId, status, options = {}) {
+    const result = await client.query(`update openeve_conversation_turns
+     set status=$2,
+         last_error=coalesce($3, last_error),
+         lease_token=null,
+         lease_expires_at=null,
+         updated_at=$4
+     where run_id=$1 and status in ('running','blocked')
+     returning *`, [runId, status, options.error ?? null, timestamp()]);
+    const row = result.rows[0];
+    return row ? mapConversationTurn(row) : undefined;
+}
+export async function retryConversationTurn(client, id, leaseToken, error) {
+    const now = new Date();
+    const result = await client.query(`update openeve_conversation_turns
+     set status=case when attempt_count >= max_attempts then 'failed' else 'pending' end,
+         next_attempt_at=case
+           when attempt_count >= max_attempts then $4::timestamptz
+           else $4::timestamptz + least(60000, 1000 * power(2, greatest(0, attempt_count - 1))) * interval '1 millisecond'
+         end,
+         last_error=$3,
+         lease_token=null,
+         lease_expires_at=null,
+         updated_at=$4
+     where id=$1 and status='running' and lease_token=$2
+     returning *`, [id, leaseToken, error, now.toISOString()]);
+    const row = result.rows[0];
+    if (!row)
+        throw new Error(`Conversation turn lease mismatch: ${id}`);
+    return mapConversationTurn(row);
+}
+export async function recoverExpiredConversationTurns(client, now = new Date()) {
+    const result = await client.query(`update openeve_conversation_turns turn
+     set status=case
+           when turn.run_id is null and turn.attempt_count >= turn.max_attempts then 'failed'
+           when turn.run_id is null then 'pending'
+           when run.status in ('waiting_for_approval','waiting_for_input','waiting_for_connection','suspended') then 'blocked'
+           when run.status in ('completed','failed','cancelled') then run.status
+           else turn.status
+         end,
+         next_attempt_at=case when turn.run_id is null then $1 else turn.next_attempt_at end,
+         lease_token=case
+           when turn.run_id is null or run.status not in ('created','running') then null
+           else turn.lease_token
+         end,
+         lease_expires_at=case
+           when turn.run_id is null or run.status not in ('created','running') then null
+           else turn.lease_expires_at
+         end,
+         last_error=case
+           when turn.run_id is null then coalesce(turn.last_error, 'Conversation turn lease expired before a run was attached.')
+           else turn.last_error
+         end,
+         updated_at=$1
+     from openeve_conversation_turns source
+     left join openeve_runs run on run.id=source.run_id
+     where turn.id=source.id
+       and turn.status='running'
+       and turn.lease_expires_at <= $1
+       and (turn.run_id is null or run.status not in ('created','running'))
+     returning turn.*`, [now.toISOString()]);
+    return result.rows.map(mapConversationTurn);
+}
+export async function listConversationTurns(client, options = {}) {
+    const values = [];
+    const clauses = [];
+    if (options.agentScope) {
+        values.push(options.agentScope);
+        clauses.push(`agent_scope=$${values.length}`);
+    }
+    if (options.conversationId) {
+        values.push(options.conversationId);
+        clauses.push(`conversation_id=$${values.length}`);
+    }
+    if (options.status) {
+        values.push(options.status);
+        clauses.push(`status=$${values.length}`);
+    }
+    const where = clauses.length > 0 ? `where ${clauses.join(" and ")}` : "";
+    const result = await client.query(`select * from openeve_conversation_turns ${where} order by enqueue_sequence asc`, values);
+    return result.rows.map(mapConversationTurn);
+}
+//# sourceMappingURL=adapter-conversation-turns.js.map

package/dist/adapter-conversation-turns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-conversation-turns.js","sourceRoot":"","sources":["../src/adapter-conversation-turns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAIzE,SAAS,mBAAmB,CAAC,GAAQ;IACnC,MAAM,MAAM,GAA2B;QACrC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QACnC,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;QAC3C,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC7B,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC;QACzC,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC/C,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;QAC3C,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAA2B;QACpD,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC;QAC5C,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;QAC1C,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC;QACzC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;QAChC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;KACjC,CAAC;IACF,IAAI,GAAG,CAAC,MAAM;QAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,WAAW;QAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACjE,IAAI,GAAG,CAAC,gBAAgB;QAAE,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,UAAU;QAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAmB,EACnB,KAAsE;IAEtE,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;;;;;iBAMa,EACb;QACE,EAAE;QACF,KAAK,CAAC,UAAU;QAChB,KAAK,CAAC,cAAc;QACpB,KAAK,CAAC,OAAO;QACb,KAAK,CAAC,OAAO;QACb,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B,KAAK,CAAC,gBAAgB;QACtB,KAAK,CAAC,cAAc;QACpB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;QAC/C,GAAG;KACJ,CACF,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7E,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CACjC;0EACsE,EACtE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,CACjE,CAAC;IACF,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAC3F,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAmB,EACnB,OAA0E;IAE1E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;IAChC,MAAM,cAAc,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/F,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA+BkB,EAClB,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,cAAc,CAAC,CACpE,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+DAA+D;QAC/D,+DAA+D;QAC/D,IAAK,KAA2B,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QACpE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAmB,EACnB,EAAU,EACV,UAAkB,EAClB,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;;iBAGa,EACb,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CACrC,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAmB,EACnB,EAAU,EACV,UAAkB,EAClB,MAAwD,EACxD,UAA8C,EAAE;IAEhD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;;;;;;;iBAQa,EACb,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC,CACpF,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,MAAmB,EACnB,KAAa,EACb,MAAwD,EACxD,UAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;;;;;;iBAOa,EACb,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC,CACpD,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAmB,EACnB,EAAU,EACV,UAAkB,EAClB,KAAa;IAEb,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;;;;;;;;;;iBAWa,EACb,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAC3C,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,MAAmB,EACnB,GAAG,GAAG,IAAI,IAAI,EAAE;IAEhB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA4BkB,EAClB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CACpB,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAmB,EACnB,UAII,EAAE;IAEN,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B,4CAA4C,KAAK,gCAAgC,EACjF,MAAM,CACP,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAC9C,CAAC"}

package/dist/adapter-conversations.d.ts

@@ -0,0 +1,46 @@
+import type { JsonObject } from "@assemblyline-agents/core";
+import type { ConversationCursor, ConversationRecord, MessageCursor, MessageRecord } from "@assemblyline-agents/runtime";
+import type { QueryClient } from "./client-types.js";
+export declare function upsertConversation(client: QueryClient, input: {
+    id: string;
+    agentScope?: string;
+    agentRevision: string;
+    channel: string;
+    subject?: string;
+    title?: string;
+    metadata?: JsonObject;
+}): Promise<ConversationRecord>;
+export declare function getConversation(client: QueryClient, id: string): Promise<ConversationRecord | undefined>;
+export declare function listConversations(client: QueryClient, input: {
+    agentScope: string;
+    channel?: string;
+    subject?: string;
+    archived?: boolean;
+    before?: ConversationCursor;
+    limit?: number;
+}): Promise<ConversationRecord[]>;
+export declare function updateConversation(client: QueryClient, id: string, patch: {
+    title?: string | null;
+    archivedAt?: string | null;
+    metadata?: JsonObject;
+}): Promise<ConversationRecord | undefined>;
+export declare function listRecentConversationsBySubject(client: QueryClient, input: {
+    channel: string;
+    subject: string;
+    since?: string;
+    limit?: number;
+    excludeId?: string;
+}): Promise<ConversationRecord[]>;
+export declare function appendMessage(client: QueryClient, input: {
+    conversationId: string;
+    runId?: string;
+    role: MessageRecord["role"];
+    content: JsonObject;
+}): Promise<MessageRecord>;
+export declare function listRecentMessages(client: QueryClient, conversationId: string, limit?: number): Promise<MessageRecord[]>;
+export declare function listMessages(client: QueryClient, input: {
+    conversationId: string;
+    before?: MessageCursor;
+    limit?: number;
+}): Promise<MessageRecord[]>;
+//# sourceMappingURL=adapter-conversations.d.ts.map

package/dist/adapter-conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-conversations.d.ts","sourceRoot":"","sources":["../src/adapter-conversations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACzH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4B9B;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAI9G;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyBhC;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IAC/E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAsB1C;AAED,wBAAsB,gCAAgC,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAoBhC;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAAC,aAAa,CAAC,CAezB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAM1H;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAgB3B"}

package/dist/adapter-conversations.js

@@ -0,0 +1,129 @@
+import { randomUUID } from "node:crypto";
+import { mapConversation, mapMessage } from "./row-mappers.js";
+import { timestamp } from "./sql-helpers.js";
+export async function upsertConversation(client, input) {
+    const now = timestamp();
+    const result = await client.query(`insert into openeve_conversations
+       (id, agent_id, agent_scope, agent_revision, channel, subject, title, metadata, created_at, updated_at)
+     values ($1, null, $2, $3, $4, $5, $6, $7::jsonb, $8, $9)
+     on conflict (id) do update set
+       agent_scope=coalesce(excluded.agent_scope, openeve_conversations.agent_scope),
+       agent_revision=excluded.agent_revision,
+       channel=excluded.channel,
+       subject=coalesce(excluded.subject, openeve_conversations.subject),
+       title=coalesce(excluded.title, openeve_conversations.title),
+       metadata=openeve_conversations.metadata || excluded.metadata,
+       updated_at=excluded.updated_at
+     returning *`, [
+        input.id,
+        input.agentScope ?? null,
+        input.agentRevision,
+        input.channel,
+        input.subject ?? null,
+        input.title ?? null,
+        JSON.stringify(input.metadata ?? {}),
+        now,
+        now
+    ]);
+    return mapConversation(result.rows[0]);
+}
+export async function getConversation(client, id) {
+    const result = await client.query("select * from openeve_conversations where id=$1", [id]);
+    const row = result.rows[0];
+    return row ? mapConversation(row) : undefined;
+}
+export async function listConversations(client, input) {
+    const clauses = ["coalesce(agent_scope, agent_revision, agent_id)=$1"];
+    const values = [input.agentScope];
+    if (input.channel) {
+        values.push(input.channel);
+        clauses.push(`channel=$${values.length}`);
+    }
+    if (input.subject) {
+        values.push(input.subject);
+        clauses.push(`subject=$${values.length}`);
+    }
+    if (input.archived !== undefined)
+        clauses.push(input.archived ? "archived_at is not null" : "archived_at is null");
+    if (input.before) {
+        values.push(input.before.updatedAt, input.before.id);
+        clauses.push(`(updated_at, id) < ($${values.length - 1}, $${values.length})`);
+    }
+    values.push(Math.max(0, input.limit ?? 50));
+    const result = await client.query(`select * from openeve_conversations
+     where ${clauses.join(" and ")}
+     order by updated_at desc, id desc
+     limit $${values.length}`, values);
+    return result.rows.map(mapConversation);
+}
+export async function updateConversation(client, id, patch) {
+    const now = timestamp();
+    const result = await client.query(`update openeve_conversations set
+       title=case when $2::boolean then $3 else title end,
+       archived_at=case when $4::boolean then $5::timestamptz else archived_at end,
+       metadata=metadata || $6::jsonb,
+       updated_at=$7
+     where id=$1
+     returning *`, [
+        id,
+        patch.title !== undefined,
+        patch.title ?? null,
+        patch.archivedAt !== undefined,
+        patch.archivedAt ?? null,
+        JSON.stringify(patch.metadata ?? {}),
+        now
+    ]);
+    const row = result.rows[0];
+    return row ? mapConversation(row) : undefined;
+}
+export async function listRecentConversationsBySubject(client, input) {
+    const clauses = ["channel=$1", "subject=$2"];
+    const values = [input.channel, input.subject];
+    if (input.since) {
+        values.push(input.since);
+        clauses.push(`updated_at >= $${values.length}`);
+    }
+    if (input.excludeId) {
+        values.push(input.excludeId);
+        clauses.push(`id <> $${values.length}`);
+    }
+    values.push(Math.max(0, input.limit ?? 10));
+    const result = await client.query(`select * from openeve_conversations
+     where ${clauses.join(" and ")}
+     order by updated_at desc
+     limit $${values.length}`, values);
+    return result.rows.map(mapConversation);
+}
+export async function appendMessage(client, input) {
+    const record = {
+        id: randomUUID(),
+        conversationId: input.conversationId,
+        role: input.role,
+        content: input.content,
+        createdAt: timestamp()
+    };
+    if (input.runId)
+        record.runId = input.runId;
+    await client.query(`insert into openeve_messages (id, conversation_id, run_id, role, content, created_at)
+     values ($1,$2,$3,$4,$5::jsonb,$6)`, [record.id, record.conversationId, record.runId ?? null, record.role, JSON.stringify(record.content), record.createdAt]);
+    return record;
+}
+export async function listRecentMessages(client, conversationId, limit = 20) {
+    const result = await client.query("select * from openeve_messages where conversation_id=$1 order by created_at desc limit $2", [conversationId, limit]);
+    return result.rows.map(mapMessage).reverse();
+}
+export async function listMessages(client, input) {
+    const values = [input.conversationId];
+    const clauses = ["conversation_id=$1"];
+    if (input.before) {
+        values.push(input.before.createdAt, input.before.id);
+        clauses.push(`(created_at, id) < ($${values.length - 1}, $${values.length})`);
+    }
+    values.push(Math.max(0, input.limit ?? 50));
+    const result = await client.query(`select * from openeve_messages
+     where ${clauses.join(" and ")}
+     order by created_at desc, id desc
+     limit $${values.length}`, values);
+    return result.rows.map(mapMessage).reverse();
+}
+//# sourceMappingURL=adapter-conversations.js.map

package/dist/adapter-conversations.js.map

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

package/dist/adapter-delivery.d.ts

@@ -0,0 +1,13 @@
+import type { JsonObject } from "@assemblyline-agents/core";
+import type { DeliveryFailureInput, DeliveryLeaseOptions, DeliveryObligation, DeliveryObligationInput, DeliveryObligationPatch } from "@assemblyline-agents/runtime";
+import type { QueryClient } from "./client-types.js";
+export declare function createDelivery(client: QueryClient, input: DeliveryObligationInput): Promise<DeliveryObligation>;
+export declare function updateDelivery(client: QueryClient, id: string, patch: DeliveryObligationPatch): Promise<DeliveryObligation>;
+export declare function listDeliveries(client: QueryClient, runId: string): Promise<DeliveryObligation[]>;
+export declare function leaseDueDeliveries(client: QueryClient, options?: DeliveryLeaseOptions): Promise<DeliveryObligation[]>;
+export declare function completeDeliverySend(client: QueryClient, id: string, leaseToken: string, patch?: {
+    payload?: JsonObject;
+}): Promise<DeliveryObligation>;
+export declare function failDeliverySend(client: QueryClient, id: string, leaseToken: string, failure: DeliveryFailureInput): Promise<DeliveryObligation>;
+export declare function recoverExpiredDeliveries(client: QueryClient, now?: Date): Promise<DeliveryObligation[]>;
+//# sourceMappingURL=adapter-delivery.d.ts.map

package/dist/adapter-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-delivery.d.ts","sourceRoot":"","sources":["../src/adapter-delivery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoCrH;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAMjI;AAyBD,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAGtG;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyB/H;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE;IAAE,OAAO,CAAC,EAAE,UAAU,CAAA;CAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsBjK;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+BtJ;AAED,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAWzH"}