@relayfx/sdk 0.3.6 → 0.4.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.
Files changed (96) hide show
  1. package/dist/ai.js +1 -1
  2. package/dist/http-server.js +1 -1
  3. package/dist/{index-mtvz1bjn.js → index-3w6txjtg.js} +63 -426
  4. package/dist/{index-2vsf6dks.js → index-cs3be24t.js} +1 -1
  5. package/dist/{index-e02krw55.js → index-p43mg4kt.js} +5882 -5127
  6. package/dist/{index-8fpd6kvj.js → index-x32kbvxv.js} +1004 -970
  7. package/dist/index.js +487 -22
  8. package/dist/migrations/20260719120000_rename_entity_to_resident/migration.sql +9 -0
  9. package/dist/migrations/mysql/0012_rename_entity_to_resident.sql +5 -0
  10. package/dist/migrations/pg/20260719120000_rename_entity_to_resident/migration.sql +9 -0
  11. package/dist/migrations/sqlite/0012_rename_entity_to_resident.sql +7 -0
  12. package/dist/mysql.js +18 -5
  13. package/dist/postgres.js +569 -550
  14. package/dist/sqlite.js +16 -5
  15. package/dist/types/relay/client-baton-agent.d.ts +30 -0
  16. package/dist/types/relay/client-child-runs.d.ts +35 -0
  17. package/dist/types/relay/client-error-mapping.d.ts +5 -0
  18. package/dist/types/relay/client-event-sequence.d.ts +3 -0
  19. package/dist/types/relay/client-execution-payloads.d.ts +12 -0
  20. package/dist/types/relay/client-public-agents.d.ts +15 -0
  21. package/dist/types/relay/client-public-child-runs.d.ts +9 -0
  22. package/dist/types/relay/client-public-envelope-ready.d.ts +6 -0
  23. package/dist/types/relay/client-public-executions.d.ts +247 -0
  24. package/dist/types/relay/client-public-messaging.d.ts +18 -0
  25. package/dist/types/relay/client-public-residents.d.ts +14 -0
  26. package/dist/types/relay/client-public-schedules.d.ts +6 -0
  27. package/dist/types/relay/client-public-tools.d.ts +12 -0
  28. package/dist/types/relay/client-public-workflows.d.ts +10 -0
  29. package/dist/types/relay/client-public.d.ts +133 -313
  30. package/dist/types/relay/client-runtime-wake.d.ts +10 -0
  31. package/dist/types/relay/client-tool-outcome.d.ts +16 -0
  32. package/dist/types/relay/client-view-mappers.d.ts +16 -0
  33. package/dist/types/relay/client-wait-signal.d.ts +5 -0
  34. package/dist/types/relay/client.d.ts +118 -1
  35. package/dist/types/relay/command.d.ts +6 -6
  36. package/dist/types/relay/http-server.d.ts +55 -37
  37. package/dist/types/relay/index.d.ts +3 -4
  38. package/dist/types/relay/internal-client.d.ts +5 -5
  39. package/dist/types/relay/mysql-migrations.d.ts +1 -1
  40. package/dist/types/relay/operation.d.ts +44 -41
  41. package/dist/types/relay/sqlite-migrations.d.ts +6 -1
  42. package/dist/types/runtime/address/address-resolution-service.d.ts +3 -0
  43. package/dist/types/runtime/agent/agent-loop-events.d.ts +24 -0
  44. package/dist/types/runtime/agent/relay-tool-executor.d.ts +2 -2
  45. package/dist/types/runtime/agent/sequence-allocator.d.ts +1 -0
  46. package/dist/types/runtime/execution/event-log-memory.d.ts +7 -0
  47. package/dist/types/runtime/execution/event-log-repository.d.ts +8 -0
  48. package/dist/types/runtime/execution/event-log-service.d.ts +3 -1
  49. package/dist/types/runtime/index.d.ts +2 -2
  50. package/dist/types/runtime/resident/resident-instance-service.d.ts +76 -0
  51. package/dist/types/runtime/resident/resident-registry-service.d.ts +35 -0
  52. package/dist/types/runtime/runner/runner-runtime-service.d.ts +14 -14
  53. package/dist/types/runtime/tool/tool-runtime-contract.d.ts +4 -1
  54. package/dist/types/runtime/workflow/execution-workflow-state.d.ts +43 -0
  55. package/dist/types/runtime/workflow/execution-workflow.d.ts +6 -0
  56. package/dist/types/schema/agent-schema.d.ts +24 -0
  57. package/dist/types/schema/execution-schema.d.ts +5 -2
  58. package/dist/types/schema/ids-schema.d.ts +6 -6
  59. package/dist/types/schema/index.d.ts +1 -1
  60. package/dist/types/schema/{entity-schema.d.ts → resident-schema.d.ts} +6 -6
  61. package/dist/types/store-sql/envelope/envelope-ready-records.d.ts +51 -0
  62. package/dist/types/store-sql/envelope/envelope-records.d.ts +43 -0
  63. package/dist/types/store-sql/envelope/envelope-repository.d.ts +1 -2
  64. package/dist/types/store-sql/envelope/wait-records.d.ts +64 -0
  65. package/dist/types/store-sql/execution/execution-event-repository-memory.d.ts +8 -0
  66. package/dist/types/store-sql/execution/execution-event-repository-sql.d.ts +13 -0
  67. package/dist/types/store-sql/execution/execution-event-repository.d.ts +13 -5
  68. package/dist/types/store-sql/index.d.ts +1 -1
  69. package/dist/types/store-sql/portable.d.ts +1 -1
  70. package/dist/types/store-sql/resident/resident-repository.d.ts +36 -0
  71. package/dist/types/store-sql/schema/address-book-schema.d.ts +131 -0
  72. package/dist/types/store-sql/schema/agent-schema.d.ts +954 -0
  73. package/dist/types/store-sql/schema/communication-schema.d.ts +743 -0
  74. package/dist/types/store-sql/schema/envelope-schema.d.ts +701 -0
  75. package/dist/types/store-sql/schema/execution-schema.d.ts +1119 -0
  76. package/dist/types/store-sql/schema/idempotency-schema.d.ts +161 -0
  77. package/dist/types/store-sql/schema/presence-schema.d.ts +116 -0
  78. package/dist/types/store-sql/schema/relay-schema.d.ts +13 -6684
  79. package/dist/types/store-sql/schema/resident-schema.d.ts +294 -0
  80. package/dist/types/store-sql/schema/schedule-schema.d.ts +282 -0
  81. package/dist/types/store-sql/schema/schema-columns.d.ts +1 -0
  82. package/dist/types/store-sql/schema/session-schema.d.ts +228 -0
  83. package/dist/types/store-sql/schema/tool-schema.d.ts +627 -0
  84. package/dist/types/store-sql/schema/workflow-schema.d.ts +996 -0
  85. package/dist/types/store-sql/schema/workspace-schema.d.ts +338 -0
  86. package/dist/types/store-sql/session/session-entry-records.d.ts +52 -0
  87. package/dist/types/store-sql/session/session-records.d.ts +51 -0
  88. package/dist/types/store-sql/session/session-repository.d.ts +2 -3
  89. package/dist/types/store-sql/tool/tool-attempt-records.d.ts +52 -0
  90. package/dist/types/store-sql/tool/tool-call-records.d.ts +121 -0
  91. package/dist/types/store-sql/tool/tool-call-repository.d.ts +1 -2
  92. package/dist/types/store-sql/tool/tool-work-operations.d.ts +11 -0
  93. package/package.json +3 -3
  94. package/dist/types/runtime/entity/entity-instance-service.d.ts +0 -76
  95. package/dist/types/runtime/entity/entity-registry-service.d.ts +0 -35
  96. package/dist/types/store-sql/entity/entity-repository.d.ts +0 -36
@@ -8,7 +8,7 @@ export interface Config {
8
8
  readonly eventLog: EventLogInterface;
9
9
  readonly allocator: {
10
10
  readonly current: Effect.Effect<Execution.ExecutionEventSequence>;
11
- readonly resetTo: (sequence: Execution.ExecutionEventSequence) => Effect.Effect<void>;
11
+ readonly advanceTo: (sequence: Execution.ExecutionEventSequence) => Effect.Effect<void>;
12
12
  };
13
13
  readonly executionId: Ids.ExecutionId;
14
14
  readonly permissions: ReadonlyArray<Tool.Permission>;
@@ -18,5 +18,5 @@ export interface Config {
18
18
  readonly resumedToolCallId?: Ids.ToolCallId;
19
19
  readonly extraTools?: ReadonlyArray<RegisteredTool>;
20
20
  }
21
- export declare const make: (config: Config) => ToolExecutor.Interface;
21
+ export declare const make: (config: Config) => Effect.Effect<ToolExecutor.Interface>;
22
22
  export declare const layer: (config: Config) => Layer.Layer<ToolExecutor.ToolExecutor>;
@@ -3,6 +3,7 @@ import { Effect } from "effect";
3
3
  export interface SequenceAllocator {
4
4
  readonly allocate: (count: number) => Effect.Effect<Execution.ExecutionEventSequence>;
5
5
  readonly current: Effect.Effect<Execution.ExecutionEventSequence>;
6
+ readonly advanceTo: (sequence: Execution.ExecutionEventSequence) => Effect.Effect<void>;
6
7
  readonly resetTo: (sequence: Execution.ExecutionEventSequence) => Effect.Effect<void>;
7
8
  }
8
9
  export declare const make: (first: Execution.ExecutionEventSequence) => Effect.Effect<SequenceAllocator>;
@@ -0,0 +1,7 @@
1
+ import { Layer } from "effect";
2
+ import type { EventLogCursorNotFound, EventLogError, Service } from "./event-log-service";
3
+ export declare const makeMemoryLayer: (eventLog: {
4
+ readonly EventLogCursorNotFound: typeof EventLogCursorNotFound;
5
+ readonly EventLogError: typeof EventLogError;
6
+ readonly Service: typeof Service;
7
+ }) => Layer.Layer<Service, never, never>;
@@ -0,0 +1,8 @@
1
+ import { ExecutionEventRepository } from "../../store-sql/portable";
2
+ import { Layer } from "effect";
3
+ import type { EventLogCursorNotFound, EventLogError, Service } from "./event-log-service";
4
+ export declare const makeRepositoryLayer: (eventLog: {
5
+ readonly EventLogCursorNotFound: typeof EventLogCursorNotFound;
6
+ readonly EventLogError: typeof EventLogError;
7
+ readonly Service: typeof Service;
8
+ }) => Layer.Layer<Service, never, ExecutionEventRepository.Service>;
@@ -58,6 +58,7 @@ export interface FindFirstByTypeAfterSequenceInput {
58
58
  }
59
59
  export interface Interface {
60
60
  readonly append: (input: Execution.ExecutionEvent) => Effect.Effect<Execution.ExecutionEvent, EventLogError>;
61
+ readonly appendNext: (input: ExecutionEventRepository.AppendNextInput) => Effect.Effect<Execution.ExecutionEvent, EventLogError>;
61
62
  readonly replay: (input: ReplayInput) => Effect.Effect<ReadonlyArray<Execution.ExecutionEvent>, EventLogCursorNotFound | EventLogError>;
62
63
  readonly stream: (input: ReplayInput) => Stream.Stream<Execution.ExecutionEvent, EventLogCursorNotFound | EventLogError>;
63
64
  readonly page: (input: PageInput) => Effect.Effect<PageResult, EventLogCursorNotFound | EventLogError>;
@@ -73,13 +74,14 @@ export declare class Service extends Service_base {
73
74
  }
74
75
  export declare const layerFromRepository: Layer.Layer<Service, never, ExecutionEventRepository.Service>;
75
76
  export declare const memoryLayer: Layer.Layer<Service, never, never>;
76
- type TestImplementation = Omit<Interface, "page"> & Partial<Pick<Interface, "page">>;
77
+ type TestImplementation = Omit<Interface, "appendNext" | "page"> & Partial<Pick<Interface, "appendNext" | "page">>;
77
78
  export declare const testLayer: (implementation: TestImplementation) => Layer.Layer<Service, never, never>;
78
79
  export declare const appendIdempotentTo: {
79
80
  (eventLog: Interface, input: Execution.ExecutionEvent): Effect.Effect<Execution.ExecutionEvent, EventLogError>;
80
81
  (input: Execution.ExecutionEvent): (eventLog: Interface) => Effect.Effect<Execution.ExecutionEvent, EventLogError>;
81
82
  };
82
83
  export declare const append: (input: Execution.ExecutionEvent) => Effect.Effect<Execution.ExecutionEvent, EventLogError, Service>;
84
+ export declare const appendNext: (input: ExecutionEventRepository.AppendNextInput) => Effect.Effect<Execution.ExecutionEvent, EventLogError, Service>;
83
85
  export declare const appendIdempotent: (input: Execution.ExecutionEvent) => Effect.Effect<Execution.ExecutionEvent, EventLogError, Service>;
84
86
  export declare const replay: (input: ReplayInput) => Effect.Effect<readonly Execution.ExecutionEvent[], EventLogCursorNotFound | EventLogError, Service>;
85
87
  export declare const page: (input: PageInput) => Effect.Effect<PageResult, EventLogCursorNotFound | EventLogError, Service>;
@@ -11,8 +11,8 @@ export * as ChildFanOutRuntime from "./child/child-fan-out-runtime";
11
11
  export * as SpawnChildRunTool from "./child/spawn-child-run-tool";
12
12
  export * as ExecutionEntity from "./cluster/execution-entity";
13
13
  export * as EnvelopeService from "./envelope/envelope-service";
14
- export * as EntityInstanceService from "./entity/entity-instance-service";
15
- export * as EntityRegistry from "./entity/entity-registry-service";
14
+ export * as ResidentInstanceService from "./resident/resident-instance-service";
15
+ export * as ResidentRegistry from "./resident/resident-registry-service";
16
16
  export * as InboxService from "./inbox/inbox-service";
17
17
  export * as TopicService from "./topic/topic-service";
18
18
  export * as PublishToTopicTool from "./topic/publish-to-topic-tool";
@@ -0,0 +1,76 @@
1
+ import { Content, Ids, Resident, Shared } from "../../schema/index";
2
+ import { ResidentRepository } from "../../store-sql/portable";
3
+ import { Context, Effect, Layer, Schema } from "effect";
4
+ import { Service as AddressBookService } from "../address/address-book-service";
5
+ import { Service as AgentRegistryService } from "../agent/agent-registry-service";
6
+ import { Service as EventLogService } from "../execution/event-log-service";
7
+ import { ResidentKindInvalid, ResidentKindNotFound, Service as ResidentRegistryService } from "./resident-registry-service";
8
+ declare const ResidentDestroyed_base: Schema.Class<ResidentDestroyed, Schema.TaggedStruct<"ResidentDestroyed", {
9
+ readonly kind: Schema.brand<Schema.String, "Relay.ResidentKindName"> & {
10
+ make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ResidentKindName">;
11
+ };
12
+ readonly key: Schema.brand<Schema.String, "Relay.ResidentKey"> & {
13
+ make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ResidentKey">;
14
+ };
15
+ }>, import("effect/Cause").YieldableError>;
16
+ export declare class ResidentDestroyed extends ResidentDestroyed_base {
17
+ }
18
+ declare const ResidentNotFound_base: Schema.Class<ResidentNotFound, Schema.TaggedStruct<"ResidentNotFound", {
19
+ readonly kind: Schema.brand<Schema.String, "Relay.ResidentKindName"> & {
20
+ make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ResidentKindName">;
21
+ };
22
+ readonly key: Schema.brand<Schema.String, "Relay.ResidentKey"> & {
23
+ make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ResidentKey">;
24
+ };
25
+ }>, import("effect/Cause").YieldableError>;
26
+ export declare class ResidentNotFound extends ResidentNotFound_base {
27
+ }
28
+ declare const ResidentServiceError_base: Schema.Class<ResidentServiceError, Schema.TaggedStruct<"ResidentServiceError", {
29
+ readonly message: Schema.String;
30
+ }>, import("effect/Cause").YieldableError>;
31
+ export declare class ResidentServiceError extends ResidentServiceError_base {
32
+ }
33
+ export interface SpawnInput {
34
+ readonly kind: Ids.ResidentKindName;
35
+ readonly key: Ids.ResidentKey;
36
+ readonly input?: ReadonlyArray<Content.Part>;
37
+ readonly metadata?: Shared.Metadata;
38
+ readonly createdAt: number;
39
+ }
40
+ export interface Interface {
41
+ readonly spawn: (input: SpawnInput) => Effect.Effect<Resident.Instance, ResidentKindNotFound | ResidentKindInvalid | ResidentServiceError>;
42
+ readonly get: (input: {
43
+ readonly kind: Ids.ResidentKindName;
44
+ readonly key: Ids.ResidentKey;
45
+ }) => Effect.Effect<Resident.Instance | undefined, ResidentServiceError>;
46
+ readonly destroy: (input: {
47
+ readonly kind: Ids.ResidentKindName;
48
+ readonly key: Ids.ResidentKey;
49
+ readonly reason?: string;
50
+ readonly destroyedAt: number;
51
+ }) => Effect.Effect<Resident.Instance, ResidentNotFound | ResidentDestroyed | ResidentServiceError>;
52
+ readonly list: (input: {
53
+ readonly kind?: Ids.ResidentKindName;
54
+ readonly afterKind?: Ids.ResidentKindName;
55
+ readonly afterKey?: string;
56
+ readonly limit?: number;
57
+ }) => Effect.Effect<ReadonlyArray<Resident.Instance>, ResidentServiceError>;
58
+ }
59
+ declare const Service_base: Context.ServiceClass<Service, "@relayfx/runtime/resident/resident-instance-service/Service", Interface>;
60
+ export declare class Service extends Service_base {
61
+ }
62
+ export declare const residentExecutionId: {
63
+ (tenant: Ids.TenantId, kind: Ids.ResidentKindName, key: Ids.ResidentKey, generation: number): Ids.ExecutionId;
64
+ (kind: Ids.ResidentKindName, key: Ids.ResidentKey, generation: number): (tenant: Ids.TenantId) => Ids.ExecutionId;
65
+ };
66
+ export declare const residentAddressId: {
67
+ (tenant: Ids.TenantId, kind: Ids.ResidentKindName, key: Ids.ResidentKey): Ids.AddressId;
68
+ (kind: Ids.ResidentKindName, key: Ids.ResidentKey): (tenant: Ids.TenantId) => Ids.AddressId;
69
+ };
70
+ export declare const residentSessionId: {
71
+ (tenant: Ids.TenantId, kind: Ids.ResidentKindName, key: Ids.ResidentKey): Ids.SessionId;
72
+ (kind: Ids.ResidentKindName, key: Ids.ResidentKey): (tenant: Ids.TenantId) => Ids.SessionId;
73
+ };
74
+ export declare const layer: Layer.Layer<Service, never, ResidentRepository.Service | AddressBookService | EventLogService | AgentRegistryService | ResidentRegistryService | import("effect/unstable/cluster/Sharding").Sharding>;
75
+ export declare const testLayer: (implementation: Interface) => Layer.Layer<Service, never, never>;
76
+ export {};
@@ -0,0 +1,35 @@
1
+ import { Ids, Resident } from "../../schema/index";
2
+ import { ResidentRepository } from "../../store-sql/portable";
3
+ import { Context, Effect, Layer, Schema } from "effect";
4
+ import { Service as AgentRegistryService } from "../agent/agent-registry-service";
5
+ declare const ResidentKindNotFound_base: Schema.Class<ResidentKindNotFound, Schema.TaggedStruct<"ResidentKindNotFound", {
6
+ readonly kind: Schema.brand<Schema.String, "Relay.ResidentKindName"> & {
7
+ make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ResidentKindName">;
8
+ };
9
+ }>, import("effect/Cause").YieldableError>;
10
+ export declare class ResidentKindNotFound extends ResidentKindNotFound_base {
11
+ }
12
+ declare const ResidentKindInvalid_base: Schema.Class<ResidentKindInvalid, Schema.TaggedStruct<"ResidentKindInvalid", {
13
+ readonly kind: Schema.brand<Schema.String, "Relay.ResidentKindName"> & {
14
+ make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ResidentKindName">;
15
+ };
16
+ readonly message: Schema.String;
17
+ }>, import("effect/Cause").YieldableError>;
18
+ export declare class ResidentKindInvalid extends ResidentKindInvalid_base {
19
+ }
20
+ declare const ResidentRegistryError_base: Schema.Class<ResidentRegistryError, Schema.TaggedStruct<"ResidentRegistryError", {
21
+ readonly message: Schema.String;
22
+ }>, import("effect/Cause").YieldableError>;
23
+ export declare class ResidentRegistryError extends ResidentRegistryError_base {
24
+ }
25
+ export interface Interface {
26
+ readonly registerKind: (input: Resident.KindDefinition) => Effect.Effect<Resident.KindDefinition, ResidentKindInvalid | ResidentRegistryError>;
27
+ readonly getKind: (kind: Ids.ResidentKindName) => Effect.Effect<Resident.KindDefinition | undefined, ResidentRegistryError>;
28
+ readonly listKinds: Effect.Effect<ReadonlyArray<Resident.KindDefinition>, ResidentRegistryError>;
29
+ }
30
+ declare const Service_base: Context.ServiceClass<Service, "@relayfx/runtime/resident/resident-registry-service/Service", Interface>;
31
+ export declare class Service extends Service_base {
32
+ }
33
+ export declare const layer: Layer.Layer<Service, never, ResidentRepository.Service | AgentRegistryService>;
34
+ export declare const testLayer: (implementation: Interface) => Layer.Layer<Service, never, never>;
35
+ export {};