@deepagents/experimental 7.8.2 → 7.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -10
- package/dist/index.js +601 -54
- package/dist/index.js.map +4 -4
- package/dist/zukhruf/index.d.ts +4 -0
- package/dist/zukhruf/index.d.ts.map +1 -1
- package/dist/zukhruf/index.js +601 -54
- package/dist/zukhruf/index.js.map +4 -4
- package/dist/zukhruf/mailbox/postgres.store.d.ts +9 -1
- package/dist/zukhruf/mailbox/postgres.store.d.ts.map +1 -1
- package/dist/zukhruf/mailbox/sqlite.store.d.ts +3 -1
- package/dist/zukhruf/mailbox/sqlite.store.d.ts.map +1 -1
- package/dist/zukhruf/mailbox/store.d.ts +4 -0
- package/dist/zukhruf/mailbox/store.d.ts.map +1 -1
- package/dist/zukhruf/plugins/conversation-scheduling/index.js.map +1 -1
- package/dist/zukhruf/plugins/schedules/index.js.map +1 -1
- package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts +14 -1
- package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts.map +1 -1
- package/dist/zukhruf/queue/turn-queue.d.ts +2 -0
- package/dist/zukhruf/queue/turn-queue.d.ts.map +1 -1
- package/dist/zukhruf/runtime/agent-runtime.d.ts +6 -7
- package/dist/zukhruf/runtime/agent-runtime.d.ts.map +1 -1
- package/dist/zukhruf/storage/agent-storage.d.ts +41 -0
- package/dist/zukhruf/storage/agent-storage.d.ts.map +1 -0
- package/dist/zukhruf/storage/embedded-agent-storage.d.ts +63 -0
- package/dist/zukhruf/storage/embedded-agent-storage.d.ts.map +1 -0
- package/dist/zukhruf/storage/postgres-agent-storage.d.ts +56 -0
- package/dist/zukhruf/storage/postgres-agent-storage.d.ts.map +1 -0
- package/dist/zukhruf/storage/sqlite-admission-gate.d.ts +29 -0
- package/dist/zukhruf/storage/sqlite-admission-gate.d.ts.map +1 -0
- package/dist/zukhruf/storage/turn-outbox.d.ts +65 -0
- package/dist/zukhruf/storage/turn-outbox.d.ts.map +1 -0
- package/package.json +6 -6
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { Pool } from 'pg';
|
|
2
|
-
import { type
|
|
2
|
+
import { type PostgresTransaction } from '@deepagents/context';
|
|
3
|
+
import { type MailboxEndTurnResult, type MailboxEnqueueResult, MailboxStore, type TransactionalMailboxStore } from './store.ts';
|
|
3
4
|
import { type ConversationId, type InterAgentCommunication } from './types.ts';
|
|
4
5
|
export interface PostgresMailboxStoreOptions {
|
|
5
6
|
/** Borrowed: the host owns the pool and the store never ends it. */
|
|
@@ -13,10 +14,17 @@ export declare class PostgresMailboxStore extends MailboxStore {
|
|
|
13
14
|
private constructor();
|
|
14
15
|
/** Opens the store: creates its schema objects before it returns. */
|
|
15
16
|
static create(options: PostgresMailboxStoreOptions): Promise<PostgresMailboxStore>;
|
|
17
|
+
/**
|
|
18
|
+
* A view of this store whose reads and writes run inside `tx`. Each of its
|
|
19
|
+
* writes takes the recipient's lock in a savepoint of `tx`, and the lock is
|
|
20
|
+
* held until `tx` ends.
|
|
21
|
+
*/
|
|
22
|
+
bind(tx: PostgresTransaction): TransactionalMailboxStore;
|
|
16
23
|
beginTurn(recipient: ConversationId, turnId: string): Promise<void>;
|
|
17
24
|
enqueue(communication: InterAgentCommunication): Promise<MailboxEnqueueResult>;
|
|
18
25
|
endTurn(recipient: ConversationId, turnId: string): Promise<MailboxEndTurnResult>;
|
|
19
26
|
hasPending(recipient: ConversationId): Promise<boolean>;
|
|
27
|
+
hasPendingTriggerTurn(recipient: ConversationId): Promise<boolean>;
|
|
20
28
|
drain(recipient: ConversationId): Promise<InterAgentCommunication[]>;
|
|
21
29
|
drainLeadingQueueOnly(recipient: ConversationId): Promise<InterAgentCommunication[]>;
|
|
22
30
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"postgres.store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/postgres.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,
|
|
1
|
+
{"version":3,"file":"postgres.store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/postgres.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAG/B,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,YAAY,EACZ,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,2BAA2B;IAC1C,oEAAoE;IACpE,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,qBAAa,oBAAqB,SAAQ,YAAY;;IAGpD,OAAO;IAKP,qEAAqE;WACxD,MAAM,CACjB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC;IAQhC;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,mBAAmB,GAAG,yBAAyB;IAqBzC,SAAS,CACtB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAaP,OAAO,CACd,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC;IA8BvB,OAAO,CACd,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAgBvB,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,qBAAqB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlE,KAAK,CACZ,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAI5B,qBAAqB,CAC5B,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAsFtC"}
|
|
@@ -1,13 +1,15 @@
|
|
|
1
|
+
import type { DatabaseSync } from 'node:sqlite';
|
|
1
2
|
import { type MailboxEndTurnResult, type MailboxEnqueueResult, MailboxStore } from './store.ts';
|
|
2
3
|
import { type ConversationId, type InterAgentCommunication } from './types.ts';
|
|
3
4
|
/** SQLite-backed mailbox for durable cross-process delivery. */
|
|
4
5
|
export declare class SqliteMailboxStore extends MailboxStore implements Disposable {
|
|
5
6
|
#private;
|
|
6
|
-
constructor(
|
|
7
|
+
constructor(pathOrDb: string | DatabaseSync);
|
|
7
8
|
beginTurn(recipient: ConversationId, turnId: string): Promise<void>;
|
|
8
9
|
enqueue(communication: InterAgentCommunication): Promise<MailboxEnqueueResult>;
|
|
9
10
|
endTurn(recipient: ConversationId, turnId: string): Promise<MailboxEndTurnResult>;
|
|
10
11
|
hasPending(recipient: ConversationId): Promise<boolean>;
|
|
12
|
+
hasPendingTriggerTurn(recipient: ConversationId): Promise<boolean>;
|
|
11
13
|
drain(recipient: ConversationId): Promise<InterAgentCommunication[]>;
|
|
12
14
|
drainLeadingQueueOnly(recipient: ConversationId): Promise<InterAgentCommunication[]>;
|
|
13
15
|
close(): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sqlite.store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/sqlite.store.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"sqlite.store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/sqlite.store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AAcpB,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,UAAU;;gBAG5D,QAAQ,EAAE,MAAM,GAAG,YAAY;IAO5B,SAAS,CACtB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAoBD,OAAO,CACpB,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC;IA8BjB,OAAO,CACpB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAqBjB,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,qBAAqB,CAClC,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,OAAO,CAAC;IAoDJ,KAAK,CAClB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAItB,qBAAqB,CAClC,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IA0DrC,KAAK,IAAI,IAAI;IAKb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}
|
|
@@ -12,9 +12,13 @@ export declare abstract class MailboxStore {
|
|
|
12
12
|
abstract enqueue(communication: InterAgentCommunication): Promise<MailboxEnqueueResult>;
|
|
13
13
|
abstract endTurn(recipient: ConversationId, turnId: string): Promise<MailboxEndTurnResult>;
|
|
14
14
|
abstract hasPending(recipient: ConversationId): Promise<boolean>;
|
|
15
|
+
/** Whether undelivered mail sent with `MessageDeliveryModes.TriggerTurn` waits for the recipient. */
|
|
16
|
+
abstract hasPendingTriggerTurn(recipient: ConversationId): Promise<boolean>;
|
|
15
17
|
/** Consumes the contiguous queue-only prefix, stopping before the first trigger. */
|
|
16
18
|
abstract drainLeadingQueueOnly(recipient: ConversationId): Promise<InterAgentCommunication[]>;
|
|
17
19
|
/** Draining is consumption: removes and returns all pending mail in FIFO order. */
|
|
18
20
|
abstract drain(recipient: ConversationId): Promise<InterAgentCommunication[]>;
|
|
19
21
|
}
|
|
22
|
+
/** The part of the mailbox that writes inside a caller's transaction. */
|
|
23
|
+
export type TransactionalMailboxStore = Pick<MailboxStore, 'enqueue' | 'beginTurn' | 'hasPendingTriggerTurn'>;
|
|
20
24
|
//# sourceMappingURL=store.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,iFAAiF;AACjF,8BAAsB,YAAY;IAChC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE5E,QAAQ,CAAC,OAAO,CACd,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC;IAEhC,QAAQ,CAAC,OAAO,CACd,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAEhC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhE,oFAAoF;IACpF,QAAQ,CAAC,qBAAqB,CAC5B,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAErC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAC9E"}
|
|
1
|
+
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,iFAAiF;AACjF,8BAAsB,YAAY;IAChC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE5E,QAAQ,CAAC,OAAO,CACd,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC;IAEhC,QAAQ,CAAC,OAAO,CACd,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAEhC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhE,qGAAqG;IACrG,QAAQ,CAAC,qBAAqB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAE3E,oFAAoF;IACpF,QAAQ,CAAC,qBAAqB,CAC5B,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAErC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAC9E;AAED,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,YAAY,EACZ,SAAS,GAAG,WAAW,GAAG,uBAAuB,CAClD,CAAC"}
|