@theway-ai/sdk 0.1.9

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 (60) hide show
  1. package/README.md +108 -0
  2. package/dist/client.d.ts +180 -0
  3. package/dist/client.d.ts.map +1 -0
  4. package/dist/client.js +531 -0
  5. package/dist/client.js.map +1 -0
  6. package/dist/generated/commands.d.ts +195 -0
  7. package/dist/generated/commands.d.ts.map +1 -0
  8. package/dist/generated/commands.js +633 -0
  9. package/dist/generated/commands.js.map +1 -0
  10. package/dist/generated/events.d.ts +158 -0
  11. package/dist/generated/events.d.ts.map +1 -0
  12. package/dist/generated/events.js +1122 -0
  13. package/dist/generated/events.js.map +1 -0
  14. package/dist/generated/extensions.d.ts +184 -0
  15. package/dist/generated/extensions.d.ts.map +1 -0
  16. package/dist/generated/extensions.js +1309 -0
  17. package/dist/generated/extensions.js.map +1 -0
  18. package/dist/generated/graph_engine.d.ts +422 -0
  19. package/dist/generated/graph_engine.d.ts.map +1 -0
  20. package/dist/generated/graph_engine.js +3048 -0
  21. package/dist/generated/graph_engine.js.map +1 -0
  22. package/dist/generated/health.d.ts +83 -0
  23. package/dist/generated/health.d.ts.map +1 -0
  24. package/dist/generated/health.js +179 -0
  25. package/dist/generated/health.js.map +1 -0
  26. package/dist/generated/session.d.ts +854 -0
  27. package/dist/generated/session.d.ts.map +1 -0
  28. package/dist/generated/session.js +6790 -0
  29. package/dist/generated/session.js.map +1 -0
  30. package/dist/generated/settings.d.ts +182 -0
  31. package/dist/generated/settings.d.ts.map +1 -0
  32. package/dist/generated/settings.js +324 -0
  33. package/dist/generated/settings.js.map +1 -0
  34. package/dist/generated/state.d.ts +304 -0
  35. package/dist/generated/state.d.ts.map +1 -0
  36. package/dist/generated/state.js +1391 -0
  37. package/dist/generated/state.js.map +1 -0
  38. package/dist/generated/tools.d.ts +413 -0
  39. package/dist/generated/tools.d.ts.map +1 -0
  40. package/dist/generated/tools.js +2487 -0
  41. package/dist/generated/tools.js.map +1 -0
  42. package/dist/health.d.ts +20 -0
  43. package/dist/health.d.ts.map +1 -0
  44. package/dist/health.js +62 -0
  45. package/dist/health.js.map +1 -0
  46. package/dist/index.d.ts +15 -0
  47. package/dist/index.d.ts.map +1 -0
  48. package/dist/index.js +21 -0
  49. package/dist/index.js.map +1 -0
  50. package/docs/PROTOCOL.md +129 -0
  51. package/package.json +47 -0
  52. package/proto/commands.proto +70 -0
  53. package/proto/events.proto +87 -0
  54. package/proto/extensions.proto +99 -0
  55. package/proto/graph_engine.proto +236 -0
  56. package/proto/health.proto +26 -0
  57. package/proto/session.proto +498 -0
  58. package/proto/settings.proto +79 -0
  59. package/proto/state.proto +130 -0
  60. package/proto/tools.proto +238 -0
@@ -0,0 +1,158 @@
1
+ import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
2
+ import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientReadableStream, type handleServerStreamingCall, type Metadata, type UntypedServiceImplementation } from "@grpc/grpc-js";
3
+ import { SessionSnapshot } from "./session.js";
4
+ export declare const protobufPackage = "theway.grpc.v1";
5
+ /** Unified envelope for StreamEvents / WebSocket frames. */
6
+ export interface StreamFrame {
7
+ payload?: //
8
+ /** connection start + full resync frames */
9
+ {
10
+ $case: "snapshot";
11
+ snapshot: SessionSnapshot;
12
+ } | //
13
+ /** high-frequency increment */
14
+ {
15
+ $case: "event";
16
+ event: StreamEvent;
17
+ } | undefined;
18
+ }
19
+ export interface StreamEvent {
20
+ sessionId: string;
21
+ kind?: {
22
+ $case: "subagentStarted";
23
+ subagentStarted: SubagentStarted;
24
+ } | {
25
+ $case: "subagentOutput";
26
+ subagentOutput: SubagentOutput;
27
+ } | {
28
+ $case: "subagentMetrics";
29
+ subagentMetrics: SubagentMetrics;
30
+ } | {
31
+ $case: "subagentCompleted";
32
+ subagentCompleted: SubagentCompleted;
33
+ } | {
34
+ $case: "nodeStatus";
35
+ nodeStatus: NodeStatus;
36
+ } | {
37
+ $case: "runStatus";
38
+ runStatus: RunStatus;
39
+ } | undefined;
40
+ }
41
+ export interface SubagentStarted {
42
+ id: string;
43
+ agent: string;
44
+ source: string;
45
+ runId?: string | undefined;
46
+ nodeId?: string | undefined;
47
+ }
48
+ export interface SubagentOutput {
49
+ id: string;
50
+ /** high-frequency, untruncated */
51
+ chunk: string;
52
+ }
53
+ export interface SubagentMetrics {
54
+ id: string;
55
+ tps: number;
56
+ cps: number;
57
+ chars: string;
58
+ tokensIn: string;
59
+ tokensOut: string;
60
+ toolsCalled: string;
61
+ turn: number;
62
+ }
63
+ export interface SubagentCompleted {
64
+ id: string;
65
+ status: string;
66
+ error?: string | undefined;
67
+ durationMs?: string | undefined;
68
+ chars: string;
69
+ tokensIn: string;
70
+ tokensOut: string;
71
+ toolsCalled: string;
72
+ }
73
+ export interface NodeStatus {
74
+ runId: string;
75
+ nodeId: string;
76
+ status: string;
77
+ error?: string | undefined;
78
+ }
79
+ export interface RunStatus {
80
+ runId: string;
81
+ status: string;
82
+ error?: string | undefined;
83
+ }
84
+ export interface StreamEventsRequest {
85
+ /** Omitted = all sessions; set = only events for this session. */
86
+ sessionId?: string | undefined;
87
+ }
88
+ export declare const StreamFrame: MessageFns<StreamFrame>;
89
+ export declare const StreamEvent: MessageFns<StreamEvent>;
90
+ export declare const SubagentStarted: MessageFns<SubagentStarted>;
91
+ export declare const SubagentOutput: MessageFns<SubagentOutput>;
92
+ export declare const SubagentMetrics: MessageFns<SubagentMetrics>;
93
+ export declare const SubagentCompleted: MessageFns<SubagentCompleted>;
94
+ export declare const NodeStatus: MessageFns<NodeStatus>;
95
+ export declare const RunStatus: MessageFns<RunStatus>;
96
+ export declare const StreamEventsRequest: MessageFns<StreamEventsRequest>;
97
+ export type EventServiceService = typeof EventServiceService;
98
+ export declare const EventServiceService: {
99
+ /**
100
+ * Snapshot/event stream (P0: snapshot frames; P2+: event increments).
101
+ * An optional session_id filters the stream to one session.
102
+ */
103
+ readonly streamEvents: {
104
+ readonly path: "/theway.grpc.v1.EventService/StreamEvents";
105
+ readonly requestStream: false;
106
+ readonly responseStream: true;
107
+ readonly requestSerialize: (value: StreamEventsRequest) => Buffer;
108
+ readonly requestDeserialize: (value: Buffer) => StreamEventsRequest;
109
+ readonly responseSerialize: (value: StreamFrame) => Buffer;
110
+ readonly responseDeserialize: (value: Buffer) => StreamFrame;
111
+ };
112
+ };
113
+ export interface EventServiceServer extends UntypedServiceImplementation {
114
+ /**
115
+ * Snapshot/event stream (P0: snapshot frames; P2+: event increments).
116
+ * An optional session_id filters the stream to one session.
117
+ */
118
+ streamEvents: handleServerStreamingCall<StreamEventsRequest, StreamFrame>;
119
+ }
120
+ export interface EventServiceClient extends Client {
121
+ /**
122
+ * Snapshot/event stream (P0: snapshot frames; P2+: event increments).
123
+ * An optional session_id filters the stream to one session.
124
+ */
125
+ streamEvents(request: StreamEventsRequest, options?: Partial<CallOptions>): ClientReadableStream<StreamFrame>;
126
+ streamEvents(request: StreamEventsRequest, metadata?: Metadata, options?: Partial<CallOptions>): ClientReadableStream<StreamFrame>;
127
+ }
128
+ export declare const EventServiceClient: {
129
+ new (address: string, credentials: ChannelCredentials, options?: Partial<ClientOptions>): EventServiceClient;
130
+ service: typeof EventServiceService;
131
+ serviceName: string;
132
+ };
133
+ type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
134
+ export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
135
+ $case: string;
136
+ } ? {
137
+ [K in keyof Omit<T, "$case">]?: DeepPartial<T[K]>;
138
+ } & {
139
+ $case: T["$case"];
140
+ } : T extends {} ? {
141
+ [K in keyof T]?: DeepPartial<T[K]>;
142
+ } : Partial<T>;
143
+ type KeysOfUnion<T> = T extends T ? keyof T : never;
144
+ export type Exact<P, I extends P> = P extends Builtin ? P : P & {
145
+ [K in keyof P]: Exact<P[K], I[K]>;
146
+ } & {
147
+ [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
148
+ };
149
+ export interface MessageFns<T> {
150
+ encode(message: T, writer?: BinaryWriter): BinaryWriter;
151
+ decode(input: BinaryReader | Uint8Array, length?: number): T;
152
+ fromJSON(object: any): T;
153
+ toJSON(message: T): unknown;
154
+ create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
155
+ fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
156
+ }
157
+ export {};
158
+ //# sourceMappingURL=events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/generated/events.ts"],"names":[],"mappings":"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"}