@laserdata/laser-sdk 0.0.1-rc.21 → 0.0.1-rc.22
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 +1 -1
- package/dist/agent/agdx.d.ts +55 -0
- package/dist/agent/agdx.d.ts.map +1 -0
- package/dist/agent/agdx.js +447 -0
- package/dist/agent/agdx.js.map +1 -0
- package/dist/agent/assembler.d.ts +29 -0
- package/dist/agent/assembler.d.ts.map +1 -0
- package/dist/agent/assembler.js +69 -0
- package/dist/agent/assembler.js.map +1 -0
- package/dist/agent/builder.d.ts +114 -0
- package/dist/agent/builder.d.ts.map +1 -0
- package/dist/agent/builder.js +334 -0
- package/dist/agent/builder.js.map +1 -0
- package/dist/agent/context.d.ts +68 -0
- package/dist/agent/context.d.ts.map +1 -0
- package/dist/agent/context.js +212 -0
- package/dist/agent/context.js.map +1 -0
- package/dist/agent/contract.d.ts +70 -0
- package/dist/agent/contract.d.ts.map +1 -0
- package/dist/agent/contract.js +275 -0
- package/dist/agent/contract.js.map +1 -0
- package/dist/agent/registry.d.ts +76 -0
- package/dist/agent/registry.d.ts.map +1 -0
- package/dist/agent/registry.js +286 -0
- package/dist/agent/registry.js.map +1 -0
- package/dist/agent/reliable-consumer.d.ts +126 -0
- package/dist/agent/reliable-consumer.d.ts.map +1 -0
- package/dist/agent/reliable-consumer.js +551 -0
- package/dist/agent/reliable-consumer.js.map +1 -0
- package/dist/agent/replies.d.ts +28 -0
- package/dist/agent/replies.d.ts.map +1 -0
- package/dist/agent/replies.js +175 -0
- package/dist/agent/replies.js.map +1 -0
- package/dist/agent/router.d.ts +72 -0
- package/dist/agent/router.d.ts.map +1 -0
- package/dist/agent/router.js +172 -0
- package/dist/agent/router.js.map +1 -0
- package/dist/agent/scope.d.ts +16 -0
- package/dist/agent/scope.d.ts.map +1 -0
- package/dist/agent/scope.js +34 -0
- package/dist/agent/scope.js.map +1 -0
- package/dist/agent/workflow.d.ts +85 -0
- package/dist/agent/workflow.d.ts.map +1 -0
- package/dist/agent/workflow.js +416 -0
- package/dist/agent/workflow.js.map +1 -0
- package/dist/blob.d.ts +12 -0
- package/dist/blob.d.ts.map +1 -0
- package/dist/blob.js +34 -0
- package/dist/blob.js.map +1 -0
- package/dist/bridges/a2a.d.ts +89 -0
- package/dist/bridges/a2a.d.ts.map +1 -0
- package/dist/bridges/a2a.js +244 -0
- package/dist/bridges/a2a.js.map +1 -0
- package/dist/bridges/agui.d.ts +66 -0
- package/dist/bridges/agui.d.ts.map +1 -0
- package/dist/bridges/agui.js +335 -0
- package/dist/bridges/agui.js.map +1 -0
- package/dist/bridges/edge-auth.d.ts +16 -0
- package/dist/bridges/edge-auth.d.ts.map +1 -0
- package/dist/bridges/edge-auth.js +19 -0
- package/dist/bridges/edge-auth.js.map +1 -0
- package/dist/bridges/hops.d.ts +9 -0
- package/dist/bridges/hops.d.ts.map +1 -0
- package/dist/bridges/hops.js +16 -0
- package/dist/bridges/hops.js.map +1 -0
- package/dist/bridges/mcp.d.ts +79 -0
- package/dist/bridges/mcp.d.ts.map +1 -0
- package/dist/bridges/mcp.js +248 -0
- package/dist/bridges/mcp.js.map +1 -0
- package/dist/client/bytes.d.ts +3 -0
- package/dist/client/bytes.d.ts.map +1 -0
- package/dist/client/bytes.js +9 -0
- package/dist/client/bytes.js.map +1 -0
- package/dist/client/capabilities.d.ts +36 -0
- package/dist/client/capabilities.d.ts.map +1 -0
- package/dist/client/capabilities.js +91 -0
- package/dist/client/capabilities.js.map +1 -0
- package/dist/client/errors.d.ts +178 -0
- package/dist/client/errors.d.ts.map +1 -0
- package/dist/client/errors.js +192 -0
- package/dist/client/errors.js.map +1 -0
- package/dist/client/internals.d.ts +5 -0
- package/dist/client/internals.d.ts.map +1 -0
- package/dist/client/internals.js +5 -0
- package/dist/client/internals.js.map +1 -0
- package/dist/client/laser.d.ts +238 -0
- package/dist/client/laser.d.ts.map +1 -0
- package/dist/client/laser.js +831 -0
- package/dist/client/laser.js.map +1 -0
- package/dist/client/laserdata-ca.d.ts +2 -0
- package/dist/client/laserdata-ca.d.ts.map +1 -0
- package/dist/client/laserdata-ca.js +35 -0
- package/dist/client/laserdata-ca.js.map +1 -0
- package/dist/client/managed.d.ts +6 -0
- package/dist/client/managed.d.ts.map +1 -0
- package/dist/client/managed.js +19 -0
- package/dist/client/managed.js.map +1 -0
- package/dist/context-scope.d.ts +40 -0
- package/dist/context-scope.d.ts.map +1 -0
- package/dist/context-scope.js +73 -0
- package/dist/context-scope.js.map +1 -0
- package/dist/context.d.ts +64 -0
- package/dist/context.d.ts.map +1 -0
- package/dist/context.js +149 -0
- package/dist/context.js.map +1 -0
- package/dist/conversation-state.d.ts +24 -0
- package/dist/conversation-state.d.ts.map +1 -0
- package/dist/conversation-state.js +29 -0
- package/dist/conversation-state.js.map +1 -0
- package/dist/crash-context.d.ts +11 -0
- package/dist/crash-context.d.ts.map +1 -0
- package/dist/crash-context.js +62 -0
- package/dist/crash-context.js.map +1 -0
- package/dist/full.d.ts +3 -0
- package/dist/full.d.ts.map +1 -0
- package/dist/full.js +3 -0
- package/dist/full.js.map +1 -0
- package/dist/govern.d.ts +133 -0
- package/dist/govern.d.ts.map +1 -0
- package/dist/govern.js +347 -0
- package/dist/govern.js.map +1 -0
- package/dist/iggy/apache-iggy.d.ts +173 -0
- package/dist/iggy/apache-iggy.d.ts.map +1 -0
- package/dist/iggy/apache-iggy.js +634 -0
- package/dist/iggy/apache-iggy.js.map +1 -0
- package/dist/index.d.ts +121 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +64 -0
- package/dist/index.js.map +1 -0
- package/dist/intent.d.ts +75 -0
- package/dist/intent.d.ts.map +1 -0
- package/dist/intent.js +195 -0
- package/dist/intent.js.map +1 -0
- package/dist/managed/batch.d.ts +5 -0
- package/dist/managed/batch.d.ts.map +1 -0
- package/dist/managed/batch.js +32 -0
- package/dist/managed/batch.js.map +1 -0
- package/dist/managed/forks.d.ts +72 -0
- package/dist/managed/forks.d.ts.map +1 -0
- package/dist/managed/forks.js +188 -0
- package/dist/managed/forks.js.map +1 -0
- package/dist/managed/graph.d.ts +58 -0
- package/dist/managed/graph.d.ts.map +1 -0
- package/dist/managed/graph.js +176 -0
- package/dist/managed/graph.js.map +1 -0
- package/dist/managed/kv.d.ts +144 -0
- package/dist/managed/kv.d.ts.map +1 -0
- package/dist/managed/kv.js +502 -0
- package/dist/managed/kv.js.map +1 -0
- package/dist/managed/projections.d.ts +61 -0
- package/dist/managed/projections.d.ts.map +1 -0
- package/dist/managed/projections.js +191 -0
- package/dist/managed/projections.js.map +1 -0
- package/dist/managed/query.d.ts +72 -0
- package/dist/managed/query.d.ts.map +1 -0
- package/dist/managed/query.js +287 -0
- package/dist/managed/query.js.map +1 -0
- package/dist/managed/rbac.d.ts +16 -0
- package/dist/managed/rbac.d.ts.map +1 -0
- package/dist/managed/rbac.js +82 -0
- package/dist/managed/rbac.js.map +1 -0
- package/dist/managed/runs.d.ts +40 -0
- package/dist/managed/runs.d.ts.map +1 -0
- package/dist/managed/runs.js +112 -0
- package/dist/managed/runs.js.map +1 -0
- package/dist/managed/watch.d.ts +21 -0
- package/dist/managed/watch.d.ts.map +1 -0
- package/dist/managed/watch.js +73 -0
- package/dist/managed/watch.js.map +1 -0
- package/dist/memory/handle.d.ts +77 -0
- package/dist/memory/handle.d.ts.map +1 -0
- package/dist/memory/handle.js +234 -0
- package/dist/memory/handle.js.map +1 -0
- package/dist/memory/log-memory.d.ts +38 -0
- package/dist/memory/log-memory.d.ts.map +1 -0
- package/dist/memory/log-memory.js +309 -0
- package/dist/memory/log-memory.js.map +1 -0
- package/dist/memory/topic.d.ts +22 -0
- package/dist/memory/topic.d.ts.map +1 -0
- package/dist/memory/topic.js +56 -0
- package/dist/memory/topic.js.map +1 -0
- package/dist/memory/types.d.ts +108 -0
- package/dist/memory/types.d.ts.map +1 -0
- package/dist/memory/types.js +127 -0
- package/dist/memory/types.js.map +1 -0
- package/dist/memory/vector-memory.d.ts +20 -0
- package/dist/memory/vector-memory.d.ts.map +1 -0
- package/dist/memory/vector-memory.js +193 -0
- package/dist/memory/vector-memory.js.map +1 -0
- package/dist/memory.d.ts +7 -0
- package/dist/memory.d.ts.map +1 -0
- package/dist/memory.js +6 -0
- package/dist/memory.js.map +1 -0
- package/dist/observe.d.ts +10 -0
- package/dist/observe.d.ts.map +1 -0
- package/dist/observe.js +5 -0
- package/dist/observe.js.map +1 -0
- package/dist/opentelemetry.d.ts +22 -0
- package/dist/opentelemetry.d.ts.map +1 -0
- package/dist/opentelemetry.js +38 -0
- package/dist/opentelemetry.js.map +1 -0
- package/dist/provenance/agent-topic.d.ts +14 -0
- package/dist/provenance/agent-topic.d.ts.map +1 -0
- package/dist/provenance/agent-topic.js +13 -0
- package/dist/provenance/agent-topic.js.map +1 -0
- package/dist/provenance/provenance.d.ts +24 -0
- package/dist/provenance/provenance.d.ts.map +1 -0
- package/dist/provenance/provenance.js +186 -0
- package/dist/provenance/provenance.js.map +1 -0
- package/dist/provenance/session-policy.d.ts +4 -0
- package/dist/provenance/session-policy.d.ts.map +1 -0
- package/dist/provenance/session-policy.js +5 -0
- package/dist/provenance/session-policy.js.map +1 -0
- package/dist/runtime/async-once.d.ts +6 -0
- package/dist/runtime/async-once.d.ts.map +1 -0
- package/dist/runtime/async-once.js +19 -0
- package/dist/runtime/async-once.js.map +1 -0
- package/dist/runtime/clock.d.ts +14 -0
- package/dist/runtime/clock.d.ts.map +1 -0
- package/dist/runtime/clock.js +21 -0
- package/dist/runtime/clock.js.map +1 -0
- package/dist/runtime/mutex.d.ts +5 -0
- package/dist/runtime/mutex.d.ts.map +1 -0
- package/dist/runtime/mutex.js +23 -0
- package/dist/runtime/mutex.js.map +1 -0
- package/dist/runtime/ulid.d.ts +7 -0
- package/dist/runtime/ulid.d.ts.map +1 -0
- package/dist/runtime/ulid.js +17 -0
- package/dist/runtime/ulid.js.map +1 -0
- package/dist/schema-codecs.d.ts +16 -0
- package/dist/schema-codecs.d.ts.map +1 -0
- package/dist/schema-codecs.js +174 -0
- package/dist/schema-codecs.js.map +1 -0
- package/dist/signing.d.ts +63 -0
- package/dist/signing.d.ts.map +1 -0
- package/dist/signing.js +288 -0
- package/dist/signing.js.map +1 -0
- package/dist/snapshot.d.ts +24 -0
- package/dist/snapshot.d.ts.map +1 -0
- package/dist/snapshot.js +80 -0
- package/dist/snapshot.js.map +1 -0
- package/dist/state-store.d.ts +20 -0
- package/dist/state-store.d.ts.map +1 -0
- package/dist/state-store.js +70 -0
- package/dist/state-store.js.map +1 -0
- package/dist/stream/codecs.d.ts +9 -0
- package/dist/stream/codecs.d.ts.map +1 -0
- package/dist/stream/codecs.js +83 -0
- package/dist/stream/codecs.js.map +1 -0
- package/dist/stream/consumer.d.ts +50 -0
- package/dist/stream/consumer.d.ts.map +1 -0
- package/dist/stream/consumer.js +145 -0
- package/dist/stream/consumer.js.map +1 -0
- package/dist/stream/cursor.d.ts +26 -0
- package/dist/stream/cursor.d.ts.map +1 -0
- package/dist/stream/cursor.js +83 -0
- package/dist/stream/cursor.js.map +1 -0
- package/dist/stream/header-value.d.ts +18 -0
- package/dist/stream/header-value.d.ts.map +1 -0
- package/dist/stream/header-value.js +70 -0
- package/dist/stream/header-value.js.map +1 -0
- package/dist/stream/polling-strategy.d.ts +14 -0
- package/dist/stream/polling-strategy.d.ts.map +1 -0
- package/dist/stream/polling-strategy.js +2 -0
- package/dist/stream/polling-strategy.js.map +1 -0
- package/dist/stream/producer.d.ts +44 -0
- package/dist/stream/producer.d.ts.map +1 -0
- package/dist/stream/producer.js +125 -0
- package/dist/stream/producer.js.map +1 -0
- package/dist/stream/publish.d.ts +83 -0
- package/dist/stream/publish.d.ts.map +1 -0
- package/dist/stream/publish.js +287 -0
- package/dist/stream/publish.js.map +1 -0
- package/dist/stream/record.d.ts +29 -0
- package/dist/stream/record.d.ts.map +1 -0
- package/dist/stream/record.js +152 -0
- package/dist/stream/record.js.map +1 -0
- package/dist/stream/routing.d.ts +10 -0
- package/dist/stream/routing.d.ts.map +1 -0
- package/dist/stream/routing.js +2 -0
- package/dist/stream/routing.js.map +1 -0
- package/dist/stream/stream.d.ts +14 -0
- package/dist/stream/stream.d.ts.map +1 -0
- package/dist/stream/stream.js +26 -0
- package/dist/stream/stream.js.map +1 -0
- package/dist/stream/topic.d.ts +52 -0
- package/dist/stream/topic.d.ts.map +1 -0
- package/dist/stream/topic.js +181 -0
- package/dist/stream/topic.js.map +1 -0
- package/dist/stream/typed-topic.d.ts +59 -0
- package/dist/stream/typed-topic.d.ts.map +1 -0
- package/dist/stream/typed-topic.js +119 -0
- package/dist/stream/typed-topic.js.map +1 -0
- package/dist/swarm.d.ts +16 -0
- package/dist/swarm.d.ts.map +1 -0
- package/dist/swarm.js +40 -0
- package/dist/swarm.js.map +1 -0
- package/dist/testing.d.ts +16 -0
- package/dist/testing.d.ts.map +1 -0
- package/dist/testing.js +19 -0
- package/dist/testing.js.map +1 -0
- package/dist/types/ids.d.ts +48 -0
- package/dist/types/ids.d.ts.map +1 -0
- package/dist/types/ids.js +161 -0
- package/dist/types/ids.js.map +1 -0
- package/dist/wire/agent-record.d.ts +24 -0
- package/dist/wire/agent-record.d.ts.map +1 -0
- package/dist/wire/agent-record.js +99 -0
- package/dist/wire/agent-record.js.map +1 -0
- package/dist/wire/agent-workflow.d.ts +118 -0
- package/dist/wire/agent-workflow.d.ts.map +1 -0
- package/dist/wire/agent-workflow.js +290 -0
- package/dist/wire/agent-workflow.js.map +1 -0
- package/dist/wire/agent.d.ts +255 -0
- package/dist/wire/agent.d.ts.map +1 -0
- package/dist/wire/agent.js +792 -0
- package/dist/wire/agent.js.map +1 -0
- package/dist/wire/authz.d.ts +186 -0
- package/dist/wire/authz.d.ts.map +1 -0
- package/dist/wire/authz.js +545 -0
- package/dist/wire/authz.js.map +1 -0
- package/dist/wire/batch.d.ts +17 -0
- package/dist/wire/batch.d.ts.map +1 -0
- package/dist/wire/batch.js +41 -0
- package/dist/wire/batch.js.map +1 -0
- package/dist/wire/browse.d.ts +96 -0
- package/dist/wire/browse.d.ts.map +1 -0
- package/dist/wire/browse.js +201 -0
- package/dist/wire/browse.js.map +1 -0
- package/dist/wire/cbor.d.ts +35 -0
- package/dist/wire/cbor.d.ts.map +1 -0
- package/dist/wire/cbor.js +231 -0
- package/dist/wire/cbor.js.map +1 -0
- package/dist/wire/change.d.ts +12 -0
- package/dist/wire/change.d.ts.map +1 -0
- package/dist/wire/change.js +22 -0
- package/dist/wire/change.js.map +1 -0
- package/dist/wire/clients.d.ts +27 -0
- package/dist/wire/clients.d.ts.map +1 -0
- package/dist/wire/clients.js +64 -0
- package/dist/wire/clients.js.map +1 -0
- package/dist/wire/codes.d.ts +67 -0
- package/dist/wire/codes.d.ts.map +1 -0
- package/dist/wire/codes.js +67 -0
- package/dist/wire/codes.js.map +1 -0
- package/dist/wire/commands.d.ts +68 -0
- package/dist/wire/commands.d.ts.map +1 -0
- package/dist/wire/commands.js +140 -0
- package/dist/wire/commands.js.map +1 -0
- package/dist/wire/content.d.ts +17 -0
- package/dist/wire/content.d.ts.map +1 -0
- package/dist/wire/content.js +47 -0
- package/dist/wire/content.js.map +1 -0
- package/dist/wire/control.d.ts +170 -0
- package/dist/wire/control.d.ts.map +1 -0
- package/dist/wire/control.js +453 -0
- package/dist/wire/control.js.map +1 -0
- package/dist/wire/fork.d.ts +112 -0
- package/dist/wire/fork.d.ts.map +1 -0
- package/dist/wire/fork.js +280 -0
- package/dist/wire/fork.js.map +1 -0
- package/dist/wire/forward.d.ts +23 -0
- package/dist/wire/forward.d.ts.map +1 -0
- package/dist/wire/forward.js +72 -0
- package/dist/wire/forward.js.map +1 -0
- package/dist/wire/graph.d.ts +181 -0
- package/dist/wire/graph.d.ts.map +1 -0
- package/dist/wire/graph.js +554 -0
- package/dist/wire/graph.js.map +1 -0
- package/dist/wire/hashing.d.ts +2 -0
- package/dist/wire/hashing.d.ts.map +1 -0
- package/dist/wire/hashing.js +21 -0
- package/dist/wire/hashing.js.map +1 -0
- package/dist/wire/headers.d.ts +32 -0
- package/dist/wire/headers.d.ts.map +1 -0
- package/dist/wire/headers.js +32 -0
- package/dist/wire/headers.js.map +1 -0
- package/dist/wire/hello.d.ts +50 -0
- package/dist/wire/hello.d.ts.map +1 -0
- package/dist/wire/hello.js +122 -0
- package/dist/wire/hello.js.map +1 -0
- package/dist/wire/http.d.ts +95 -0
- package/dist/wire/http.d.ts.map +1 -0
- package/dist/wire/http.js +282 -0
- package/dist/wire/http.js.map +1 -0
- package/dist/wire/ids.d.ts +50 -0
- package/dist/wire/ids.d.ts.map +1 -0
- package/dist/wire/ids.js +198 -0
- package/dist/wire/ids.js.map +1 -0
- package/dist/wire/index.d.ts +32 -0
- package/dist/wire/index.d.ts.map +1 -0
- package/dist/wire/index.js +32 -0
- package/dist/wire/index.js.map +1 -0
- package/dist/wire/kv.d.ts +260 -0
- package/dist/wire/kv.d.ts.map +1 -0
- package/dist/wire/kv.js +650 -0
- package/dist/wire/kv.js.map +1 -0
- package/dist/wire/limits.d.ts +36 -0
- package/dist/wire/limits.d.ts.map +1 -0
- package/dist/wire/limits.js +36 -0
- package/dist/wire/limits.js.map +1 -0
- package/dist/wire/memory.d.ts +17 -0
- package/dist/wire/memory.d.ts.map +1 -0
- package/dist/wire/memory.js +65 -0
- package/dist/wire/memory.js.map +1 -0
- package/dist/wire/mutation.d.ts +10 -0
- package/dist/wire/mutation.d.ts.map +1 -0
- package/dist/wire/mutation.js +18 -0
- package/dist/wire/mutation.js.map +1 -0
- package/dist/wire/query.d.ts +210 -0
- package/dist/wire/query.d.ts.map +1 -0
- package/dist/wire/query.js +594 -0
- package/dist/wire/query.js.map +1 -0
- package/dist/wire/result.d.ts +25 -0
- package/dist/wire/result.d.ts.map +1 -0
- package/dist/wire/result.js +52 -0
- package/dist/wire/result.js.map +1 -0
- package/dist/wire/snapshot.d.ts +11 -0
- package/dist/wire/snapshot.d.ts.map +1 -0
- package/dist/wire/snapshot.js +50 -0
- package/dist/wire/snapshot.js.map +1 -0
- package/dist/wire/topics.d.ts +5 -0
- package/dist/wire/topics.d.ts.map +1 -0
- package/dist/wire/topics.js +5 -0
- package/dist/wire/topics.js.map +1 -0
- package/dist/wire/topology.d.ts +24 -0
- package/dist/wire/topology.d.ts.map +1 -0
- package/dist/wire/topology.js +56 -0
- package/dist/wire/topology.js.map +1 -0
- package/dist/wire/value.d.ts +21 -0
- package/dist/wire/value.d.ts.map +1 -0
- package/dist/wire/value.js +40 -0
- package/dist/wire/value.js.map +1 -0
- package/package.json +2 -1
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { UnsupportedError } from "../client/errors.js";
|
|
2
|
+
import { decodeOne, expectMap } from "../wire/cbor.js";
|
|
3
|
+
import { decodeChangeRecord } from "../wire/change.js";
|
|
4
|
+
function tryDecodeChangeRecord(payload) {
|
|
5
|
+
try {
|
|
6
|
+
const map = expectMap(decodeOne(payload, "change record"), "change record");
|
|
7
|
+
return decodeChangeRecord(map, "change record");
|
|
8
|
+
}
|
|
9
|
+
catch {
|
|
10
|
+
return undefined;
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
export class Watch {
|
|
14
|
+
getCapabilities;
|
|
15
|
+
openCursor;
|
|
16
|
+
filterIndex;
|
|
17
|
+
constructor(getCapabilities, openCursor) {
|
|
18
|
+
this.getCapabilities = getCapabilities;
|
|
19
|
+
this.openCursor = openCursor;
|
|
20
|
+
}
|
|
21
|
+
index(index) {
|
|
22
|
+
this.filterIndex = index;
|
|
23
|
+
return this;
|
|
24
|
+
}
|
|
25
|
+
async records() {
|
|
26
|
+
const capabilities = await this.getCapabilities();
|
|
27
|
+
if (!capabilities.watch) {
|
|
28
|
+
throw new UnsupportedError("the change feed is not published by this deployment", {
|
|
29
|
+
cause: { surface: "watch", feature: "watch" }
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
const cursor = await this.openCursor();
|
|
33
|
+
return new WatchReader(cursor, this.filterIndex);
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
export class WatchReader {
|
|
37
|
+
cursor;
|
|
38
|
+
filterIndex;
|
|
39
|
+
constructor(cursor, filterIndex) {
|
|
40
|
+
this.cursor = cursor;
|
|
41
|
+
this.filterIndex = filterIndex;
|
|
42
|
+
}
|
|
43
|
+
fromOffsets(offsets) {
|
|
44
|
+
this.cursor = this.cursor.fromOffsets(offsets);
|
|
45
|
+
return this;
|
|
46
|
+
}
|
|
47
|
+
get offsets() {
|
|
48
|
+
return this.cursor.offsets;
|
|
49
|
+
}
|
|
50
|
+
async poll() {
|
|
51
|
+
const messages = await this.cursor.poll();
|
|
52
|
+
const records = [];
|
|
53
|
+
for (const message of messages) {
|
|
54
|
+
const record = tryDecodeChangeRecord(message.payload);
|
|
55
|
+
if (record === undefined)
|
|
56
|
+
continue;
|
|
57
|
+
if (this.filterIndex !== undefined && record.index !== this.filterIndex)
|
|
58
|
+
continue;
|
|
59
|
+
records.push(record);
|
|
60
|
+
}
|
|
61
|
+
return records;
|
|
62
|
+
}
|
|
63
|
+
async *stream() {
|
|
64
|
+
for (;;) {
|
|
65
|
+
const batch = await this.poll();
|
|
66
|
+
if (batch.length === 0)
|
|
67
|
+
return;
|
|
68
|
+
for (const record of batch)
|
|
69
|
+
yield record;
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
//# sourceMappingURL=watch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/managed/watch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAAqB,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGzE,SAAS,qBAAqB,CAAC,OAAmB;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,eAAe,CAAC,CAAA;QAC3E,OAAO,kBAAkB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,KAAK;IAIG,eAAe;IACf,UAAU;IAJrB,WAAW,CAAoB;IAEvC,YACmB,eAA4C,EAC5C,UAAwD;+BADxD,eAAe;0BACf,UAAU;IAC1B,CAAC;IAEJ,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QACjD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,IAAI,gBAAgB,CAAC,qDAAqD,EAAE;gBAChF,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;aAC9C,CAAC,CAAA;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACtC,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;IAClD,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IAEZ,MAAM;IACG,WAAW;IAF9B,YACU,MAAc,EACL,WAA+B;sBADxC,MAAM;2BACG,WAAW;IAC3B,CAAC;IAEJ,WAAW,CAAC,OAAoC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAC9C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;QACzC,MAAM,OAAO,GAAmB,EAAE,CAAA;QAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACrD,IAAI,MAAM,KAAK,SAAS;gBAAE,SAAQ;YAClC,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,WAAW;gBAAE,SAAQ;YACjF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,CAAC,MAAM;QACX,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;YAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAC9B,KAAK,MAAM,MAAM,IAAI,KAAK;gBAAE,MAAM,MAAM,CAAA;QAC1C,CAAC;IACH,CAAC;CACF"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import type { Laser } from "../client/laser.js";
|
|
2
|
+
import type { AgentId, ConversationId } from "../types/ids.js";
|
|
3
|
+
import { LogMemory } from "./log-memory.js";
|
|
4
|
+
import { MemoryId, MemoryKind, RecallStrategy, type Embedder, type Feedback, type ConsolidationReport, type Memory, type MemoryItem, type MemoryQuery, type MemoryScope, type Reranker } from "./types.js";
|
|
5
|
+
export declare const MemoryBackend: {
|
|
6
|
+
readonly Auto: "auto";
|
|
7
|
+
readonly Log: "log";
|
|
8
|
+
readonly Vector: "vector";
|
|
9
|
+
};
|
|
10
|
+
export type MemoryBackend = (typeof MemoryBackend)[keyof typeof MemoryBackend];
|
|
11
|
+
export declare class MemoryHandle implements Memory {
|
|
12
|
+
private readonly backend;
|
|
13
|
+
constructor(backend: Memory);
|
|
14
|
+
static log(laser: Laser, namespace: string): MemoryHandle;
|
|
15
|
+
/** Opens durable memory on a caller-named topic. */
|
|
16
|
+
static logTopic(laser: Laser, topic: string, stream?: string): MemoryHandle;
|
|
17
|
+
static vector(embedder?: Embedder): MemoryHandle;
|
|
18
|
+
static governedVector(laser: Laser, embedder?: Embedder): MemoryHandle;
|
|
19
|
+
static custom(memory: Memory): MemoryHandle;
|
|
20
|
+
remember(payload: Uint8Array): RememberBuilder;
|
|
21
|
+
remember(scope: MemoryScope, payload: Uint8Array): Promise<MemoryId>;
|
|
22
|
+
recall(): RecallBuilder;
|
|
23
|
+
recall(scope: MemoryScope, query: MemoryQuery): Promise<readonly MemoryItem[]>;
|
|
24
|
+
/** Recall by folding the memory topic in process instead of reading the
|
|
25
|
+
* managed view. The log backend folds, the vector backend is already in
|
|
26
|
+
* process, and a reranked backend folds its inner backend then reranks. */
|
|
27
|
+
recallFolded(scope: MemoryScope, query: MemoryQuery): Promise<readonly MemoryItem[]>;
|
|
28
|
+
improve(scope: MemoryScope, feedback: Feedback): Promise<MemoryId>;
|
|
29
|
+
forget(scope: MemoryScope, id: MemoryId): Promise<void>;
|
|
30
|
+
context(scope: MemoryScope, query?: MemoryQuery): Promise<string>;
|
|
31
|
+
consolidate(scope: MemoryScope, maxItems: number): Promise<ConsolidationReport>;
|
|
32
|
+
reranker(reranker: Reranker): MemoryHandle;
|
|
33
|
+
logBackend(): LogMemory | undefined;
|
|
34
|
+
append(scope: MemoryScope, id: MemoryId, kind: MemoryKind, payload: Uint8Array): Promise<MemoryId>;
|
|
35
|
+
}
|
|
36
|
+
export declare class RememberBuilder {
|
|
37
|
+
private readonly handle;
|
|
38
|
+
private readonly payload;
|
|
39
|
+
private scope;
|
|
40
|
+
private memoryKind;
|
|
41
|
+
private deduplicate;
|
|
42
|
+
constructor(handle: MemoryHandle, payload: Uint8Array);
|
|
43
|
+
conversation(conversation: ConversationId): this;
|
|
44
|
+
user(user: string): this;
|
|
45
|
+
agent(agent: AgentId): this;
|
|
46
|
+
application(application: string): this;
|
|
47
|
+
stream(stream: string): this;
|
|
48
|
+
durable(): this;
|
|
49
|
+
kind(kind: MemoryKind): this;
|
|
50
|
+
dedup(): this;
|
|
51
|
+
send(): Promise<MemoryId>;
|
|
52
|
+
}
|
|
53
|
+
export declare class RecallBuilder {
|
|
54
|
+
private readonly handle;
|
|
55
|
+
private scope;
|
|
56
|
+
private query;
|
|
57
|
+
private foldInProcess;
|
|
58
|
+
constructor(handle: MemoryHandle);
|
|
59
|
+
conversation(conversation: ConversationId): this;
|
|
60
|
+
user(user: string): this;
|
|
61
|
+
agent(agent: AgentId): this;
|
|
62
|
+
application(application: string): this;
|
|
63
|
+
stream(stream: string): this;
|
|
64
|
+
recent(): this;
|
|
65
|
+
semantic(text: string): this;
|
|
66
|
+
keyword(text: string): this;
|
|
67
|
+
hybrid(text: string): this;
|
|
68
|
+
strategy(strategy: RecallStrategy): this;
|
|
69
|
+
limit(limit: number): this;
|
|
70
|
+
tokenBudget(tokenBudget: number): this;
|
|
71
|
+
/** Fold the memory topic in process instead of reading the managed key-value
|
|
72
|
+
* view, for a deployment that materializes no read view. */
|
|
73
|
+
folded(): this;
|
|
74
|
+
fetch(): Promise<readonly MemoryItem[]>;
|
|
75
|
+
block(): Promise<string>;
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=handle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/memory/handle.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,234 @@
|
|
|
1
|
+
import { LogMemory } from "./log-memory.js";
|
|
2
|
+
import { Lifetime, MemoryId, MemoryKind, RecallStrategy, toContextBlock } from "./types.js";
|
|
3
|
+
import { VectorMemory } from "./vector-memory.js";
|
|
4
|
+
export const MemoryBackend = { Auto: "auto", Log: "log", Vector: "vector" };
|
|
5
|
+
export class MemoryHandle {
|
|
6
|
+
backend;
|
|
7
|
+
constructor(backend) {
|
|
8
|
+
this.backend = backend;
|
|
9
|
+
}
|
|
10
|
+
static log(laser, namespace) {
|
|
11
|
+
return new MemoryHandle(new LogMemory(laser, namespace));
|
|
12
|
+
}
|
|
13
|
+
/** Opens durable memory on a caller-named topic. */
|
|
14
|
+
static logTopic(laser, topic, stream) {
|
|
15
|
+
return new MemoryHandle(new LogMemory(laser, topic, topic, stream));
|
|
16
|
+
}
|
|
17
|
+
static vector(embedder) {
|
|
18
|
+
return new MemoryHandle(new VectorMemory(embedder));
|
|
19
|
+
}
|
|
20
|
+
static governedVector(laser, embedder) {
|
|
21
|
+
return new MemoryHandle(VectorMemory.governed(laser, embedder));
|
|
22
|
+
}
|
|
23
|
+
static custom(memory) {
|
|
24
|
+
return new MemoryHandle(memory);
|
|
25
|
+
}
|
|
26
|
+
remember(scopeOrPayload, payload) {
|
|
27
|
+
if (scopeOrPayload instanceof Uint8Array)
|
|
28
|
+
return new RememberBuilder(this, scopeOrPayload);
|
|
29
|
+
return this.backend.remember(scopeOrPayload, required(payload));
|
|
30
|
+
}
|
|
31
|
+
recall(scope, query) {
|
|
32
|
+
if (scope === undefined)
|
|
33
|
+
return new RecallBuilder(this);
|
|
34
|
+
return this.backend.recall(scope, query ?? {});
|
|
35
|
+
}
|
|
36
|
+
/** Recall by folding the memory topic in process instead of reading the
|
|
37
|
+
* managed view. The log backend folds, the vector backend is already in
|
|
38
|
+
* process, and a reranked backend folds its inner backend then reranks. */
|
|
39
|
+
recallFolded(scope, query) {
|
|
40
|
+
return recallFoldedOn(this.backend, scope, query);
|
|
41
|
+
}
|
|
42
|
+
improve(scope, feedback) {
|
|
43
|
+
return this.backend.improve(scope, feedback);
|
|
44
|
+
}
|
|
45
|
+
forget(scope, id) {
|
|
46
|
+
return this.backend.forget(scope, id);
|
|
47
|
+
}
|
|
48
|
+
async context(scope, query = {}) {
|
|
49
|
+
return toContextBlock(await this.backend.recall(scope, query), query.tokenBudget);
|
|
50
|
+
}
|
|
51
|
+
async consolidate(scope, maxItems) {
|
|
52
|
+
const items = await this.backend.recall(scope, {
|
|
53
|
+
limit: 10_000,
|
|
54
|
+
strategy: RecallStrategy.Recent
|
|
55
|
+
});
|
|
56
|
+
const stale = items.slice(Math.max(0, maxItems));
|
|
57
|
+
for (const item of stale)
|
|
58
|
+
await this.backend.forget(scope, item.id);
|
|
59
|
+
return { scanned: items.length, kept: items.length - stale.length, forgotten: stale.length };
|
|
60
|
+
}
|
|
61
|
+
reranker(reranker) {
|
|
62
|
+
return new MemoryHandle(new RerankedMemory(this.backend, reranker));
|
|
63
|
+
}
|
|
64
|
+
logBackend() {
|
|
65
|
+
return this.backend instanceof LogMemory ? this.backend : undefined;
|
|
66
|
+
}
|
|
67
|
+
append(scope, id, kind, payload) {
|
|
68
|
+
if (this.backend instanceof VectorMemory || this.backend instanceof LogMemory) {
|
|
69
|
+
return this.backend.append(scope, id, kind, payload);
|
|
70
|
+
}
|
|
71
|
+
return this.backend.remember(scope, payload);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
export class RememberBuilder {
|
|
75
|
+
handle;
|
|
76
|
+
payload;
|
|
77
|
+
scope = {};
|
|
78
|
+
memoryKind = MemoryKind.Fact;
|
|
79
|
+
deduplicate = false;
|
|
80
|
+
constructor(handle, payload) {
|
|
81
|
+
this.handle = handle;
|
|
82
|
+
this.payload = payload;
|
|
83
|
+
}
|
|
84
|
+
conversation(conversation) {
|
|
85
|
+
this.scope = { ...this.scope, conversation };
|
|
86
|
+
return this;
|
|
87
|
+
}
|
|
88
|
+
user(user) {
|
|
89
|
+
this.scope = { ...this.scope, user };
|
|
90
|
+
return this;
|
|
91
|
+
}
|
|
92
|
+
agent(agent) {
|
|
93
|
+
this.scope = { ...this.scope, agent };
|
|
94
|
+
return this;
|
|
95
|
+
}
|
|
96
|
+
application(application) {
|
|
97
|
+
this.scope = { ...this.scope, application };
|
|
98
|
+
return this;
|
|
99
|
+
}
|
|
100
|
+
stream(stream) {
|
|
101
|
+
this.scope = { ...this.scope, stream };
|
|
102
|
+
return this;
|
|
103
|
+
}
|
|
104
|
+
durable() {
|
|
105
|
+
this.scope = { ...this.scope, lifetime: Lifetime.Durable };
|
|
106
|
+
return this;
|
|
107
|
+
}
|
|
108
|
+
kind(kind) {
|
|
109
|
+
this.memoryKind = kind;
|
|
110
|
+
return this;
|
|
111
|
+
}
|
|
112
|
+
dedup() {
|
|
113
|
+
this.deduplicate = true;
|
|
114
|
+
return this;
|
|
115
|
+
}
|
|
116
|
+
send() {
|
|
117
|
+
const id = this.deduplicate
|
|
118
|
+
? MemoryId.content(this.scope, this.memoryKind, this.payload)
|
|
119
|
+
: MemoryId.new();
|
|
120
|
+
return this.handle.append(this.scope, id, this.memoryKind, this.payload);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
export class RecallBuilder {
|
|
124
|
+
handle;
|
|
125
|
+
scope = {};
|
|
126
|
+
query = {};
|
|
127
|
+
foldInProcess = false;
|
|
128
|
+
constructor(handle) {
|
|
129
|
+
this.handle = handle;
|
|
130
|
+
}
|
|
131
|
+
conversation(conversation) {
|
|
132
|
+
this.scope = { ...this.scope, conversation };
|
|
133
|
+
return this;
|
|
134
|
+
}
|
|
135
|
+
user(user) {
|
|
136
|
+
this.scope = { ...this.scope, user };
|
|
137
|
+
return this;
|
|
138
|
+
}
|
|
139
|
+
agent(agent) {
|
|
140
|
+
this.scope = { ...this.scope, agent };
|
|
141
|
+
return this;
|
|
142
|
+
}
|
|
143
|
+
application(application) {
|
|
144
|
+
this.scope = { ...this.scope, application };
|
|
145
|
+
return this;
|
|
146
|
+
}
|
|
147
|
+
stream(stream) {
|
|
148
|
+
this.scope = { ...this.scope, stream };
|
|
149
|
+
return this;
|
|
150
|
+
}
|
|
151
|
+
recent() {
|
|
152
|
+
this.query = { ...this.query, strategy: RecallStrategy.Recent };
|
|
153
|
+
return this;
|
|
154
|
+
}
|
|
155
|
+
semantic(text) {
|
|
156
|
+
this.query = { ...this.query, semantic: text, strategy: RecallStrategy.Semantic };
|
|
157
|
+
return this;
|
|
158
|
+
}
|
|
159
|
+
keyword(text) {
|
|
160
|
+
this.query = { ...this.query, semantic: text, strategy: RecallStrategy.Keyword };
|
|
161
|
+
return this;
|
|
162
|
+
}
|
|
163
|
+
hybrid(text) {
|
|
164
|
+
this.query = { ...this.query, semantic: text, strategy: RecallStrategy.Hybrid };
|
|
165
|
+
return this;
|
|
166
|
+
}
|
|
167
|
+
strategy(strategy) {
|
|
168
|
+
this.query = { ...this.query, strategy };
|
|
169
|
+
return this;
|
|
170
|
+
}
|
|
171
|
+
limit(limit) {
|
|
172
|
+
this.query = { ...this.query, limit };
|
|
173
|
+
return this;
|
|
174
|
+
}
|
|
175
|
+
tokenBudget(tokenBudget) {
|
|
176
|
+
this.query = { ...this.query, tokenBudget };
|
|
177
|
+
return this;
|
|
178
|
+
}
|
|
179
|
+
/** Fold the memory topic in process instead of reading the managed key-value
|
|
180
|
+
* view, for a deployment that materializes no read view. */
|
|
181
|
+
folded() {
|
|
182
|
+
this.foldInProcess = true;
|
|
183
|
+
return this;
|
|
184
|
+
}
|
|
185
|
+
fetch() {
|
|
186
|
+
return this.foldInProcess
|
|
187
|
+
? this.handle.recallFolded(this.scope, this.query)
|
|
188
|
+
: this.handle.recall(this.scope, this.query);
|
|
189
|
+
}
|
|
190
|
+
async block() {
|
|
191
|
+
return toContextBlock(await this.fetch(), this.query.tokenBudget);
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
// The fold dispatch, mirroring Rust's `recall_folded`: the log backend folds its
|
|
195
|
+
// topic, the vector backend is already in process, a reranked backend folds its
|
|
196
|
+
// inner backend and reranks that, and a custom backend has no separate fold.
|
|
197
|
+
async function recallFoldedOn(backend, scope, query) {
|
|
198
|
+
if (backend instanceof LogMemory)
|
|
199
|
+
return backend.recallFolded(scope, query);
|
|
200
|
+
if (backend instanceof RerankedMemory)
|
|
201
|
+
return backend.recallFolded(scope, query);
|
|
202
|
+
return backend.recall(scope, query);
|
|
203
|
+
}
|
|
204
|
+
class RerankedMemory {
|
|
205
|
+
inner;
|
|
206
|
+
reranker;
|
|
207
|
+
constructor(inner, reranker) {
|
|
208
|
+
this.inner = inner;
|
|
209
|
+
this.reranker = reranker;
|
|
210
|
+
}
|
|
211
|
+
async recallFolded(scope, query) {
|
|
212
|
+
const items = await recallFoldedOn(this.inner, scope, query);
|
|
213
|
+
return query.semantic === undefined ? items : this.reranker.rerank(query.semantic, items);
|
|
214
|
+
}
|
|
215
|
+
remember(scope, payload) {
|
|
216
|
+
return this.inner.remember(scope, payload);
|
|
217
|
+
}
|
|
218
|
+
async recall(scope, query) {
|
|
219
|
+
const items = await this.inner.recall(scope, query);
|
|
220
|
+
return query.semantic === undefined ? items : this.reranker.rerank(query.semantic, items);
|
|
221
|
+
}
|
|
222
|
+
improve(scope, feedback) {
|
|
223
|
+
return this.inner.improve(scope, feedback);
|
|
224
|
+
}
|
|
225
|
+
forget(scope, id) {
|
|
226
|
+
return this.inner.forget(scope, id);
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
function required(payload) {
|
|
230
|
+
if (payload === undefined)
|
|
231
|
+
throw new TypeError("memory payload is required");
|
|
232
|
+
return payload;
|
|
233
|
+
}
|
|
234
|
+
//# sourceMappingURL=handle.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../src/memory/handle.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { Laser } from "../client/laser.js";
|
|
2
|
+
import { MemoryId, MemoryKind, type Feedback, type Memory, type MemoryItem, type MemoryQuery, type MemoryScope } from "./types.js";
|
|
3
|
+
export declare class LogMemory implements Memory {
|
|
4
|
+
private readonly laser;
|
|
5
|
+
readonly namespace: string;
|
|
6
|
+
readonly topic: string;
|
|
7
|
+
readonly stream: string | undefined;
|
|
8
|
+
private readonly items;
|
|
9
|
+
private readonly forgotten;
|
|
10
|
+
private readonly named;
|
|
11
|
+
private readonly offsets;
|
|
12
|
+
private sequence;
|
|
13
|
+
constructor(laser: Laser, namespace: string, topic?: string, stream?: string | undefined);
|
|
14
|
+
remember(scope: MemoryScope, payload: Uint8Array): Promise<MemoryId>;
|
|
15
|
+
append(scope: MemoryScope, id: MemoryId, kind: MemoryKind, payload: Uint8Array): Promise<MemoryId>;
|
|
16
|
+
/** Reads the managed key-value view the deployment materializes from the
|
|
17
|
+
* memory topic, so a large topic never folds in process. Folding is the
|
|
18
|
+
* opt-in {@link LogMemory.recallFolded}, never the default, matching Rust and Python. */
|
|
19
|
+
recall(scope: MemoryScope, query: MemoryQuery): Promise<readonly MemoryItem[]>;
|
|
20
|
+
/** Recall by folding the memory topic in process, the opt-in path for a small
|
|
21
|
+
* deployment with no materialized read view. */
|
|
22
|
+
recallFolded(scope: MemoryScope, query: MemoryQuery): Promise<readonly MemoryItem[]>;
|
|
23
|
+
improve(scope: MemoryScope, feedback: Feedback): Promise<MemoryId>;
|
|
24
|
+
forget(scope: MemoryScope, id: MemoryId): Promise<void>;
|
|
25
|
+
set(key: string, payload: Uint8Array): Promise<void>;
|
|
26
|
+
/** Reads named point state from the managed key-value view, like {@link LogMemory.recall}.
|
|
27
|
+
* Folding the topic is the opt-in {@link LogMemory.fetchFolded}. */
|
|
28
|
+
fetch(key: string): Promise<Uint8Array | undefined>;
|
|
29
|
+
fetchFolded(key: string): Promise<Uint8Array | undefined>;
|
|
30
|
+
update(key: string, patch: Uint8Array): Promise<void>;
|
|
31
|
+
remove(key: string): Promise<void>;
|
|
32
|
+
private publish;
|
|
33
|
+
private catchUp;
|
|
34
|
+
private absorb;
|
|
35
|
+
private namedKey;
|
|
36
|
+
private requireStream;
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=log-memory.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"log-memory.d.ts","sourceRoot":"","sources":["../../src/memory/log-memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAW/C,OAAO,EACL,QAAQ,EACR,UAAU,EAEV,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AASnB,qBAAa,SAAU,YAAW,MAAM;IAQpC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAVrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAI;IAEpB,YACmB,KAAK,EAAE,KAAK,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAyB,EAChC,MAAM,GAAE,MAAM,GAAG,SAA+B,EACvD;IAEE,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEzE;IAEK,MAAM,CACV,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,QAAQ,CAAC,CAQnB;IAED;;6FAEyF;IACnF,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAmBnF;IAED;oDACgD;IAC1C,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAczF;IAEK,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQvE;IAEK,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CASzD;IAED;wEACoE;IAC9D,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAExD;IAEK,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAG9D;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1D;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvC;YAEa,OAAO;YAoCP,OAAO;IAqCrB,OAAO,CAAC,MAAM;IAyDd,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;CAMtB"}
|