@laserdata/laser-sdk 0.5.3 → 0.6.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 +105 -79
- package/dist/agent/agdx.d.ts +8 -3
- package/dist/agent/agdx.d.ts.map +1 -1
- package/dist/agent/agdx.js +39 -22
- package/dist/agent/agdx.js.map +1 -1
- package/dist/agent/builder.d.ts +25 -15
- package/dist/agent/builder.d.ts.map +1 -1
- package/dist/agent/builder.js +103 -59
- package/dist/agent/builder.js.map +1 -1
- package/dist/agent/context.d.ts +3 -6
- package/dist/agent/context.d.ts.map +1 -1
- package/dist/agent/context.js +17 -9
- package/dist/agent/context.js.map +1 -1
- package/dist/agent/contract.d.ts +2 -2
- package/dist/agent/contract.d.ts.map +1 -1
- package/dist/agent/contract.js +10 -6
- package/dist/agent/contract.js.map +1 -1
- package/dist/agent/memory-handler.d.ts +25 -0
- package/dist/agent/memory-handler.d.ts.map +1 -0
- package/dist/agent/memory-handler.js +43 -0
- package/dist/agent/memory-handler.js.map +1 -0
- package/dist/agent/registry.d.ts +3 -10
- package/dist/agent/registry.d.ts.map +1 -1
- package/dist/agent/registry.js +22 -19
- package/dist/agent/registry.js.map +1 -1
- package/dist/agent/reliable-consumer.d.ts +19 -9
- package/dist/agent/reliable-consumer.d.ts.map +1 -1
- package/dist/agent/reliable-consumer.js +193 -54
- package/dist/agent/reliable-consumer.js.map +1 -1
- package/dist/agent/replies.d.ts +6 -0
- package/dist/agent/replies.d.ts.map +1 -1
- package/dist/agent/replies.js +55 -4
- package/dist/agent/replies.js.map +1 -1
- package/dist/agent/router.d.ts +1 -1
- package/dist/agent/router.d.ts.map +1 -1
- package/dist/agent/router.js +5 -19
- package/dist/agent/router.js.map +1 -1
- package/dist/agent/scope.d.ts +7 -3
- package/dist/agent/scope.d.ts.map +1 -1
- package/dist/agent/scope.js +11 -1
- package/dist/agent/scope.js.map +1 -1
- package/dist/agent/timer.d.ts +6 -0
- package/dist/agent/timer.d.ts.map +1 -0
- package/dist/agent/timer.js +21 -0
- package/dist/agent/timer.js.map +1 -0
- package/dist/agent/workflow.d.ts +16 -19
- package/dist/agent/workflow.d.ts.map +1 -1
- package/dist/agent/workflow.js +17 -6
- package/dist/agent/workflow.js.map +1 -1
- package/dist/blob.d.ts +2 -3
- package/dist/blob.d.ts.map +1 -1
- package/dist/blob.js.map +1 -1
- package/dist/bridges/a2a.d.ts +34 -23
- package/dist/bridges/a2a.d.ts.map +1 -1
- package/dist/bridges/a2a.js +29 -19
- package/dist/bridges/a2a.js.map +1 -1
- package/dist/bridges/hops.d.ts +1 -1
- package/dist/bridges/hops.d.ts.map +1 -1
- package/dist/bridges/hops.js +1 -1
- package/dist/bridges/hops.js.map +1 -1
- package/dist/bridges/mcp.d.ts +27 -7
- package/dist/bridges/mcp.d.ts.map +1 -1
- package/dist/bridges/mcp.js +24 -9
- package/dist/bridges/mcp.js.map +1 -1
- package/dist/client/bytes.d.ts +5 -0
- package/dist/client/bytes.d.ts.map +1 -1
- package/dist/client/bytes.js +15 -0
- package/dist/client/bytes.js.map +1 -1
- package/dist/client/capabilities.d.ts +25 -13
- package/dist/client/capabilities.d.ts.map +1 -1
- package/dist/client/capabilities.js +145 -123
- package/dist/client/capabilities.js.map +1 -1
- package/dist/client/error-classify.d.ts +57 -0
- package/dist/client/error-classify.d.ts.map +1 -0
- package/dist/client/error-classify.js +347 -0
- package/dist/client/error-classify.js.map +1 -0
- package/dist/client/errors.d.ts +113 -40
- package/dist/client/errors.d.ts.map +1 -1
- package/dist/client/errors.js +191 -53
- package/dist/client/errors.js.map +1 -1
- package/dist/client/internals.d.ts +1 -0
- package/dist/client/internals.d.ts.map +1 -1
- package/dist/client/internals.js +1 -0
- package/dist/client/internals.js.map +1 -1
- package/dist/client/laser.d.ts +62 -46
- package/dist/client/laser.d.ts.map +1 -1
- package/dist/client/laser.js +206 -120
- package/dist/client/laser.js.map +1 -1
- package/dist/client/managed.d.ts +3 -0
- package/dist/client/managed.d.ts.map +1 -1
- package/dist/client/managed.js +70 -3
- package/dist/client/managed.js.map +1 -1
- package/dist/context-scope.d.ts +25 -9
- package/dist/context-scope.d.ts.map +1 -1
- package/dist/context-scope.js +36 -9
- package/dist/context-scope.js.map +1 -1
- package/dist/context.d.ts +33 -16
- package/dist/context.d.ts.map +1 -1
- package/dist/context.js +174 -95
- package/dist/context.js.map +1 -1
- package/dist/conversation-state.d.ts +1 -1
- package/dist/conversation-state.d.ts.map +1 -1
- package/dist/conversation-state.js +35 -16
- package/dist/conversation-state.js.map +1 -1
- package/dist/govern.d.ts +24 -5
- package/dist/govern.d.ts.map +1 -1
- package/dist/govern.js +116 -28
- package/dist/govern.js.map +1 -1
- package/dist/iggy/apache-iggy.d.ts +59 -56
- package/dist/iggy/apache-iggy.d.ts.map +1 -1
- package/dist/iggy/apache-iggy.js +300 -137
- package/dist/iggy/apache-iggy.js.map +1 -1
- package/dist/index.d.ts +97 -65
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +49 -30
- package/dist/index.js.map +1 -1
- package/dist/intent.d.ts +16 -2
- package/dist/intent.d.ts.map +1 -1
- package/dist/intent.js +50 -18
- package/dist/intent.js.map +1 -1
- package/dist/managed/coordination.d.ts +82 -0
- package/dist/managed/coordination.d.ts.map +1 -0
- package/dist/managed/coordination.js +367 -0
- package/dist/managed/coordination.js.map +1 -0
- package/dist/managed/destinations.d.ts +4 -3
- package/dist/managed/destinations.d.ts.map +1 -1
- package/dist/managed/destinations.js +29 -13
- package/dist/managed/destinations.js.map +1 -1
- package/dist/managed/filters.d.ts +5 -5
- package/dist/managed/filters.d.ts.map +1 -1
- package/dist/managed/filters.js +39 -22
- package/dist/managed/filters.js.map +1 -1
- package/dist/managed/forks.d.ts +8 -11
- package/dist/managed/forks.d.ts.map +1 -1
- package/dist/managed/forks.js +33 -13
- package/dist/managed/forks.js.map +1 -1
- package/dist/managed/graph.d.ts +1 -4
- package/dist/managed/graph.d.ts.map +1 -1
- package/dist/managed/graph.js +5 -3
- package/dist/managed/graph.js.map +1 -1
- package/dist/managed/kv.d.ts +26 -14
- package/dist/managed/kv.d.ts.map +1 -1
- package/dist/managed/kv.js +88 -61
- package/dist/managed/kv.js.map +1 -1
- package/dist/managed/projections.d.ts +5 -8
- package/dist/managed/projections.d.ts.map +1 -1
- package/dist/managed/projections.js +22 -2
- package/dist/managed/projections.js.map +1 -1
- package/dist/managed/query.d.ts +20 -6
- package/dist/managed/query.d.ts.map +1 -1
- package/dist/managed/query.js +97 -24
- package/dist/managed/query.js.map +1 -1
- package/dist/managed/runs.d.ts +2 -4
- package/dist/managed/runs.d.ts.map +1 -1
- package/dist/managed/runs.js +9 -1
- package/dist/managed/runs.js.map +1 -1
- package/dist/managed/watch.d.ts +2 -4
- package/dist/managed/watch.d.ts.map +1 -1
- package/dist/managed/watch.js +9 -1
- package/dist/managed/watch.js.map +1 -1
- package/dist/memory/handle.d.ts +75 -22
- package/dist/memory/handle.d.ts.map +1 -1
- package/dist/memory/handle.js +232 -58
- package/dist/memory/handle.js.map +1 -1
- package/dist/memory/log-memory.d.ts +24 -12
- package/dist/memory/log-memory.d.ts.map +1 -1
- package/dist/memory/log-memory.js +214 -100
- package/dist/memory/log-memory.js.map +1 -1
- package/dist/memory/topic.d.ts +2 -2
- package/dist/memory/topic.d.ts.map +1 -1
- package/dist/memory/topic.js +7 -5
- package/dist/memory/topic.js.map +1 -1
- package/dist/memory/types.d.ts +41 -5
- package/dist/memory/types.d.ts.map +1 -1
- package/dist/memory/types.js +44 -18
- package/dist/memory/types.js.map +1 -1
- package/dist/memory/vector-memory.d.ts +8 -6
- package/dist/memory/vector-memory.d.ts.map +1 -1
- package/dist/memory/vector-memory.js +65 -34
- package/dist/memory/vector-memory.js.map +1 -1
- package/dist/memory.d.ts +6 -5
- package/dist/memory.d.ts.map +1 -1
- package/dist/memory.js +4 -4
- package/dist/memory.js.map +1 -1
- package/dist/provenance/agent-topic.d.ts +3 -1
- package/dist/provenance/agent-topic.d.ts.map +1 -1
- package/dist/provenance/agent-topic.js +3 -1
- package/dist/provenance/agent-topic.js.map +1 -1
- package/dist/provenance/provenance.d.ts +3 -3
- package/dist/provenance/provenance.d.ts.map +1 -1
- package/dist/provenance/provenance.js +30 -18
- package/dist/provenance/provenance.js.map +1 -1
- package/dist/runtime/clock.d.ts +3 -0
- package/dist/runtime/clock.d.ts.map +1 -1
- package/dist/runtime/clock.js +16 -3
- package/dist/runtime/clock.js.map +1 -1
- package/dist/schema-codecs.d.ts +7 -3
- package/dist/schema-codecs.d.ts.map +1 -1
- package/dist/schema-codecs.js +80 -12
- package/dist/schema-codecs.js.map +1 -1
- package/dist/session.d.ts +27 -18
- package/dist/session.d.ts.map +1 -1
- package/dist/session.js +95 -37
- package/dist/session.js.map +1 -1
- package/dist/signing.d.ts +11 -5
- package/dist/signing.d.ts.map +1 -1
- package/dist/signing.js +64 -21
- package/dist/signing.js.map +1 -1
- package/dist/snapshot.d.ts +10 -2
- package/dist/snapshot.d.ts.map +1 -1
- package/dist/snapshot.js +62 -28
- package/dist/snapshot.js.map +1 -1
- package/dist/state-store.d.ts +1 -1
- package/dist/state-store.d.ts.map +1 -1
- package/dist/state-store.js.map +1 -1
- package/dist/stream/batching.d.ts +81 -0
- package/dist/stream/batching.d.ts.map +1 -0
- package/dist/stream/batching.js +210 -0
- package/dist/stream/batching.js.map +1 -0
- package/dist/stream/bson.d.ts +3 -0
- package/dist/stream/bson.d.ts.map +1 -0
- package/dist/stream/bson.js +245 -0
- package/dist/stream/bson.js.map +1 -0
- package/dist/stream/codecs.d.ts +58 -6
- package/dist/stream/codecs.d.ts.map +1 -1
- package/dist/stream/codecs.js +143 -59
- package/dist/stream/codecs.js.map +1 -1
- package/dist/stream/consumer-group.d.ts +13 -10
- package/dist/stream/consumer-group.d.ts.map +1 -1
- package/dist/stream/consumer-group.js +91 -31
- package/dist/stream/consumer-group.js.map +1 -1
- package/dist/stream/consumer-start.d.ts +17 -0
- package/dist/stream/consumer-start.d.ts.map +1 -0
- package/dist/stream/consumer-start.js +2 -0
- package/dist/stream/consumer-start.js.map +1 -0
- package/dist/stream/consumer.d.ts +166 -24
- package/dist/stream/consumer.d.ts.map +1 -1
- package/dist/stream/consumer.js +451 -68
- package/dist/stream/consumer.js.map +1 -1
- package/dist/stream/cursor.d.ts +5 -12
- package/dist/stream/cursor.d.ts.map +1 -1
- package/dist/stream/cursor.js +34 -8
- package/dist/stream/cursor.js.map +1 -1
- package/dist/stream/header-value.d.ts +61 -15
- package/dist/stream/header-value.d.ts.map +1 -1
- package/dist/stream/header-value.js.map +1 -1
- package/dist/stream/message.d.ts +17 -0
- package/dist/stream/message.d.ts.map +1 -0
- package/dist/stream/message.js +9 -0
- package/dist/stream/message.js.map +1 -0
- package/dist/stream/producer.d.ts +127 -11
- package/dist/stream/producer.d.ts.map +1 -1
- package/dist/stream/producer.js +401 -36
- package/dist/stream/producer.js.map +1 -1
- package/dist/stream/publish.d.ts +6 -15
- package/dist/stream/publish.d.ts.map +1 -1
- package/dist/stream/publish.js +18 -28
- package/dist/stream/publish.js.map +1 -1
- package/dist/stream/record.d.ts +4 -6
- package/dist/stream/record.d.ts.map +1 -1
- package/dist/stream/record.js +4 -3
- package/dist/stream/record.js.map +1 -1
- package/dist/stream/routing.d.ts +12 -0
- package/dist/stream/routing.d.ts.map +1 -1
- package/dist/stream/routing.js +6 -1
- package/dist/stream/routing.js.map +1 -1
- package/dist/stream/stream.d.ts +1 -4
- package/dist/stream/stream.d.ts.map +1 -1
- package/dist/stream/stream.js +5 -1
- package/dist/stream/stream.js.map +1 -1
- package/dist/stream/topic.d.ts +22 -23
- package/dist/stream/topic.d.ts.map +1 -1
- package/dist/stream/topic.js +90 -30
- package/dist/stream/topic.js.map +1 -1
- package/dist/stream/typed-topic.d.ts +9 -13
- package/dist/stream/typed-topic.d.ts.map +1 -1
- package/dist/stream/typed-topic.js +25 -10
- package/dist/stream/typed-topic.js.map +1 -1
- package/dist/swarm.d.ts +0 -1
- package/dist/swarm.d.ts.map +1 -1
- package/dist/swarm.js +1 -0
- package/dist/swarm.js.map +1 -1
- package/dist/testing.d.ts +3 -3
- package/dist/testing.d.ts.map +1 -1
- package/dist/testing.js +3 -3
- package/dist/testing.js.map +1 -1
- package/dist/types/ids.d.ts +17 -2
- package/dist/types/ids.d.ts.map +1 -1
- package/dist/types/ids.js +34 -14
- package/dist/types/ids.js.map +1 -1
- package/dist/wire/agent.d.ts +22 -0
- package/dist/wire/agent.d.ts.map +1 -1
- package/dist/wire/agent.js +80 -25
- package/dist/wire/agent.js.map +1 -1
- package/dist/wire/authz.d.ts +35 -1
- package/dist/wire/authz.d.ts.map +1 -1
- package/dist/wire/authz.js +45 -15
- package/dist/wire/authz.js.map +1 -1
- package/dist/wire/cbor.d.ts.map +1 -1
- package/dist/wire/cbor.js +13 -2
- package/dist/wire/cbor.js.map +1 -1
- package/dist/wire/checkpoint.d.ts +17 -12
- package/dist/wire/checkpoint.d.ts.map +1 -1
- package/dist/wire/checkpoint.js +28 -3
- package/dist/wire/checkpoint.js.map +1 -1
- package/dist/wire/control.d.ts +82 -0
- package/dist/wire/control.d.ts.map +1 -1
- package/dist/wire/control.js +219 -0
- package/dist/wire/control.js.map +1 -1
- package/dist/wire/filter-eval.d.ts +41 -7
- package/dist/wire/filter-eval.d.ts.map +1 -1
- package/dist/wire/filter-eval.js +26 -28
- package/dist/wire/filter-eval.js.map +1 -1
- package/dist/wire/filter.d.ts +51 -17
- package/dist/wire/filter.d.ts.map +1 -1
- package/dist/wire/filter.js +99 -10
- package/dist/wire/filter.js.map +1 -1
- package/dist/wire/fork.d.ts +14 -1
- package/dist/wire/fork.d.ts.map +1 -1
- package/dist/wire/fork.js +19 -8
- package/dist/wire/fork.js.map +1 -1
- package/dist/wire/graph.d.ts +3 -0
- package/dist/wire/graph.d.ts.map +1 -1
- package/dist/wire/graph.js +18 -4
- package/dist/wire/graph.js.map +1 -1
- package/dist/wire/hello.d.ts +4 -1
- package/dist/wire/hello.d.ts.map +1 -1
- package/dist/wire/hello.js +13 -3
- package/dist/wire/hello.js.map +1 -1
- package/dist/wire/index.d.ts +4 -1
- package/dist/wire/index.d.ts.map +1 -1
- package/dist/wire/index.js +4 -1
- package/dist/wire/index.js.map +1 -1
- package/dist/wire/kv.d.ts +37 -2
- package/dist/wire/kv.d.ts.map +1 -1
- package/dist/wire/kv.js +36 -18
- package/dist/wire/kv.js.map +1 -1
- package/dist/wire/query.d.ts +6 -0
- package/dist/wire/query.d.ts.map +1 -1
- package/dist/wire/query.js +38 -12
- package/dist/wire/query.js.map +1 -1
- package/dist/wire/schema.d.ts +29 -6
- package/dist/wire/schema.d.ts.map +1 -1
- package/dist/wire/schema.js +61 -26
- package/dist/wire/schema.js.map +1 -1
- package/dist/wire/snapshot.js +1 -1
- package/dist/wire/snapshot.js.map +1 -1
- package/dist/wire/value.d.ts +10 -2
- package/dist/wire/value.d.ts.map +1 -1
- package/dist/wire/value.js +29 -3
- package/dist/wire/value.js.map +1 -1
- package/package.json +2 -3
- package/dist/stream/polling-strategy.d.ts +0 -14
- package/dist/stream/polling-strategy.d.ts.map +0 -1
- package/dist/stream/polling-strategy.js +0 -2
- package/dist/stream/polling-strategy.js.map +0 -1
package/dist/client/errors.js
CHANGED
|
@@ -26,14 +26,26 @@ export class AmbiguousMutationError extends LaserError {
|
|
|
26
26
|
super(message, "ambiguous-mutation", options);
|
|
27
27
|
}
|
|
28
28
|
}
|
|
29
|
+
/** An aborted wait, or a registered run whose cancel intent was observed at
|
|
30
|
+
* a step boundary. `run` names that run. Not retryable on the same run. */
|
|
29
31
|
export class CancelledError extends LaserError {
|
|
32
|
+
run;
|
|
30
33
|
constructor(message, options) {
|
|
31
34
|
super(message, "cancelled", options);
|
|
35
|
+
this.run = options?.run;
|
|
32
36
|
}
|
|
33
37
|
}
|
|
38
|
+
/** The connected infrastructure does not provide the requested feature.
|
|
39
|
+
* Permanent: gate the code path instead of retrying. `surface` names the
|
|
40
|
+
* accessor the call came through and `feature` the sub-capability when one
|
|
41
|
+
* exists. */
|
|
34
42
|
export class UnsupportedError extends LaserError {
|
|
43
|
+
surface;
|
|
44
|
+
feature;
|
|
35
45
|
constructor(message, options) {
|
|
36
46
|
super(message, "unsupported", options);
|
|
47
|
+
this.surface = options?.surface;
|
|
48
|
+
this.feature = options?.feature;
|
|
37
49
|
}
|
|
38
50
|
}
|
|
39
51
|
export class InvalidError extends LaserError {
|
|
@@ -43,8 +55,72 @@ export class InvalidError extends LaserError {
|
|
|
43
55
|
this.context = context;
|
|
44
56
|
}
|
|
45
57
|
}
|
|
58
|
+
/** Why parsing or validating an id failed: a conversation, agent, group, or
|
|
59
|
+
* message id. Each static constructor is one Rust `IdError` variant with the
|
|
60
|
+
* same message. */
|
|
61
|
+
export class IdError extends LaserError {
|
|
62
|
+
constructor(message) {
|
|
63
|
+
super(message, "id");
|
|
64
|
+
}
|
|
65
|
+
static empty() {
|
|
66
|
+
return new IdError("identifier must not be empty");
|
|
67
|
+
}
|
|
68
|
+
static tooLong(got, max) {
|
|
69
|
+
return new IdError(`identifier length ${String(got)}B exceeds max ${String(max)}B`);
|
|
70
|
+
}
|
|
71
|
+
static invalidChar(char) {
|
|
72
|
+
return new IdError(`identifier contains invalid character \`${char}\``);
|
|
73
|
+
}
|
|
74
|
+
static invalidUlid(text) {
|
|
75
|
+
return new IdError(`invalid ULID \`${text}\``);
|
|
76
|
+
}
|
|
77
|
+
static invalidMessageId(text) {
|
|
78
|
+
return new IdError(`invalid message id \`${text}\`, expected \`<partition_id>:<offset>\``);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
/** Why encoding or decoding provenance headers failed. Each static
|
|
82
|
+
* constructor is one Rust `ProvenanceError` variant with the same message. */
|
|
83
|
+
export class ProvenanceError extends LaserError {
|
|
84
|
+
constructor(message, options) {
|
|
85
|
+
super(message, "provenance", options);
|
|
86
|
+
}
|
|
87
|
+
static missingRequired(key) {
|
|
88
|
+
return new ProvenanceError(`missing required header \`${key}\``);
|
|
89
|
+
}
|
|
90
|
+
static tooLarge(got, cap) {
|
|
91
|
+
return new ProvenanceError(`provenance headers ${String(got)}B exceed soft cap ${String(cap)}B`);
|
|
92
|
+
}
|
|
93
|
+
static invalidValue(key) {
|
|
94
|
+
return new ProvenanceError(`invalid value for header \`${key}\``);
|
|
95
|
+
}
|
|
96
|
+
static invalidValueBytes(key) {
|
|
97
|
+
return new ProvenanceError(`header \`${key}\` value must not contain control characters or NUL`);
|
|
98
|
+
}
|
|
99
|
+
static nonFinite(key) {
|
|
100
|
+
return new ProvenanceError(`non-finite floating-point value for header \`${key}\``);
|
|
101
|
+
}
|
|
102
|
+
static emptyValue(key) {
|
|
103
|
+
return new ProvenanceError(`header \`${key}\` value must not be empty`);
|
|
104
|
+
}
|
|
105
|
+
static valueTooLong(key, got, max) {
|
|
106
|
+
return new ProvenanceError(`header \`${key}\` value is ${String(got)}B, exceeds max ${String(max)}B`);
|
|
107
|
+
}
|
|
108
|
+
static malformedHeaders(detail) {
|
|
109
|
+
return new ProvenanceError(`malformed Iggy headers on this message: ${detail}`);
|
|
110
|
+
}
|
|
111
|
+
/** A header block the Apache Iggy client could not read, with its error as the cause. */
|
|
112
|
+
static header(cause) {
|
|
113
|
+
return new ProvenanceError(cause instanceof Error ? cause.message : String(cause), { cause });
|
|
114
|
+
}
|
|
115
|
+
/** An id header that does not parse, with the `IdError` as the cause. */
|
|
116
|
+
static id(cause) {
|
|
117
|
+
return new ProvenanceError(cause.message, { cause });
|
|
118
|
+
}
|
|
119
|
+
}
|
|
46
120
|
export class CodecError extends LaserError {
|
|
121
|
+
/** @internal */
|
|
47
122
|
surface;
|
|
123
|
+
/** @internal */
|
|
48
124
|
operation;
|
|
49
125
|
constructor(message, surface, operation, options) {
|
|
50
126
|
super(message, "codec", options);
|
|
@@ -54,13 +130,18 @@ export class CodecError extends LaserError {
|
|
|
54
130
|
}
|
|
55
131
|
export class TypedDecodeError extends LaserError {
|
|
56
132
|
position;
|
|
57
|
-
|
|
58
|
-
|
|
133
|
+
/** What went wrong: a codec failure for a positioned record, the transport error for a failed poll. */
|
|
134
|
+
source;
|
|
135
|
+
constructor(message, position, source) {
|
|
136
|
+
super(message, "typed-decode", { cause: source });
|
|
59
137
|
this.position = position;
|
|
138
|
+
this.source = source;
|
|
60
139
|
}
|
|
61
140
|
}
|
|
62
141
|
export class ProtocolError extends LaserError {
|
|
142
|
+
/** @internal */
|
|
63
143
|
resultCode;
|
|
144
|
+
/** @internal */
|
|
64
145
|
commandCode;
|
|
65
146
|
constructor(message, details, options) {
|
|
66
147
|
super(message, "protocol", options);
|
|
@@ -69,6 +150,8 @@ export class ProtocolError extends LaserError {
|
|
|
69
150
|
}
|
|
70
151
|
}
|
|
71
152
|
export class TransportError extends LaserError {
|
|
153
|
+
/** Read through `isRetryable`, like the Rust `is_retryable`.
|
|
154
|
+
* @internal */
|
|
72
155
|
retryable;
|
|
73
156
|
constructor(message, retryable, options) {
|
|
74
157
|
super(message, "transport", options);
|
|
@@ -122,38 +205,37 @@ export class FilterExecutionError extends LaserError {
|
|
|
122
205
|
super(message, "filter", options);
|
|
123
206
|
this.detail = detail;
|
|
124
207
|
}
|
|
125
|
-
get reason() {
|
|
126
|
-
return this.detail.reason;
|
|
127
|
-
}
|
|
128
208
|
}
|
|
129
|
-
/**
|
|
130
|
-
*
|
|
131
|
-
*
|
|
132
|
-
|
|
133
|
-
*/
|
|
134
|
-
export class FilterStopError extends LaserError {
|
|
135
|
-
stop;
|
|
209
|
+
/** A filtered read stopped in front of a record the filter could not
|
|
210
|
+
* evaluate under the `stop` fault policy. The record and everything after it
|
|
211
|
+
* stay unacknowledged. */
|
|
212
|
+
export class FilterFaultError extends LaserError {
|
|
136
213
|
partitionId;
|
|
137
214
|
offset;
|
|
138
|
-
|
|
139
|
-
constructor(
|
|
140
|
-
super(
|
|
141
|
-
? `filter fault on partition ${String(partitionId)} at offset ${offset.toString()}: ${faultReason ?? "malformed"}`
|
|
142
|
-
: `the record at offset ${offset.toString()} on partition ${String(partitionId)} exceeds the filtered reply cap`, "filter");
|
|
143
|
-
this.stop = stop;
|
|
215
|
+
reason;
|
|
216
|
+
constructor(partitionId, offset, reason) {
|
|
217
|
+
super(`filter fault on partition ${String(partitionId)} at offset ${offset.toString()}: ${reason ?? "malformed"}`, "filter");
|
|
144
218
|
this.partitionId = partitionId;
|
|
145
219
|
this.offset = offset;
|
|
146
|
-
this.
|
|
220
|
+
this.reason = reason;
|
|
147
221
|
}
|
|
148
|
-
|
|
149
|
-
|
|
222
|
+
}
|
|
223
|
+
/** A matching record alone exceeds the filtered reply cap, so no page can
|
|
224
|
+
* carry it. The record and everything after it stay unacknowledged. */
|
|
225
|
+
export class FilterOversizedRecordError extends LaserError {
|
|
226
|
+
partitionId;
|
|
227
|
+
offset;
|
|
228
|
+
constructor(partitionId, offset) {
|
|
229
|
+
super(`the record at offset ${offset.toString()} on partition ${String(partitionId)} exceeds the filtered reply cap`, "filter");
|
|
230
|
+
this.partitionId = partitionId;
|
|
231
|
+
this.offset = offset;
|
|
150
232
|
}
|
|
151
233
|
}
|
|
152
234
|
/**
|
|
153
235
|
* The consumer group exists, but its filter was not configured. The group
|
|
154
236
|
* stays as it is, unbound unless it ran a policy before, and no reader joined
|
|
155
|
-
* it. `cause` is the catalog refusal or the transport failure, and
|
|
156
|
-
* the catalog's reason when there is one.
|
|
237
|
+
* it. `cause` is the catalog refusal or the transport failure, and
|
|
238
|
+
* `filterReason(error.cause)` the catalog's reason when there is one.
|
|
157
239
|
*/
|
|
158
240
|
export class ConsumerGroupSetupError extends LaserError {
|
|
159
241
|
groupId;
|
|
@@ -165,9 +247,6 @@ export class ConsumerGroupSetupError extends LaserError {
|
|
|
165
247
|
this.groupName = groupName;
|
|
166
248
|
this.identity = identity;
|
|
167
249
|
}
|
|
168
|
-
get reason() {
|
|
169
|
-
return this.cause instanceof FilterExecutionError ? this.cause.reason : undefined;
|
|
170
|
-
}
|
|
171
250
|
}
|
|
172
251
|
export class AgentWorkflowExecutionError extends LaserError {
|
|
173
252
|
detail;
|
|
@@ -176,11 +255,29 @@ export class AgentWorkflowExecutionError extends LaserError {
|
|
|
176
255
|
this.detail = detail;
|
|
177
256
|
}
|
|
178
257
|
}
|
|
179
|
-
export class
|
|
180
|
-
|
|
181
|
-
constructor(
|
|
182
|
-
super(
|
|
183
|
-
this.
|
|
258
|
+
export class NoCapableAgentError extends LaserError {
|
|
259
|
+
skill;
|
|
260
|
+
constructor(skill) {
|
|
261
|
+
super(`no live agent advertises capability \`${skill}\``, "routing");
|
|
262
|
+
this.skill = skill;
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
export class NoInboxError extends LaserError {
|
|
266
|
+
agent;
|
|
267
|
+
constructor(agent) {
|
|
268
|
+
super(`no inbox advertised for agent \`${agent}\``, "routing");
|
|
269
|
+
this.agent = agent;
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
export class RoutePrincipalMismatchError extends LaserError {
|
|
273
|
+
agent;
|
|
274
|
+
expected;
|
|
275
|
+
actual;
|
|
276
|
+
constructor(agent, expected, actual) {
|
|
277
|
+
super(`agent \`${agent}\` is not authenticated as principal ${expected.toString()}`, "routing");
|
|
278
|
+
this.agent = agent;
|
|
279
|
+
this.expected = expected;
|
|
280
|
+
this.actual = actual;
|
|
184
281
|
}
|
|
185
282
|
}
|
|
186
283
|
export class RejectedError extends LaserError {
|
|
@@ -245,29 +342,70 @@ export class BudgetExceededError extends LaserError {
|
|
|
245
342
|
this.spent = spent;
|
|
246
343
|
}
|
|
247
344
|
}
|
|
345
|
+
/**
|
|
346
|
+
* A publish that gave up. `committed` lists the ranges confirmed before the
|
|
347
|
+
* failure, never replay them. `unconfirmed` lists the records left without a
|
|
348
|
+
* confirmation. `cause` is the original failure, and `publishCause()` reaches
|
|
349
|
+
* it through any nesting, so every classifier answers for it.
|
|
350
|
+
*/
|
|
351
|
+
export class PublishFailedError extends LaserError {
|
|
352
|
+
stream;
|
|
353
|
+
topic;
|
|
354
|
+
committed;
|
|
355
|
+
unconfirmed;
|
|
356
|
+
constructor(stream, topic, committed, unconfirmed, cause) {
|
|
357
|
+
super(`publish failed to ${stream}/${topic}: ${cause instanceof Error ? cause.message : String(cause)}`, "publish-failed", { cause });
|
|
358
|
+
this.stream = stream;
|
|
359
|
+
this.topic = topic;
|
|
360
|
+
this.committed = committed;
|
|
361
|
+
this.unconfirmed = unconfirmed;
|
|
362
|
+
}
|
|
363
|
+
/** The original failure under any publish wrapping. */
|
|
364
|
+
publishCause() {
|
|
365
|
+
return publishCause(this);
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
/** The original failure under any `PublishFailedError` wrapping. */
|
|
369
|
+
export function publishCause(error) {
|
|
370
|
+
let current = error;
|
|
371
|
+
while (current instanceof PublishFailedError)
|
|
372
|
+
current = current.cause;
|
|
373
|
+
return current;
|
|
374
|
+
}
|
|
375
|
+
/** A fenced write lost the fence: the held token is below the live sequence,
|
|
376
|
+
* so a newer holder owns the task. Never retryable by the loser. */
|
|
377
|
+
export class FenceViolationError extends LaserError {
|
|
378
|
+
stale;
|
|
379
|
+
current;
|
|
380
|
+
constructor(stale, current) {
|
|
381
|
+
super(`fence violation: held ${stale.toString()}, current ${current.toString()}`, "fence-violation");
|
|
382
|
+
this.stale = stale;
|
|
383
|
+
this.current = current;
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
/** The agent was quarantined and may not act. Not retryable. */
|
|
387
|
+
export class QuarantinedError extends LaserError {
|
|
388
|
+
agent;
|
|
389
|
+
constructor(agent) {
|
|
390
|
+
super(`quarantined: ${agent}`, "quarantined");
|
|
391
|
+
this.agent = agent;
|
|
392
|
+
}
|
|
393
|
+
}
|
|
394
|
+
/** The agent was built without a `respondOn` topic. Not retryable. */
|
|
395
|
+
export class NoRespondTopicError extends LaserError {
|
|
396
|
+
constructor(message = "the agent has no respondOn topic configured") {
|
|
397
|
+
super(message, "no-respond-topic");
|
|
398
|
+
}
|
|
399
|
+
}
|
|
400
|
+
/** Iggy answered a destination or checkpoint operation with a typed failure. */
|
|
401
|
+
export class CheckpointExecutionError extends LaserError {
|
|
402
|
+
detail;
|
|
403
|
+
constructor(message, detail, options) {
|
|
404
|
+
super(message, "checkpoint", options);
|
|
405
|
+
this.detail = detail;
|
|
406
|
+
}
|
|
407
|
+
}
|
|
248
408
|
export function assertNever(value) {
|
|
249
409
|
throw new InvalidError("unreachable variant", { value });
|
|
250
410
|
}
|
|
251
|
-
// A remote-safe rendering of a failure, for the bridge JSON-RPC responses. A
|
|
252
|
-
// `TransportError` message names hosts, streams, and topics, and a
|
|
253
|
-
// `ConfigError` can carry connection detail, none of which an unauthenticated
|
|
254
|
-
// caller should see. The classification goes on the wire, the detail stays in
|
|
255
|
-
// the local log.
|
|
256
|
-
export function publicErrorMessage(error) {
|
|
257
|
-
if (!(error instanceof LaserError))
|
|
258
|
-
return "internal error";
|
|
259
|
-
const publicByKind = {
|
|
260
|
-
invalid: "invalid request",
|
|
261
|
-
codec: "invalid request",
|
|
262
|
-
unsupported: "unsupported operation",
|
|
263
|
-
routing: "not found",
|
|
264
|
-
timeout: "request timed out",
|
|
265
|
-
cancelled: "request cancelled",
|
|
266
|
-
rejected: "forbidden",
|
|
267
|
-
"policy-blocked": "forbidden",
|
|
268
|
-
signature: "unauthenticated",
|
|
269
|
-
"step-up-required": "step-up authorization required"
|
|
270
|
-
};
|
|
271
|
-
return publicByKind[error.kind] ?? "internal error";
|
|
272
|
-
}
|
|
273
411
|
//# sourceMappingURL=errors.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,4 +3,5 @@ export declare const INTERNAL_NATIVE_CONSUMER: unique symbol;
|
|
|
3
3
|
export declare const INTERNAL_REPLY_HUB: unique symbol;
|
|
4
4
|
export declare const INTERNAL_TRANSPORT: unique symbol;
|
|
5
5
|
export declare const INTERNAL_VERIFIER: unique symbol;
|
|
6
|
+
export declare const INTERNAL_RETURN_DELIVERY: unique symbol;
|
|
6
7
|
//# sourceMappingURL=internals.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../../src/client/internals.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,eAAkC,CAAA;AAC9D,eAAO,MAAM,wBAAwB,eAA2C,CAAA;AAChF,eAAO,MAAM,kBAAkB,eAAqC,CAAA;AACpE,eAAO,MAAM,kBAAkB,eAAqC,CAAA;AACpE,eAAO,MAAM,iBAAiB,eAAoC,CAAA"}
|
|
1
|
+
{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../../src/client/internals.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,eAAkC,CAAA;AAC9D,eAAO,MAAM,wBAAwB,eAA2C,CAAA;AAChF,eAAO,MAAM,kBAAkB,eAAqC,CAAA;AACpE,eAAO,MAAM,kBAAkB,eAAqC,CAAA;AACpE,eAAO,MAAM,iBAAiB,eAAoC,CAAA;AAClE,eAAO,MAAM,wBAAwB,eAA2C,CAAA"}
|
package/dist/client/internals.js
CHANGED
|
@@ -3,4 +3,5 @@ export const INTERNAL_NATIVE_CONSUMER = Symbol("laser.internal.native-consumer")
|
|
|
3
3
|
export const INTERNAL_REPLY_HUB = Symbol("laser.internal.reply-hub");
|
|
4
4
|
export const INTERNAL_TRANSPORT = Symbol("laser.internal.transport");
|
|
5
5
|
export const INTERNAL_VERIFIER = Symbol("laser.internal.verifier");
|
|
6
|
+
export const INTERNAL_RETURN_DELIVERY = Symbol("laser.internal.return-delivery");
|
|
6
7
|
//# sourceMappingURL=internals.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"internals.js","sourceRoot":"","sources":["../../src/client/internals.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAA;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,gCAAgC,CAAC,CAAA;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAA;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAA;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA"}
|
|
1
|
+
{"version":3,"file":"internals.js","sourceRoot":"","sources":["../../src/client/internals.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAA;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,gCAAgC,CAAC,CAAA;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAA;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAA;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,gCAAgC,CAAC,CAAA"}
|
package/dist/client/laser.d.ts
CHANGED
|
@@ -1,27 +1,26 @@
|
|
|
1
1
|
import { type ConnectOptions } from "./connect-options.js";
|
|
2
2
|
import { type PublishOptions } from "./publish-options.js";
|
|
3
|
-
import { type ClientOwnership, type IggyClient
|
|
3
|
+
import { type ClientOwnership, type IggyClient } from "../iggy/apache-iggy.js";
|
|
4
4
|
import { type Agdx } from "../agent/agdx.js";
|
|
5
5
|
import { type AgentMessage } from "../agent/reliable-consumer.js";
|
|
6
|
-
import { ReplyHub } from "../agent/replies.js";
|
|
7
6
|
import { ContractBuilder, type ScatterReport } from "../agent/contract.js";
|
|
8
7
|
import { Workflow } from "../agent/workflow.js";
|
|
9
8
|
import { type AgUiEvent } from "../bridges/agui.js";
|
|
10
9
|
import type { CapabilitySelector, InboxRoute, Router } from "../agent/router.js";
|
|
11
10
|
import { AgentScope } from "../agent/scope.js";
|
|
12
11
|
import { type StreamEvent } from "../agent/assembler.js";
|
|
13
|
-
import { AgentRegistry, ClientMetadataRequest
|
|
12
|
+
import { AgentRegistry, ClientMetadataRequest } from "../agent/registry.js";
|
|
14
13
|
import { Stream } from "../stream/stream.js";
|
|
15
14
|
import { ContextScope } from "../context-scope.js";
|
|
16
|
-
import { Sessions, type
|
|
17
|
-
import {
|
|
15
|
+
import { Sessions, type SessionConfig } from "../session.js";
|
|
16
|
+
import { type ActionGovernor, type GovernorMode, type GovernorRetention } from "../govern.js";
|
|
18
17
|
import { MemoryBackend, MemoryHandle } from "../memory/handle.js";
|
|
19
18
|
import { MemoryTopicBuilder } from "../memory/topic.js";
|
|
20
19
|
import type { Embedder, Memory } from "../memory/types.js";
|
|
21
20
|
import { type LaserObserver } from "../observe.js";
|
|
22
21
|
import type { KeyRegistry, SigningKey } from "../signing.js";
|
|
23
22
|
import type { Topic } from "../stream/topic.js";
|
|
24
|
-
import {
|
|
23
|
+
import { ForkHandle } from "../managed/forks.js";
|
|
25
24
|
import { Kv } from "../managed/kv.js";
|
|
26
25
|
import { Bindings, Projections, Schemas } from "../managed/projections.js";
|
|
27
26
|
import { QueryRequest } from "../managed/query.js";
|
|
@@ -33,32 +32,32 @@ import type { AuthzHistoryReply, AuthzSubject, Role, WhoamiReply } from "../wire
|
|
|
33
32
|
import type { BatchItem } from "../wire/batch.js";
|
|
34
33
|
import type { ForkInfo } from "../wire/fork.js";
|
|
35
34
|
import type { KvNamespaceInfo } from "../wire/kv.js";
|
|
36
|
-
import type { QueryTarget } from "../wire/query.js";
|
|
37
|
-
import type {
|
|
35
|
+
import type { Query, QueryExecutionStatus, QueryResult, QueryTarget } from "../wire/query.js";
|
|
36
|
+
import type { CheckpointMutationResult, CheckpointRequestEnvelope } from "../wire/checkpoint.js";
|
|
37
|
+
import type { DestinationId, QueryExecutionId } from "../wire/ids.js";
|
|
38
38
|
import { AgentId, ConversationId } from "../types/ids.js";
|
|
39
39
|
import { type BytesLike } from "./bytes.js";
|
|
40
|
-
import { type AgentCard } from "../wire/agent.js";
|
|
40
|
+
import { type AgentCard, type AgentPresence } from "../wire/agent.js";
|
|
41
41
|
import { ContentType } from "../wire/content.js";
|
|
42
42
|
import { type Provenance } from "../provenance/provenance.js";
|
|
43
43
|
import type { ChannelId } from "../wire/ids.js";
|
|
44
44
|
import type { LogPosition } from "../wire/ids.js";
|
|
45
45
|
import type { AgentDeadLetter } from "../wire/agent.js";
|
|
46
46
|
import type { ConsumerGroupName } from "../types/ids.js";
|
|
47
|
-
import { INTERNAL_GOVERN, INTERNAL_REPLY_HUB, INTERNAL_TRANSPORT, INTERNAL_VERIFIER } from "./internals.js";
|
|
48
47
|
import { type Capabilities } from "./capabilities.js";
|
|
49
|
-
interface LaserTopology {
|
|
48
|
+
export interface LaserTopology {
|
|
50
49
|
readonly opsStream: string;
|
|
51
50
|
readonly controlTopic: string;
|
|
52
|
-
readonly
|
|
51
|
+
readonly dlqTopic: string;
|
|
53
52
|
readonly changesTopic: string;
|
|
54
53
|
}
|
|
55
|
-
interface TopologyOverrides {
|
|
54
|
+
export interface TopologyOverrides {
|
|
56
55
|
readonly opsStream: boolean;
|
|
57
56
|
readonly controlTopic: boolean;
|
|
58
|
-
readonly
|
|
57
|
+
readonly dlqTopic: boolean;
|
|
59
58
|
readonly changesTopic: boolean;
|
|
60
59
|
}
|
|
61
|
-
interface LaserBuildOptions {
|
|
60
|
+
export interface LaserBuildOptions {
|
|
62
61
|
readonly connectOptions: ConnectOptions;
|
|
63
62
|
readonly publishOptions: PublishOptions;
|
|
64
63
|
readonly connectionString?: string;
|
|
@@ -67,12 +66,8 @@ interface LaserBuildOptions {
|
|
|
67
66
|
readonly port: number;
|
|
68
67
|
};
|
|
69
68
|
readonly credentials?: {
|
|
70
|
-
readonly kind: "usernamePassword";
|
|
71
69
|
readonly username: string;
|
|
72
70
|
readonly password: string;
|
|
73
|
-
} | {
|
|
74
|
-
readonly kind: "token";
|
|
75
|
-
readonly token: string;
|
|
76
71
|
};
|
|
77
72
|
readonly client?: IggyClient;
|
|
78
73
|
readonly ownership: ClientOwnership;
|
|
@@ -88,14 +83,8 @@ interface LaserBuildOptions {
|
|
|
88
83
|
readonly topology: LaserTopology;
|
|
89
84
|
readonly topologyOverrides: TopologyOverrides;
|
|
90
85
|
}
|
|
91
|
-
export interface InjectedClientOptions {
|
|
92
|
-
readonly ownership?: ClientOwnership;
|
|
93
|
-
readonly defaultStream?: string;
|
|
94
|
-
readonly capabilities?: Capabilities;
|
|
95
|
-
readonly observer?: LaserObserver;
|
|
96
|
-
}
|
|
97
86
|
export declare class LaserBuilder {
|
|
98
|
-
private readonly
|
|
87
|
+
private readonly connectWith;
|
|
99
88
|
private connectOptionsValue;
|
|
100
89
|
private publishOptionsValue;
|
|
101
90
|
private connectionStringValue;
|
|
@@ -110,7 +99,7 @@ export declare class LaserBuilder {
|
|
|
110
99
|
private verifierValue;
|
|
111
100
|
private topologyValue;
|
|
112
101
|
private topologyOverridesValue;
|
|
113
|
-
constructor(
|
|
102
|
+
private constructor();
|
|
114
103
|
/**
|
|
115
104
|
* Budget for the initial connect: TCP dial, TLS handshake, login, and the managed capability probe. An expired budget rejects with `TimeoutError` naming the stage that stalled. Default: 30 seconds, or `LASER_CONNECT_TIMEOUT_MS`.
|
|
116
105
|
*/
|
|
@@ -121,19 +110,20 @@ export declare class LaserBuilder {
|
|
|
121
110
|
connectionString(value: string): this;
|
|
122
111
|
address(host: string, port?: number): this;
|
|
123
112
|
credentials(username: string, password: string): this;
|
|
124
|
-
|
|
125
|
-
iggyClient(client: IggyClient, options?: {
|
|
113
|
+
client(client: IggyClient, options?: {
|
|
126
114
|
readonly ownership?: ClientOwnership;
|
|
127
115
|
}): this;
|
|
128
|
-
|
|
116
|
+
stream(value: string): this;
|
|
129
117
|
capabilities(value: Capabilities): this;
|
|
130
118
|
governor(policy: ActionGovernor, mode: GovernorMode, retention?: Partial<GovernorRetention>): this;
|
|
131
119
|
observer(value: LaserObserver): this;
|
|
132
120
|
verifier(value: KeyRegistry): this;
|
|
133
121
|
opsStream(value: string): this;
|
|
134
122
|
controlTopic(value: string): this;
|
|
135
|
-
|
|
123
|
+
dlqTopic(value: string): this;
|
|
136
124
|
changesTopic(value: string): this;
|
|
125
|
+
/** Connects with the configured settings. A configuration conflict
|
|
126
|
+
* rejects before any I/O, like every other failure of the connect. */
|
|
137
127
|
connect(): Promise<Laser>;
|
|
138
128
|
}
|
|
139
129
|
export { INTERNAL_GOVERN, INTERNAL_REPLY_HUB, INTERNAL_TRANSPORT, INTERNAL_VERIFIER } from "./internals.js";
|
|
@@ -169,10 +159,18 @@ export declare class Laser implements AsyncDisposable {
|
|
|
169
159
|
private constructor();
|
|
170
160
|
get opsStream(): string;
|
|
171
161
|
get controlTopic(): string;
|
|
172
|
-
get
|
|
162
|
+
get dlqTopic(): string;
|
|
173
163
|
get changesTopic(): string;
|
|
174
164
|
static builder(): LaserBuilder;
|
|
175
|
-
|
|
165
|
+
/**
|
|
166
|
+
* Wrap a connected, logged-in Apache Iggy client with no default stream.
|
|
167
|
+
* Chain `withDefaultStream`, `withCapabilities`, or `withObserver` to
|
|
168
|
+
* configure the handle. A `borrowed` client (the default) stays open when
|
|
169
|
+
* the handle closes, an `owned` one closes with it.
|
|
170
|
+
*/
|
|
171
|
+
static fromClient(client: IggyClient, options?: {
|
|
172
|
+
readonly ownership?: ClientOwnership;
|
|
173
|
+
}): Promise<Laser>;
|
|
176
174
|
/**
|
|
177
175
|
* Connect using an Iggy connection string. Connecting gives up after 30 seconds, or `LASER_CONNECT_TIMEOUT_MS`, with a `TimeoutError` that says whether the server never accepted the connection or never answered the login. Use `Laser.builder().connectTimeout()` for another budget.
|
|
178
176
|
*/
|
|
@@ -181,9 +179,21 @@ export declare class Laser implements AsyncDisposable {
|
|
|
181
179
|
static connectEnv(env?: Readonly<Record<string, string | undefined>>): Promise<Laser>;
|
|
182
180
|
static local(): Promise<Laser>;
|
|
183
181
|
withDefaultStream(stream: string): Laser;
|
|
182
|
+
/** A clone whose managed operations use `opsStream` instead of the ops
|
|
183
|
+
* stream the deployment announced. The connection is shared. */
|
|
184
|
+
withOpsStream(opsStream: string): Laser;
|
|
185
|
+
/** A clone whose control commands publish to `controlTopic` on the ops
|
|
186
|
+
* stream. The connection is shared. */
|
|
187
|
+
withControlTopic(controlTopic: string): Laser;
|
|
188
|
+
/** A clone whose dead-letter capsules publish to `dlqTopic` on the ops
|
|
189
|
+
* stream. The connection is shared. */
|
|
190
|
+
withDlqTopic(dlqTopic: string): Laser;
|
|
191
|
+
/** A clone whose change-feed records are read from `changesTopic` on the ops
|
|
192
|
+
* stream. The connection is shared. */
|
|
193
|
+
withChangesTopic(changesTopic: string): Laser;
|
|
194
|
+
private withTopology;
|
|
184
195
|
withCapabilities(capabilities: Capabilities): Laser;
|
|
185
196
|
withGovernor(governor: ActionGovernor, mode: GovernorMode, retention?: Partial<GovernorRetention>): Laser;
|
|
186
|
-
withVerifier(verifier: KeyRegistry): Laser;
|
|
187
197
|
withObserver(observer: LaserObserver): Laser;
|
|
188
198
|
private observe;
|
|
189
199
|
private managedTransport;
|
|
@@ -192,11 +202,7 @@ export declare class Laser implements AsyncDisposable {
|
|
|
192
202
|
refreshCapabilities(): Promise<Capabilities>;
|
|
193
203
|
waitUntilReady(timeoutMs: number): Promise<Capabilities>;
|
|
194
204
|
private applyAdvertisedTopology;
|
|
195
|
-
|
|
196
|
-
[INTERNAL_VERIFIER](): KeyRegistry | undefined;
|
|
197
|
-
[INTERNAL_REPLY_HUB](topic: string): Promise<ReplyHub>;
|
|
198
|
-
[INTERNAL_GOVERN](action: Omit<Parameters<GovernorState["govern"]>[0], "counters">): Promise<Uint8Array>;
|
|
199
|
-
get iggyClient(): LaserTransport["iggyClient"];
|
|
205
|
+
get client(): IggyClient;
|
|
200
206
|
stream(name: string): Stream;
|
|
201
207
|
topic(name: string): Topic;
|
|
202
208
|
agdx(topic: string, source: AgentId, conversation: ConversationId): Agdx;
|
|
@@ -213,7 +219,7 @@ export declare class Laser implements AsyncDisposable {
|
|
|
213
219
|
/** The session accessor: one conversation seen as typed turns, a model-ready
|
|
214
220
|
* context, scoped memory, and checkpointed replay. Built on `context`, so a
|
|
215
221
|
* session is never a second store. */
|
|
216
|
-
sessions(
|
|
222
|
+
sessions(config?: SessionConfig): Sessions;
|
|
217
223
|
memory(namespace: string): MemoryHandle;
|
|
218
224
|
/** Opens durable memory on an existing caller-named topic. */
|
|
219
225
|
memoryOnTopic(topic: string, stream?: string): MemoryHandle;
|
|
@@ -225,7 +231,6 @@ export declare class Laser implements AsyncDisposable {
|
|
|
225
231
|
sendAgent(topic: string, payload: BytesLike, provenance: Provenance, options?: {
|
|
226
232
|
readonly contentType?: ContentType;
|
|
227
233
|
}): Promise<void>;
|
|
228
|
-
policyEvidence(conversation: ConversationId): Promise<readonly PolicyEvidence[]>;
|
|
229
234
|
private emitPolicyEvidence;
|
|
230
235
|
spawnSubconversation(parent: Provenance): Provenance;
|
|
231
236
|
reassembleChannel(conversation: ConversationId, topic: string, channel: ChannelId): Promise<readonly StreamEvent[]>;
|
|
@@ -233,7 +238,7 @@ export declare class Laser implements AsyncDisposable {
|
|
|
233
238
|
redriveDeadLetter(capsule: AgentDeadLetter): Promise<void>;
|
|
234
239
|
request(requestTopic: string, replyTopic: string, payload: BytesLike, provenance: Provenance, timeoutMs: number, signal?: AbortSignal): Promise<AgentMessage>;
|
|
235
240
|
clientMetadata(): ClientMetadataRequest;
|
|
236
|
-
advertisePresence(presence:
|
|
241
|
+
advertisePresence(presence: AgentPresence): Promise<void>;
|
|
237
242
|
clearPresence(): Promise<void>;
|
|
238
243
|
agentRegistry(): Promise<AgentRegistry>;
|
|
239
244
|
publishCard(source: AgentId, card: AgentCard): Promise<void>;
|
|
@@ -248,11 +253,14 @@ export declare class Laser implements AsyncDisposable {
|
|
|
248
253
|
queryTarget(target: QueryTarget): QueryRequest;
|
|
249
254
|
queryLakehouse(destinationId: DestinationId, destinationGeneration: bigint): QueryRequest;
|
|
250
255
|
destinations(): Destinations;
|
|
256
|
+
/** Sends one checkpoint request envelope, the deep form behind every
|
|
257
|
+
* `destinations()` mutation. */
|
|
258
|
+
executeCheckpoint(request: CheckpointRequestEnvelope): Promise<CheckpointMutationResult>;
|
|
251
259
|
private groupContext;
|
|
252
260
|
kv(namespace: string): Kv;
|
|
253
261
|
kvNamespaces(): Promise<readonly KvNamespaceInfo[]>;
|
|
254
262
|
executeBatch(ops: readonly BatchItem[]): Promise<readonly Uint8Array[]>;
|
|
255
|
-
fork(forkId: string):
|
|
263
|
+
fork(forkId: string): ForkHandle;
|
|
256
264
|
forks(): Promise<readonly ForkInfo[]>;
|
|
257
265
|
projections(): Projections;
|
|
258
266
|
bindings(): Bindings;
|
|
@@ -272,9 +280,17 @@ export declare class Laser implements AsyncDisposable {
|
|
|
272
280
|
bindRoles(userId: number, roles: readonly string[], expectRevision?: bigint): Promise<void>;
|
|
273
281
|
authzHistory(subject: AuthzSubject, limit: number, afterRevision?: bigint): Promise<AuthzHistoryReply>;
|
|
274
282
|
private publishControl;
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
283
|
+
/** Executes a pre-built `Query` and returns the raw paged result. Most
|
|
284
|
+
* callers want `query(index)...fetch()` instead. Needs `laser-plane` in Laser
|
|
285
|
+
* Stack or LaserData Cloud, otherwise it fails with `UnsupportedError`. */
|
|
286
|
+
executeQuery(query: Query): Promise<QueryResult>;
|
|
287
|
+
/** Retrieves the next cursor page of an executing query. Needs the
|
|
288
|
+
* `cursorPaging` capability. */
|
|
289
|
+
queryPage(executionId: QueryExecutionId, cursor: string, deadlineMicros: bigint): Promise<QueryResult>;
|
|
290
|
+
/** Reads the current state of an executing or recently completed query. */
|
|
291
|
+
queryStatus(executionId: QueryExecutionId): Promise<QueryExecutionStatus>;
|
|
292
|
+
/** Cancels an executing query by its unguessable identity. */
|
|
293
|
+
cancelQuery(executionId: QueryExecutionId): Promise<QueryExecutionStatus>;
|
|
278
294
|
/** Closes owned transport resources. Safe to call more than once. */
|
|
279
295
|
close(): Promise<void>;
|
|
280
296
|
/** Delegates async disposal to `close()`. */
|