@tarkahq/sdk 0.0.0-stage → 0.3.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 (130) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +69 -0
  3. package/README.md +700 -2
  4. package/api-source.json +38 -0
  5. package/dist/cjs/client.d.ts +114 -0
  6. package/dist/cjs/client.js +174 -0
  7. package/dist/cjs/errors.d.ts +27 -0
  8. package/dist/cjs/errors.js +78 -0
  9. package/dist/cjs/generated/google/api/annotations.d.ts +1 -0
  10. package/dist/cjs/generated/google/api/annotations.js +10 -0
  11. package/dist/cjs/generated/google/api/http.d.ts +395 -0
  12. package/dist/cjs/generated/google/api/http.js +421 -0
  13. package/dist/cjs/generated/google/protobuf/descriptor.d.ts +873 -0
  14. package/dist/cjs/generated/google/protobuf/descriptor.js +3992 -0
  15. package/dist/cjs/generated/google/protobuf/empty.d.ts +35 -0
  16. package/dist/cjs/generated/google/protobuf/empty.js +58 -0
  17. package/dist/cjs/generated/google/protobuf/struct.d.ts +127 -0
  18. package/dist/cjs/generated/google/protobuf/struct.js +529 -0
  19. package/dist/cjs/generated/google/protobuf/timestamp.d.ts +128 -0
  20. package/dist/cjs/generated/google/protobuf/timestamp.js +95 -0
  21. package/dist/cjs/generated/protoc-gen-openapiv2/options/annotations.d.ts +1 -0
  22. package/dist/cjs/generated/protoc-gen-openapiv2/options/annotations.js +10 -0
  23. package/dist/cjs/generated/protoc-gen-openapiv2/options/openapiv2.d.ts +983 -0
  24. package/dist/cjs/generated/protoc-gen-openapiv2/options/openapiv2.js +4874 -0
  25. package/dist/cjs/generated/tarka/access/v1/access.d.ts +322 -0
  26. package/dist/cjs/generated/tarka/access/v1/access.js +2979 -0
  27. package/dist/cjs/generated/tarka/channels/v1/channels.d.ts +370 -0
  28. package/dist/cjs/generated/tarka/channels/v1/channels.js +3603 -0
  29. package/dist/cjs/generated/tarka/gateway/v1/gateway.d.ts +804 -0
  30. package/dist/cjs/generated/tarka/gateway/v1/gateway.js +8081 -0
  31. package/dist/cjs/generated/tarka/iam/v1/iam.d.ts +1291 -0
  32. package/dist/cjs/generated/tarka/iam/v1/iam.js +13207 -0
  33. package/dist/cjs/generated/tarka/inference/v1/inference.d.ts +699 -0
  34. package/dist/cjs/generated/tarka/inference/v1/inference.js +7058 -0
  35. package/dist/cjs/generated/tarka/provisioning/v1/agent_secrets.d.ts +70 -0
  36. package/dist/cjs/generated/tarka/provisioning/v1/agent_secrets.js +603 -0
  37. package/dist/cjs/generated/tarka/provisioning/v1/billing_quote.d.ts +171 -0
  38. package/dist/cjs/generated/tarka/provisioning/v1/billing_quote.js +1588 -0
  39. package/dist/cjs/generated/tarka/provisioning/v1/job.d.ts +168 -0
  40. package/dist/cjs/generated/tarka/provisioning/v1/job.js +1505 -0
  41. package/dist/cjs/generated/tarka/provisioning/v1/provisioning.d.ts +2644 -0
  42. package/dist/cjs/generated/tarka/provisioning/v1/provisioning.js +19501 -0
  43. package/dist/cjs/generated/tarka/provisioning/v1/registry_credentials.d.ts +89 -0
  44. package/dist/cjs/generated/tarka/provisioning/v1/registry_credentials.js +856 -0
  45. package/dist/cjs/generated/tarka/provisioning/v1/sandbox.d.ts +431 -0
  46. package/dist/cjs/generated/tarka/provisioning/v1/sandbox.js +3203 -0
  47. package/dist/cjs/generated/tarka/provisioning/v1/source_builds.d.ts +291 -0
  48. package/dist/cjs/generated/tarka/provisioning/v1/source_builds.js +3920 -0
  49. package/dist/cjs/grpc.d.ts +12 -0
  50. package/dist/cjs/grpc.js +55 -0
  51. package/dist/cjs/index.d.ts +6 -0
  52. package/dist/cjs/index.js +21 -0
  53. package/dist/cjs/package.json +1 -0
  54. package/dist/cjs/resources/inference.d.ts +293 -0
  55. package/dist/cjs/resources/inference.js +451 -0
  56. package/dist/cjs/resources/provisioning.d.ts +389 -0
  57. package/dist/cjs/resources/provisioning.js +552 -0
  58. package/dist/cjs/resources/sandboxes.d.ts +360 -0
  59. package/dist/cjs/resources/sandboxes.js +732 -0
  60. package/dist/cjs/rpc-types.d.ts +36 -0
  61. package/dist/cjs/rpc-types.js +29 -0
  62. package/dist/cjs/runtime.d.ts +99 -0
  63. package/dist/cjs/runtime.js +473 -0
  64. package/dist/cjs/transport.d.ts +60 -0
  65. package/dist/cjs/transport.js +114 -0
  66. package/dist/cjs/types.d.ts +309 -0
  67. package/dist/cjs/types.js +2 -0
  68. package/dist/esm/client.d.ts +114 -0
  69. package/dist/esm/client.js +169 -0
  70. package/dist/esm/errors.d.ts +27 -0
  71. package/dist/esm/errors.js +71 -0
  72. package/dist/esm/generated/google/api/annotations.d.ts +1 -0
  73. package/dist/esm/generated/google/api/annotations.js +7 -0
  74. package/dist/esm/generated/google/api/http.d.ts +395 -0
  75. package/dist/esm/generated/google/api/http.js +418 -0
  76. package/dist/esm/generated/google/protobuf/descriptor.d.ts +873 -0
  77. package/dist/esm/generated/google/protobuf/descriptor.js +3977 -0
  78. package/dist/esm/generated/google/protobuf/empty.d.ts +35 -0
  79. package/dist/esm/generated/google/protobuf/empty.js +55 -0
  80. package/dist/esm/generated/google/protobuf/struct.d.ts +127 -0
  81. package/dist/esm/generated/google/protobuf/struct.js +524 -0
  82. package/dist/esm/generated/google/protobuf/timestamp.d.ts +128 -0
  83. package/dist/esm/generated/google/protobuf/timestamp.js +92 -0
  84. package/dist/esm/generated/protoc-gen-openapiv2/options/annotations.d.ts +1 -0
  85. package/dist/esm/generated/protoc-gen-openapiv2/options/annotations.js +7 -0
  86. package/dist/esm/generated/protoc-gen-openapiv2/options/openapiv2.d.ts +983 -0
  87. package/dist/esm/generated/protoc-gen-openapiv2/options/openapiv2.js +4859 -0
  88. package/dist/esm/generated/tarka/access/v1/access.d.ts +322 -0
  89. package/dist/esm/generated/tarka/access/v1/access.js +2976 -0
  90. package/dist/esm/generated/tarka/channels/v1/channels.d.ts +370 -0
  91. package/dist/esm/generated/tarka/channels/v1/channels.js +3600 -0
  92. package/dist/esm/generated/tarka/gateway/v1/gateway.d.ts +804 -0
  93. package/dist/esm/generated/tarka/gateway/v1/gateway.js +8077 -0
  94. package/dist/esm/generated/tarka/iam/v1/iam.d.ts +1291 -0
  95. package/dist/esm/generated/tarka/iam/v1/iam.js +13203 -0
  96. package/dist/esm/generated/tarka/inference/v1/inference.d.ts +699 -0
  97. package/dist/esm/generated/tarka/inference/v1/inference.js +7055 -0
  98. package/dist/esm/generated/tarka/provisioning/v1/agent_secrets.d.ts +70 -0
  99. package/dist/esm/generated/tarka/provisioning/v1/agent_secrets.js +600 -0
  100. package/dist/esm/generated/tarka/provisioning/v1/billing_quote.d.ts +171 -0
  101. package/dist/esm/generated/tarka/provisioning/v1/billing_quote.js +1585 -0
  102. package/dist/esm/generated/tarka/provisioning/v1/job.d.ts +168 -0
  103. package/dist/esm/generated/tarka/provisioning/v1/job.js +1500 -0
  104. package/dist/esm/generated/tarka/provisioning/v1/provisioning.d.ts +2644 -0
  105. package/dist/esm/generated/tarka/provisioning/v1/provisioning.js +19496 -0
  106. package/dist/esm/generated/tarka/provisioning/v1/registry_credentials.d.ts +89 -0
  107. package/dist/esm/generated/tarka/provisioning/v1/registry_credentials.js +853 -0
  108. package/dist/esm/generated/tarka/provisioning/v1/sandbox.d.ts +431 -0
  109. package/dist/esm/generated/tarka/provisioning/v1/sandbox.js +3192 -0
  110. package/dist/esm/generated/tarka/provisioning/v1/source_builds.d.ts +291 -0
  111. package/dist/esm/generated/tarka/provisioning/v1/source_builds.js +3917 -0
  112. package/dist/esm/grpc.d.ts +12 -0
  113. package/dist/esm/grpc.js +11 -0
  114. package/dist/esm/index.d.ts +6 -0
  115. package/dist/esm/index.js +4 -0
  116. package/dist/esm/resources/inference.d.ts +293 -0
  117. package/dist/esm/resources/inference.js +437 -0
  118. package/dist/esm/resources/provisioning.d.ts +389 -0
  119. package/dist/esm/resources/provisioning.js +531 -0
  120. package/dist/esm/resources/sandboxes.d.ts +360 -0
  121. package/dist/esm/resources/sandboxes.js +718 -0
  122. package/dist/esm/rpc-types.d.ts +36 -0
  123. package/dist/esm/rpc-types.js +26 -0
  124. package/dist/esm/runtime.d.ts +99 -0
  125. package/dist/esm/runtime.js +466 -0
  126. package/dist/esm/transport.d.ts +60 -0
  127. package/dist/esm/transport.js +110 -0
  128. package/dist/esm/types.d.ts +309 -0
  129. package/dist/esm/types.js +1 -0
  130. package/package.json +155 -4
@@ -0,0 +1,322 @@
1
+ import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
2
+ import { Empty } from "../../../google/protobuf/empty.js";
3
+ import { Permission } from "../../iam/v1/iam.js";
4
+ export declare const protobufPackage = "tarka.access.v1";
5
+ /**
6
+ * Copyright 2026 Tarka
7
+ * SPDX-License-Identifier: Apache-2.0
8
+ */
9
+ export interface Application {
10
+ id: string;
11
+ orgId: string;
12
+ realmId: string;
13
+ /** active, suspended, revoked, or provisioning; validated by resource kind. */
14
+ status: string;
15
+ /** Optimistic concurrency version, managed by the server. */
16
+ version: bigint;
17
+ createdAt: Date | undefined;
18
+ updatedAt: Date | undefined;
19
+ name: string;
20
+ hostname: string;
21
+ agentHostId: string;
22
+ /** hermes, openclaw, or http. */
23
+ adapter: string;
24
+ operatorIds: string[];
25
+ /**
26
+ * Output only. pending until the controller has observed the protected
27
+ * ingress and private origin at the current Agent Host revision; protected
28
+ * indicates routing enforcement, independently of user permission.
29
+ */
30
+ protectionState: string;
31
+ /**
32
+ * Optional for Hermes/OpenClaw. Disabled or absent provisions no personal
33
+ * compute and never falls back to the host's shared native UI.
34
+ */
35
+ workspace: WorkspacePolicy | undefined;
36
+ }
37
+ export interface WorkspacePolicy {
38
+ /**
39
+ * Enables private, separately billed workspaces on the first authorized
40
+ * visit. Disabling access stops execution without deleting stored files.
41
+ */
42
+ enabled: boolean;
43
+ /** Same-realm agent principal used for explicit customer delegation. */
44
+ agentId: string;
45
+ /** Same-realm published API/MCP gateway. No arbitrary upstream URL. */
46
+ gatewayId: string;
47
+ /**
48
+ * api or mcp. A run receives only the current intersection of these
49
+ * published permissions, customer consent, user roles and agent roles.
50
+ */
51
+ transport: string;
52
+ permissions: Permission[];
53
+ /**
54
+ * Maximum retained, nondeleted workspaces for this application, 1..25.
55
+ * Organization admission, credit and physical capacity limits also apply.
56
+ */
57
+ maxWorkspaces: number;
58
+ /**
59
+ * Seconds without an authorized interactive session before compute stops,
60
+ * 300..3600. Persistent storage is retained until explicit deletion.
61
+ */
62
+ idleTimeoutSeconds: number;
63
+ }
64
+ /**
65
+ * An isolated customer workspace; never contains native credentials, private
66
+ * origins, conversation contents, files or delegated bearer tokens.
67
+ */
68
+ export interface Workspace {
69
+ id: string;
70
+ orgId: string;
71
+ realmId: string;
72
+ applicationId: string;
73
+ subjectId: string;
74
+ agentId: string;
75
+ agentHostId: string;
76
+ /** provisioning, ready, suspended, failed, deleting, or deleted. */
77
+ status: string;
78
+ version: bigint;
79
+ createdAt: Date | undefined;
80
+ updatedAt: Date | undefined;
81
+ lastActiveAt: Date | undefined;
82
+ /** Stable, non-sensitive status code for admission or runtime failures. */
83
+ statusReason: string;
84
+ }
85
+ export interface ListWorkspacesRequest {
86
+ orgId: string;
87
+ realmId: string;
88
+ applicationId: string;
89
+ pageSize: number;
90
+ pageToken: string;
91
+ }
92
+ export interface ListWorkspacesResponse {
93
+ items: Workspace[];
94
+ nextPageToken: string;
95
+ }
96
+ export interface GetWorkspaceRequest {
97
+ orgId: string;
98
+ realmId: string;
99
+ applicationId: string;
100
+ id: string;
101
+ }
102
+ export interface PauseWorkspaceRequest {
103
+ orgId: string;
104
+ realmId: string;
105
+ applicationId: string;
106
+ id: string;
107
+ expectedVersion: bigint;
108
+ }
109
+ export interface ResumeWorkspaceRequest {
110
+ orgId: string;
111
+ realmId: string;
112
+ applicationId: string;
113
+ id: string;
114
+ expectedVersion: bigint;
115
+ }
116
+ export interface DeleteWorkspaceRequest {
117
+ orgId: string;
118
+ realmId: string;
119
+ applicationId: string;
120
+ id: string;
121
+ expectedVersion: bigint;
122
+ }
123
+ export interface CreateApplicationRequest {
124
+ orgId: string;
125
+ realmId: string;
126
+ application: Application | undefined;
127
+ }
128
+ export interface UpdateApplicationRequest {
129
+ orgId: string;
130
+ realmId: string;
131
+ id: string;
132
+ application: Application | undefined;
133
+ expectedVersion: bigint;
134
+ }
135
+ export interface GetApplicationRequest {
136
+ orgId: string;
137
+ realmId: string;
138
+ id: string;
139
+ }
140
+ export interface DeleteApplicationRequest {
141
+ orgId: string;
142
+ realmId: string;
143
+ id: string;
144
+ expectedVersion: bigint;
145
+ }
146
+ export interface ListApplicationsRequest {
147
+ orgId: string;
148
+ realmId: string;
149
+ pageSize: number;
150
+ pageToken: string;
151
+ }
152
+ export interface ListApplicationsResponse {
153
+ items: Application[];
154
+ nextPageToken: string;
155
+ }
156
+ export declare const Application: MessageFns<Application>;
157
+ export declare const WorkspacePolicy: MessageFns<WorkspacePolicy>;
158
+ export declare const Workspace: MessageFns<Workspace>;
159
+ export declare const ListWorkspacesRequest: MessageFns<ListWorkspacesRequest>;
160
+ export declare const ListWorkspacesResponse: MessageFns<ListWorkspacesResponse>;
161
+ export declare const GetWorkspaceRequest: MessageFns<GetWorkspaceRequest>;
162
+ export declare const PauseWorkspaceRequest: MessageFns<PauseWorkspaceRequest>;
163
+ export declare const ResumeWorkspaceRequest: MessageFns<ResumeWorkspaceRequest>;
164
+ export declare const DeleteWorkspaceRequest: MessageFns<DeleteWorkspaceRequest>;
165
+ export declare const CreateApplicationRequest: MessageFns<CreateApplicationRequest>;
166
+ export declare const UpdateApplicationRequest: MessageFns<UpdateApplicationRequest>;
167
+ export declare const GetApplicationRequest: MessageFns<GetApplicationRequest>;
168
+ export declare const DeleteApplicationRequest: MessageFns<DeleteApplicationRequest>;
169
+ export declare const ListApplicationsRequest: MessageFns<ListApplicationsRequest>;
170
+ export declare const ListApplicationsResponse: MessageFns<ListApplicationsResponse>;
171
+ export type AccessServiceDefinition = typeof AccessServiceDefinition;
172
+ export declare const AccessServiceDefinition: {
173
+ readonly name: "AccessService";
174
+ readonly fullName: "tarka.access.v1.AccessService";
175
+ readonly methods: {
176
+ readonly createApplication: {
177
+ readonly name: "CreateApplication";
178
+ readonly requestType: typeof CreateApplicationRequest;
179
+ readonly requestStream: false;
180
+ readonly responseType: typeof Application;
181
+ readonly responseStream: false;
182
+ readonly options: {
183
+ readonly _unknownFields: {
184
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
185
+ };
186
+ };
187
+ };
188
+ readonly updateApplication: {
189
+ readonly name: "UpdateApplication";
190
+ readonly requestType: typeof UpdateApplicationRequest;
191
+ readonly requestStream: false;
192
+ readonly responseType: typeof Application;
193
+ readonly responseStream: false;
194
+ readonly options: {
195
+ readonly _unknownFields: {
196
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
197
+ };
198
+ };
199
+ };
200
+ readonly getApplication: {
201
+ readonly name: "GetApplication";
202
+ readonly requestType: typeof GetApplicationRequest;
203
+ readonly requestStream: false;
204
+ readonly responseType: typeof Application;
205
+ readonly responseStream: false;
206
+ readonly options: {
207
+ readonly _unknownFields: {
208
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
209
+ };
210
+ };
211
+ };
212
+ readonly deleteApplication: {
213
+ readonly name: "DeleteApplication";
214
+ readonly requestType: typeof DeleteApplicationRequest;
215
+ readonly requestStream: false;
216
+ readonly responseType: typeof Empty;
217
+ readonly responseStream: false;
218
+ readonly options: {
219
+ readonly _unknownFields: {
220
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
221
+ };
222
+ };
223
+ };
224
+ readonly listApplications: {
225
+ readonly name: "ListApplications";
226
+ readonly requestType: typeof ListApplicationsRequest;
227
+ readonly requestStream: false;
228
+ readonly responseType: typeof ListApplicationsResponse;
229
+ readonly responseStream: false;
230
+ readonly options: {
231
+ readonly _unknownFields: {
232
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
233
+ };
234
+ };
235
+ };
236
+ readonly listWorkspaces: {
237
+ readonly name: "ListWorkspaces";
238
+ readonly requestType: typeof ListWorkspacesRequest;
239
+ readonly requestStream: false;
240
+ readonly responseType: typeof ListWorkspacesResponse;
241
+ readonly responseStream: false;
242
+ readonly options: {
243
+ readonly _unknownFields: {
244
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
245
+ };
246
+ };
247
+ };
248
+ readonly getWorkspace: {
249
+ readonly name: "GetWorkspace";
250
+ readonly requestType: typeof GetWorkspaceRequest;
251
+ readonly requestStream: false;
252
+ readonly responseType: typeof Workspace;
253
+ readonly responseStream: false;
254
+ readonly options: {
255
+ readonly _unknownFields: {
256
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
257
+ };
258
+ };
259
+ };
260
+ /** Stops compute and withdraws active delegation; retained files are unchanged. */
261
+ readonly pauseWorkspace: {
262
+ readonly name: "PauseWorkspace";
263
+ readonly requestType: typeof PauseWorkspaceRequest;
264
+ readonly requestStream: false;
265
+ readonly responseType: typeof Workspace;
266
+ readonly responseStream: false;
267
+ readonly options: {
268
+ readonly _unknownFields: {
269
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
270
+ };
271
+ };
272
+ };
273
+ /**
274
+ * Rechecks billing and capacity. Resuming cannot create customer consent or
275
+ * start an agent turn; those still require a live authorized customer session.
276
+ */
277
+ readonly resumeWorkspace: {
278
+ readonly name: "ResumeWorkspace";
279
+ readonly requestType: typeof ResumeWorkspaceRequest;
280
+ readonly requestStream: false;
281
+ readonly responseType: typeof Workspace;
282
+ readonly responseStream: false;
283
+ readonly options: {
284
+ readonly _unknownFields: {
285
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
286
+ };
287
+ };
288
+ };
289
+ /** Permanently removes the workspace and its retained storage asynchronously. */
290
+ readonly deleteWorkspace: {
291
+ readonly name: "DeleteWorkspace";
292
+ readonly requestType: typeof DeleteWorkspaceRequest;
293
+ readonly requestStream: false;
294
+ readonly responseType: typeof Empty;
295
+ readonly responseStream: false;
296
+ readonly options: {
297
+ readonly _unknownFields: {
298
+ readonly 578365826: readonly [Buffer<ArrayBufferLike>];
299
+ };
300
+ };
301
+ };
302
+ };
303
+ };
304
+ type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
305
+ export type DeepPartial<T> = T extends bigint ? string | number | bigint : T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
306
+ $case: string;
307
+ value: unknown;
308
+ } ? {
309
+ $case: T["$case"];
310
+ value?: DeepPartial<T["value"]>;
311
+ } : T extends {} ? {
312
+ [K in keyof T]?: DeepPartial<T[K]>;
313
+ } : Partial<T>;
314
+ export interface MessageFns<T> {
315
+ encode(message: T, writer?: BinaryWriter): BinaryWriter;
316
+ decode(input: BinaryReader | Uint8Array, length?: number): T;
317
+ fromJSON(object: any): T;
318
+ toJSON(message: T): unknown;
319
+ create(base?: DeepPartial<T>): T;
320
+ fromPartial(object: DeepPartial<T>): T;
321
+ }
322
+ export {};