@miosa/sdk 3.0.0 → 3.0.1

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/dist/index.d.ts CHANGED
@@ -443,9 +443,6 @@ type RunTargetKind = "sandbox" | "computer";
443
443
  type RunStatus = "running" | "succeeded" | "failed" | "canceled";
444
444
  interface Run {
445
445
  id: string;
446
- agent_definition_id?: string | null;
447
- agent_version_id?: string | null;
448
- configuration_receipt?: Record<string, unknown> | null;
449
446
  run_group_id?: string;
450
447
  parent_run_id?: string;
451
448
  orchestration_role?: string;
@@ -606,9 +603,6 @@ interface RunCreateParams {
606
603
  env?: Record<string, string>;
607
604
  agentRuntimeProfileId?: string;
608
605
  agentProfileId?: string;
609
- agentDefinitionId?: string;
610
- agentVersionId?: string;
611
- configurationReceipt?: Record<string, unknown>;
612
606
  runGroupId?: string;
613
607
  parentRunId?: string;
614
608
  orchestrationRole?: string;
@@ -856,62 +850,6 @@ declare class AgentRuntimeProfiles {
856
850
  delete(id: string): Promise<void>;
857
851
  }
858
852
 
859
- interface AgentVersionData {
860
- id: string;
861
- agent_definition_id: string;
862
- version: number;
863
- fingerprint: string;
864
- configuration: Record<string, unknown>;
865
- published_by_user_id?: string | null;
866
- published_at: string;
867
- }
868
- interface AgentDefinitionData {
869
- id: string;
870
- tenant_id: string;
871
- workspace_id: string;
872
- project_id?: string | null;
873
- name: string;
874
- description?: string | null;
875
- status: "active" | "archived" | string;
876
- metadata: Record<string, unknown>;
877
- latest_version: AgentVersionData;
878
- versions?: AgentVersionData[];
879
- created_at: string;
880
- updated_at: string;
881
- }
882
- interface AgentDefinitionListParams {
883
- workspaceId?: string;
884
- workspace_id?: string;
885
- projectId?: string;
886
- project_id?: string;
887
- status?: "active" | "archived" | "all" | string;
888
- }
889
- interface AgentDefinitionCreateParams {
890
- workspaceId?: string;
891
- workspace_id?: string;
892
- projectId?: string;
893
- project_id?: string;
894
- name: string;
895
- description?: string;
896
- metadata?: Record<string, unknown>;
897
- configuration: Record<string, unknown>;
898
- }
899
- interface AgentDefinitionUpdateParams {
900
- name?: string;
901
- description?: string;
902
- metadata?: Record<string, unknown>;
903
- }
904
- declare class AgentDefinitions {
905
- private readonly http;
906
- constructor(http: HttpClient);
907
- list(params?: AgentDefinitionListParams): Promise<AgentDefinitionData[]>;
908
- get(id: string): Promise<AgentDefinitionData>;
909
- create(params: AgentDefinitionCreateParams): Promise<AgentDefinitionData>;
910
- update(id: string, params: AgentDefinitionUpdateParams): Promise<AgentDefinitionData>;
911
- publish(id: string, configuration: Record<string, unknown>): Promise<AgentVersionData>;
912
- archive(id: string): Promise<void>;
913
- }
914
-
915
853
  /**
916
854
  * Analytics — overview + timeseries (admin scope).
917
855
  */
@@ -985,195 +923,6 @@ declare class ApiKeys {
985
923
  delete(keyId: string): Promise<void>;
986
924
  }
987
925
 
988
- type AppJson = null | boolean | number | string | AppJson[] | {
989
- [key: string]: AppJson;
990
- };
991
- interface AppDocument {
992
- id: string;
993
- name: string;
994
- format: "miosa-app/v1";
995
- metadata?: Record<string, AppJson>;
996
- view: {
997
- kind: "generated";
998
- source: string;
999
- artifact?: {
1000
- entrypoint: string;
1001
- files: Record<string, string>;
1002
- };
1003
- } | {
1004
- kind: "served";
1005
- deploymentId: string;
1006
- releaseId: string;
1007
- };
1008
- capabilities: string[];
1009
- collections: string[];
1010
- connectors: string[];
1011
- automations: Array<{
1012
- id: string;
1013
- trigger: {
1014
- kind: "schedule";
1015
- cron: string;
1016
- } | {
1017
- kind: "event";
1018
- event: string;
1019
- };
1020
- steps: Array<{
1021
- capability: string;
1022
- input: AppJson;
1023
- }>;
1024
- }>;
1025
- pins: Array<{
1026
- slot: string;
1027
- component: string;
1028
- baseHash: string;
1029
- source: string;
1030
- editIntents: AppJson[];
1031
- }>;
1032
- bindings?: Array<{
1033
- id: string;
1034
- capability: string;
1035
- samples: AppJson[];
1036
- path: string[];
1037
- }>;
1038
- }
1039
- interface AppReleaseApproval {
1040
- id: string;
1041
- app_document_id: string;
1042
- version_hash: string;
1043
- approved_by_user_id: string | null;
1044
- reason: string | null;
1045
- compiled_requirements: Record<string, AppJson>;
1046
- deployment_id: string | null;
1047
- deployment_version_id: string | null;
1048
- release_id: string | null;
1049
- artifact_sha256: string | null;
1050
- source_snapshot_sha256: string | null;
1051
- approved_at: string;
1052
- revoked_at: string | null;
1053
- revoked_by_user_id: string | null;
1054
- }
1055
- interface AppReleaseCandidate {
1056
- deployment_id: string;
1057
- deployment_version_id: string;
1058
- release_id: string;
1059
- artifact_sha256: string;
1060
- source_snapshot_sha256: string;
1061
- }
1062
- interface AppDocumentDiagnostics {
1063
- ok: boolean;
1064
- issues: Array<Record<string, AppJson>>;
1065
- manifest: Record<string, AppJson> | null;
1066
- }
1067
- interface AppCollectionRecord<T extends Record<string, AppJson> = Record<string, AppJson>> {
1068
- key: string;
1069
- collection: string;
1070
- value: T;
1071
- version: number;
1072
- inserted_at: string;
1073
- updated_at: string;
1074
- }
1075
- interface AppPublication {
1076
- deployment_id: string;
1077
- release_id: string;
1078
- version_hash: string;
1079
- published_at: string;
1080
- }
1081
- interface AppActionDecision {
1082
- decision: "allow" | "pending_approval" | "deny";
1083
- receipt_id?: string;
1084
- approval_request_id?: string;
1085
- reason?: string;
1086
- capability?: Record<string, AppJson>;
1087
- }
1088
- interface AppRuntimeToken {
1089
- token: string;
1090
- release_id: string;
1091
- expires_in: number;
1092
- }
1093
- interface AppBindingResolution {
1094
- binding_id: string;
1095
- receipt_id: string;
1096
- capability_fingerprint: string;
1097
- value: AppJson;
1098
- }
1099
- interface AppAutomationRun {
1100
- id: string;
1101
- app_document_id: string;
1102
- release_id: string;
1103
- automation_id: string;
1104
- trigger: Record<string, AppJson>;
1105
- cursor: number;
1106
- status: "running" | "executing" | "waiting_approval" | "completed" | "failed" | "stopped";
1107
- current_step: Record<string, AppJson> | null;
1108
- claim: {
1109
- receipt_id: string;
1110
- idempotency_key: string;
1111
- cursor: number;
1112
- } | null;
1113
- pending_approval_request_id: string | null;
1114
- history: Array<Record<string, AppJson>>;
1115
- last_error: Record<string, AppJson> | null;
1116
- inserted_at: string;
1117
- updated_at: string;
1118
- }
1119
- interface AppDocumentRecord {
1120
- id: string;
1121
- tenant_id: string;
1122
- workspace_id: string;
1123
- created_by_user_id: string | null;
1124
- name: string;
1125
- document: AppDocument;
1126
- version_hash: string;
1127
- state: "draft" | "published" | "archived";
1128
- version_approved: boolean;
1129
- approval: AppReleaseApproval | null;
1130
- publication: AppPublication | null;
1131
- inserted_at: string;
1132
- updated_at: string;
1133
- }
1134
- interface AppDocumentCreateParams {
1135
- workspaceId: string;
1136
- name: string;
1137
- document: AppDocument;
1138
- }
1139
- interface AppDocumentUpdateParams {
1140
- name?: string;
1141
- document?: AppDocument;
1142
- }
1143
- declare class AppDocuments {
1144
- private readonly http;
1145
- constructor(http: HttpClient);
1146
- list(workspaceId: string): Promise<AppDocumentRecord[]>;
1147
- get(id: string): Promise<AppDocumentRecord>;
1148
- create(params: AppDocumentCreateParams): Promise<AppDocumentRecord>;
1149
- update(id: string, params: AppDocumentUpdateParams): Promise<AppDocumentRecord>;
1150
- archive(id: string): Promise<void>;
1151
- diagnostics(id: string): Promise<AppDocumentDiagnostics>;
1152
- stageCandidate(id: string): Promise<AppReleaseCandidate>;
1153
- approveExactVersion(id: string, releaseId: string, reason?: string): Promise<AppReleaseApproval>;
1154
- publishExactRelease(id: string): Promise<AppDocumentRecord>;
1155
- listData<T extends Record<string, AppJson> = Record<string, AppJson>>(id: string, collection: string): Promise<AppCollectionRecord<T>[]>;
1156
- getData<T extends Record<string, AppJson> = Record<string, AppJson>>(id: string, collection: string, key: string): Promise<AppCollectionRecord<T>>;
1157
- putData<T extends Record<string, AppJson>>(id: string, collection: string, key: string, value: T, expectedVersion?: number): Promise<AppCollectionRecord<T>>;
1158
- deleteData(id: string, collection: string, key: string, expectedVersion?: number): Promise<void>;
1159
- authorizeAction(id: string, input: {
1160
- releaseId: string;
1161
- callbackToken: string;
1162
- capability: Record<string, AppJson>;
1163
- requestFingerprint: string;
1164
- paramsFingerprint: string;
1165
- connectorId?: string;
1166
- }): Promise<AppActionDecision>;
1167
- mintRuntimeToken(id: string): Promise<AppRuntimeToken>;
1168
- resolveBinding(id: string, bindingId: string, receiptId: string, callbackToken: string): Promise<AppBindingResolution>;
1169
- listAutomationRuns(id: string): Promise<AppAutomationRun[]>;
1170
- startAutomationRun(id: string, automationId: string, trigger?: Record<string, AppJson>): Promise<AppAutomationRun>;
1171
- claimAutomationStep(id: string, runId: string): Promise<AppAutomationRun>;
1172
- completeAutomationStep(id: string, runId: string, cursor: number, idempotencyKey: string, output?: AppJson): Promise<AppAutomationRun>;
1173
- failAutomationStep(id: string, runId: string, cursor: number, idempotencyKey: string, reason: string): Promise<AppAutomationRun>;
1174
- revokeApproval(id: string, approvalId: string): Promise<void>;
1175
- }
1176
-
1177
926
  /**
1178
927
  * Audit log — admin-scoped event history.
1179
928
  */
@@ -5194,259 +4943,6 @@ declare class Functions {
5194
4943
  invoke(functionId: string, params?: FunctionInvokeParams): Promise<Record<string, unknown>>;
5195
4944
  }
5196
4945
 
5197
- interface MiosaErrorBody {
5198
- error?: string | {
5199
- code?: string;
5200
- message?: string;
5201
- details?: unknown;
5202
- };
5203
- message?: string;
5204
- code?: string;
5205
- detail?: string;
5206
- details?: unknown;
5207
- reason?: string;
5208
- request_id?: string;
5209
- }
5210
- declare class MiosaError extends Error {
5211
- readonly status: number;
5212
- readonly code: string;
5213
- readonly details: unknown;
5214
- readonly requestId: string | undefined;
5215
- constructor(message: string, status: number, code: string, details?: unknown, requestId?: string);
5216
- static fromResponse(status: number, body: MiosaErrorBody, requestId?: string): MiosaError;
5217
- }
5218
- declare class AuthError extends MiosaError {
5219
- constructor(message: string, status?: number, code?: string, details?: unknown, requestId?: string);
5220
- }
5221
- declare class NotFoundError extends MiosaError {
5222
- constructor(message: string, code?: string, details?: unknown, requestId?: string);
5223
- }
5224
- declare class RateLimitError extends MiosaError {
5225
- readonly retryAfter: number | undefined;
5226
- constructor(message: string, details?: unknown, requestId?: string, retryAfter?: number);
5227
- }
5228
- declare class InsufficientCreditsError extends MiosaError {
5229
- constructor(message: string, details?: unknown, requestId?: string);
5230
- }
5231
- declare class ValidationError extends MiosaError {
5232
- constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string);
5233
- }
5234
- declare class TimeoutError extends MiosaError {
5235
- constructor(message?: string);
5236
- }
5237
- declare class NetworkError extends MiosaError {
5238
- readonly cause: Error;
5239
- constructor(message: string, cause: Error);
5240
- }
5241
- declare class ProjectNotLinkedError extends MiosaError {
5242
- constructor(message: string, status?: number, details?: unknown, requestId?: string);
5243
- }
5244
- declare class SubjectNotAllowedError extends MiosaError {
5245
- constructor(message: string, status?: number, details?: unknown, requestId?: string);
5246
- }
5247
- declare class ScopeNotAllowedError extends MiosaError {
5248
- constructor(message: string, status?: number, details?: unknown, requestId?: string);
5249
- }
5250
- declare class ManagedProviderBindingOnlyError extends MiosaError {
5251
- constructor(message: string, status?: number, details?: unknown, requestId?: string);
5252
- }
5253
- declare class InstallationRequiredError extends MiosaError {
5254
- constructor(message: string, status?: number, details?: unknown, requestId?: string);
5255
- }
5256
- declare class UserAuthorizationRequiredError extends MiosaError {
5257
- constructor(message: string, status?: number, details?: unknown, requestId?: string);
5258
- }
5259
- declare class EgressHostNotAllowedError extends MiosaError {
5260
- constructor(message: string, status?: number, details?: unknown, requestId?: string);
5261
- }
5262
- declare class TokenRefreshFailedError extends MiosaError {
5263
- constructor(message: string, status?: number, details?: unknown, requestId?: string);
5264
- }
5265
-
5266
- type ForgeRepositoryId = string & {
5267
- readonly __brand: "ForgeRepositoryId";
5268
- };
5269
- type ForgeOrganizationId = string & {
5270
- readonly __brand: "ForgeOrganizationId";
5271
- };
5272
- type ForgeRepositoryVisibility = "public" | "private" | "internal";
5273
- type ForgeRepositoryState = "provisioning" | "active" | "error" | "deletion_pending" | "deleted";
5274
- interface ForgeRepository {
5275
- id: ForgeRepositoryId;
5276
- name: string;
5277
- slug: string;
5278
- default_branch: string;
5279
- visibility: ForgeRepositoryVisibility;
5280
- state: ForgeRepositoryState;
5281
- clone_ready: boolean;
5282
- clone_url: string | null;
5283
- project_ids: string[];
5284
- created_at: string;
5285
- updated_at: string;
5286
- }
5287
- interface ForgeRepositoryCreateParams {
5288
- name: string;
5289
- slug?: string;
5290
- defaultBranch?: string;
5291
- visibility?: ForgeRepositoryVisibility;
5292
- projectIds?: string[];
5293
- idempotencyKey?: string;
5294
- }
5295
- interface ForgeRepositoryUpdateParams {
5296
- name?: string;
5297
- slug?: string;
5298
- visibility?: ForgeRepositoryVisibility;
5299
- projectIds?: string[];
5300
- }
5301
- interface ForgeRepositoryDeleteOptions {
5302
- /** Deprecated: delete is inherently replay-safe and accepts no key in v1. */
5303
- idempotencyKey?: never;
5304
- }
5305
- interface ForgeCapabilities {
5306
- api_version: "v1";
5307
- ownership: "organization";
5308
- detail_locator: "repository_id";
5309
- lifecycle_states: ForgeRepositoryState[];
5310
- visibility_values: ForgeRepositoryVisibility[];
5311
- clone_ready_states: ["active"];
5312
- base_url: string;
5313
- features: Record<string, boolean>;
5314
- }
5315
- interface ForgeDeleteReceipt {
5316
- operation_id: ForgeRepositoryId;
5317
- replayed: boolean;
5318
- }
5319
- interface ForgeNamedRef {
5320
- name: string;
5321
- oid: string;
5322
- }
5323
- interface ForgeBranch extends ForgeNamedRef {
5324
- is_default: boolean;
5325
- }
5326
- interface ForgeRepositoryRefs {
5327
- default_branch: string;
5328
- head_oid: string | null;
5329
- branches: ForgeBranch[];
5330
- tags: ForgeNamedRef[];
5331
- }
5332
- type ForgeTreeEntryType = "blob" | "tree";
5333
- interface ForgeTreeEntry {
5334
- name: string;
5335
- path: string;
5336
- type: ForgeTreeEntryType;
5337
- oid: string;
5338
- size: number | null;
5339
- }
5340
- interface ForgeRepositoryTree {
5341
- ref: string;
5342
- commit_oid: string;
5343
- path: string;
5344
- entries: ForgeTreeEntry[];
5345
- truncated: boolean;
5346
- }
5347
- type ForgeBlobEncoding = "utf-8" | "base64";
5348
- interface ForgeRepositoryBlob {
5349
- ref: string;
5350
- commit_oid: string;
5351
- path: string;
5352
- oid: string;
5353
- size: number;
5354
- encoding: ForgeBlobEncoding;
5355
- content: string;
5356
- }
5357
- interface ForgeCommit {
5358
- oid: string;
5359
- short_oid: string;
5360
- subject: string;
5361
- author_name: string;
5362
- author_email: string;
5363
- authored_at: string;
5364
- committer_name: string;
5365
- committed_at: string;
5366
- parents: string[];
5367
- }
5368
- interface ForgeCommitHistory {
5369
- ref: string;
5370
- path: string;
5371
- commits: ForgeCommit[];
5372
- page: {
5373
- has_more: boolean;
5374
- next_cursor: string | null;
5375
- };
5376
- }
5377
- interface ForgeContentLocation {
5378
- ref?: string;
5379
- path?: string;
5380
- }
5381
- interface ForgeCommitQuery extends ForgeContentLocation {
5382
- limit?: number;
5383
- cursor?: string;
5384
- }
5385
- interface ForgeFileAuthoringParams {
5386
- branch?: string;
5387
- expectedHead: string;
5388
- message?: string;
5389
- content?: string;
5390
- idempotencyKey?: string;
5391
- }
5392
- interface ForgeFileOperationReceipt {
5393
- operation_id: string;
5394
- repository_id: ForgeRepositoryId;
5395
- branch: string;
5396
- path: string;
5397
- action: "create" | "update" | "delete";
5398
- previous_head: string;
5399
- new_head: string;
5400
- commit: Omit<ForgeCommit, "parents"> & {
5401
- committer_email: string;
5402
- signature_status: "unsigned";
5403
- };
5404
- policy: {
5405
- decision: "allowed";
5406
- receipt_ids: string[];
5407
- };
5408
- replayed: boolean;
5409
- }
5410
- declare class ForgeContractError extends MiosaError {
5411
- constructor(message: string, details?: unknown);
5412
- }
5413
- declare class ForgeUnavailableError extends MiosaError {
5414
- constructor(message: string, cause: MiosaError);
5415
- }
5416
- declare class ForgeStorageError extends MiosaError {
5417
- constructor(message: string, cause: MiosaError);
5418
- }
5419
- declare class ForgePolicyViolationError extends MiosaError {
5420
- constructor(message: string, cause: MiosaError);
5421
- }
5422
- declare class ForgeRepositories {
5423
- private readonly http;
5424
- constructor(http: HttpClient);
5425
- create(params: ForgeRepositoryCreateParams): Promise<ForgeRepository>;
5426
- list(): Promise<ForgeRepository[]>;
5427
- get(id: ForgeRepositoryId): Promise<ForgeRepository>;
5428
- refs(id: ForgeRepositoryId): Promise<ForgeRepositoryRefs>;
5429
- tree(id: ForgeRepositoryId, location?: ForgeContentLocation): Promise<ForgeRepositoryTree>;
5430
- blob(id: ForgeRepositoryId, location: ForgeContentLocation & {
5431
- path: string;
5432
- }): Promise<ForgeRepositoryBlob>;
5433
- readme(id: ForgeRepositoryId, location?: ForgeContentLocation): Promise<ForgeRepositoryBlob>;
5434
- commits(id: ForgeRepositoryId, query?: ForgeCommitQuery): Promise<ForgeCommitHistory>;
5435
- putFile(id: ForgeRepositoryId, path: string, params: ForgeFileAuthoringParams & {
5436
- content: string;
5437
- }): Promise<ForgeFileOperationReceipt>;
5438
- deleteFile(id: ForgeRepositoryId, path: string, params: ForgeFileAuthoringParams): Promise<ForgeFileOperationReceipt>;
5439
- private authorFile;
5440
- update(id: ForgeRepositoryId, params: ForgeRepositoryUpdateParams): Promise<ForgeRepository>;
5441
- delete(id: ForgeRepositoryId, _options?: ForgeRepositoryDeleteOptions): Promise<ForgeDeleteReceipt>;
5442
- }
5443
- declare class Forge {
5444
- readonly repositories: ForgeRepositories;
5445
- constructor(http: HttpClient);
5446
- private readonly http;
5447
- capabilities(): Promise<ForgeCapabilities>;
5448
- }
5449
-
5450
4946
  /**
5451
4947
  * HealthChecks resource — uptime monitoring.
5452
4948
  */
@@ -5687,120 +5183,44 @@ interface HostEvent {
5687
5183
  data: unknown;
5688
5184
  timestamp: string;
5689
5185
  }
5690
- /** Job lifecycle, from `Schemas.Job` `@valid_states`. */
5691
- type JobState = "queued" | "running" | "succeeded" | "failed" | "timeout" | "canceled";
5692
- /**
5693
- * @deprecated Renamed to {@link JobState}: the field is `state`, not
5694
- * `status`, and the old union carried two values (`completed`, `cancelled`)
5695
- * that the server never emits. Kept as an alias so existing imports still
5696
- * compile.
5697
- */
5698
- type JobStatus = JobState;
5699
- /**
5700
- * A persisted exec job, as returned by
5701
- * `GET /opencomputers/hosts/{id}/exec/{job_id}` (unwrapped from its `job`
5702
- * envelope by {@link Jobs.get}).
5703
- */
5186
+ type JobStatus = "queued" | "running" | "completed" | "failed" | "cancelled";
5704
5187
  interface JobData {
5705
5188
  id: JobId;
5706
5189
  host_id: HostId;
5707
- tenant_id: string;
5708
- cmd: string;
5190
+ status: JobStatus;
5191
+ command: string;
5709
5192
  args: string[];
5193
+ env: string[];
5710
5194
  cwd: string | null;
5711
- timeout_ms: number;
5712
- state: JobState;
5713
5195
  exit_code: number | null;
5714
- started_at: string | null;
5715
- ended_at: string | null;
5716
- inserted_at: string;
5196
+ stdout: string | null;
5197
+ stderr: string | null;
5198
+ created_at: string;
5199
+ updated_at: string;
5200
+ completed_at: string | null;
5717
5201
  }
5718
- /**
5719
- * Body of `POST /opencomputers/hosts/{id}/exec`.
5720
- *
5721
- * `cmd`, not `command`: the controller reads `params["cmd"]` and 422s with
5722
- * `{"error": "cmd is required"}` when it is missing. `timeout_ms`, not
5723
- * `timeout`. `env` is a list of `{name, value}` maps, not `KEY=value`
5724
- * strings - see `Secrets.Injector.merge_env/2`, which keys off `name`.
5725
- *
5726
- * The `stream` flag is deliberately absent: {@link Jobs.run} pins it false
5727
- * (JSON response) and {@link Jobs.runStream} pins it true (SSE response),
5728
- * because the response type depends on it.
5729
- */
5730
5202
  interface JobRunParams {
5731
- cmd: string;
5203
+ command: string;
5732
5204
  args?: string[];
5733
- env?: Array<{
5734
- name: string;
5735
- value: string;
5736
- }>;
5205
+ env?: string[];
5737
5206
  cwd?: string;
5738
- timeout_ms?: number;
5739
- }
5740
- /**
5741
- * Response of `POST /opencomputers/hosts/{id}/exec` with `stream: false` -
5742
- * the buffered result of the whole command. This is an exec result, not a
5743
- * job record: it has no state, no timing, and no id beyond `job_id`.
5744
- */
5745
- interface JobExecResult {
5746
- job_id: JobId;
5747
- exit_code: number | null;
5748
- stdout: string;
5749
- stderr: string;
5750
- }
5751
- /**
5752
- * One row of `GET /opencomputers/hosts/{id}/jobs`.
5753
- *
5754
- * This endpoint reads the audit log (`job.dispatched` / `job.done` /
5755
- * `job.failed` events), not the jobs table, so a row is an event about a
5756
- * job rather than the job itself. Multiple rows can share a `job_id`.
5757
- */
5758
- interface JobAuditEvent {
5759
- id: string;
5760
- job_id: JobId | null;
5761
- kind: string | null;
5762
- status: "dispatched" | "done" | "failed" | "unknown";
5763
- duration_ms: number | null;
5764
- dispatched_at: string | null;
5765
- completed_at: string | null;
5766
- event_at: string;
5767
- payload: Record<string, unknown>;
5207
+ timeout?: number;
5768
5208
  }
5769
- /** Response of `GET /opencomputers/hosts/{id}/jobs`. */
5770
5209
  interface JobListResponse {
5771
- jobs: JobAuditEvent[];
5772
- }
5773
- /** The three SSE `event:` names the exec stream actually emits. */
5774
- type JobEventType = "exec_chunk" | "exec_result" | "exec_error";
5775
- /** A slice of output. `data` is whatever the host sent, unmodified. */
5776
- interface JobChunkEvent {
5777
- type: "exec_chunk";
5778
- /** Defaults to `stdout` server-side when the host omits it. */
5779
- stream: "stdout" | "stderr";
5780
- data: string | null;
5781
- }
5782
- /** Terminal event for a command that ran to completion. */
5783
- interface JobResultEvent {
5784
- type: "exec_result";
5785
- exit_code: number | null;
5786
- elapsed_ms: number | null;
5210
+ data: JobData[];
5211
+ meta: {
5212
+ total: number;
5213
+ page: number;
5214
+ per_page: number;
5215
+ };
5787
5216
  }
5788
- /** Terminal event for a command that failed to complete. */
5789
- interface JobErrorEvent {
5790
- type: "exec_error";
5791
- reason: string | null;
5792
- /** Present only on the server-side timeout path. */
5793
- job_id?: JobId;
5217
+ type JobEventType = "stdout" | "stderr" | "exit" | "error" | "started" | "done";
5218
+ interface JobEvent {
5219
+ type: JobEventType;
5220
+ job_id: JobId;
5221
+ data: string | number | null;
5222
+ timestamp: string;
5794
5223
  }
5795
- /**
5796
- * An exec SSE event, discriminated on the SSE `event:` name.
5797
- *
5798
- * There is no `timestamp` and no per-event `job_id` (outside the timeout
5799
- * case) because the server sends neither. Anything the client synthesised
5800
- * to fill those in would be fabricated data that the compiler would then
5801
- * force callers to trust.
5802
- */
5803
- type JobEvent = JobChunkEvent | JobResultEvent | JobErrorEvent;
5804
5224
  interface FsEntry {
5805
5225
  name: string;
5806
5226
  path: string;
@@ -6276,23 +5696,10 @@ declare class Hosts {
6276
5696
  * Jobs resource — run commands on a remote OpenComputers host and stream output.
6277
5697
  *
6278
5698
  * ```ts
6279
- * // Buffered: one call, one result.
6280
- * const result = await client.openComputers.jobs.run(hostId, { cmd: "npm test" });
6281
- * console.log(result.exit_code, result.stdout);
6282
- *
6283
- * // Streamed: same endpoint, live output.
6284
- * for await (const event of client.openComputers.jobs.runStream(hostId, { cmd: "npm test" })) {
6285
- * switch (event.type) {
6286
- * case "exec_chunk":
6287
- * process.stdout.write(event.data ?? "");
6288
- * break;
6289
- * case "exec_result":
6290
- * console.log(`exit ${event.exit_code} in ${event.elapsed_ms}ms`);
6291
- * break;
6292
- * case "exec_error":
6293
- * console.error(event.reason);
6294
- * break;
6295
- * }
5699
+ * const job = await client.openComputers.jobs.run(hostId, { command: "npm test" });
5700
+ * for await (const event of client.openComputers.jobs.stream(hostId, job.id)) {
5701
+ * process.stdout.write(String(event.data ?? ""));
5702
+ * if (event.type === "done") break;
6296
5703
  * }
6297
5704
  * ```
6298
5705
  */
@@ -6301,53 +5708,26 @@ declare class Jobs {
6301
5708
  constructor(http: HttpClient);
6302
5709
  private base;
6303
5710
  /**
6304
- * Run a command on the host and wait for the buffered result.
6305
- *
6306
- * Sends `stream: false` so the server buffers output and answers with JSON.
6307
- * `stream` defaults to *true* server-side, which answers with a chunked SSE
6308
- * body instead - use {@link runStream} for that.
6309
- *
6310
- * Note this holds the connection open for the life of the command
6311
- * (`timeout_ms`, 30 s default), because the server does not answer until
6312
- * the command finishes.
6313
- */
6314
- run(hostId: HostId | string, params: JobRunParams): Promise<JobExecResult>;
6315
- /**
6316
- * Run a command on the host and stream its output as it happens.
6317
- *
6318
- * Same endpoint as {@link run} with `stream: true`, which is the server's
6319
- * default mode. Terminates with one `exec_result` or one `exec_error`.
5711
+ * Dispatch a command to run on the remote host.
6320
5712
  */
6321
- runStream(hostId: HostId | string, params: JobRunParams): AsyncIterableIterator<JobEvent>;
5713
+ run(hostId: HostId | string, params: JobRunParams): Promise<JobData>;
6322
5714
  /**
6323
- * List recent job activity for a host.
6324
- *
6325
- * Hits `/jobs`, not `/exec`: there is no `GET /opencomputers/hosts/{id}/exec`
6326
- * route on the server, so the old path 404'd. The rows are audit-log events
6327
- * about jobs (`job.dispatched` / `job.done` / `job.failed`), newest first,
6328
- * not job records - see {@link JobAuditEvent}.
6329
- *
6330
- * @param limit Server caps this at 100 and defaults to 20.
5715
+ * List all jobs for a host.
6331
5716
  */
6332
- list(hostId: HostId | string, limit?: number): Promise<JobListResponse>;
5717
+ list(hostId: HostId | string): Promise<JobListResponse>;
6333
5718
  /**
6334
5719
  * Fetch the current state of a job.
6335
- *
6336
- * The server wraps the record in a `job` envelope; this unwraps it.
6337
5720
  */
6338
5721
  get(hostId: HostId | string, jobId: JobId | string): Promise<JobData>;
6339
5722
  /**
6340
- * Re-attach to a job that is already running and stream what is left.
5723
+ * Stream live output from a running job.
6341
5724
  *
6342
- * This is the reconnect endpoint. If the job has already reached a terminal
6343
- * state the server answers `204 No Content` and this yields nothing, rather
6344
- * than replaying output - the server never stored it.
5725
+ * Yields `JobEvent` objects with `type` of `stdout`, `stderr`, `exit`, or
5726
+ * `done`. Break the loop when you receive `done` or `exit`.
6345
5727
  */
6346
5728
  stream(hostId: HostId | string, jobId: JobId | string): AsyncIterableIterator<JobEvent>;
6347
5729
  /**
6348
5730
  * Cancel a running or queued job.
6349
- *
6350
- * Answers `204` on success and `409` when the job is already terminal.
6351
5731
  */
6352
5732
  cancel(hostId: HostId | string, jobId: JobId | string): Promise<void>;
6353
5733
  }
@@ -6541,14 +5921,13 @@ declare class OcWorkspaces {
6541
5921
  * // Register a host — save host_key immediately, shown only once
6542
5922
  * const host = await miosa.openComputers.hosts.create({ name: "my-mac" });
6543
5923
  *
6544
- * // Run a command and wait for the buffered result
6545
- * const result = await miosa.openComputers.jobs.run(host.id, { cmd: "npm test" });
6546
- * console.log(result.exit_code, result.stdout);
5924
+ * // Run a command
5925
+ * const job = await miosa.openComputers.jobs.run(host.id, { command: "npm test" });
6547
5926
  *
6548
- * // Or stream the output live
6549
- * for await (const event of miosa.openComputers.jobs.runStream(host.id, { cmd: "npm test" })) {
6550
- * if (event.type === "exec_chunk") process.stdout.write(event.data ?? "");
6551
- * if (event.type === "exec_result") console.log(`exit ${event.exit_code}`);
5927
+ * // Stream output
5928
+ * for await (const event of miosa.openComputers.jobs.stream(host.id, job.id)) {
5929
+ * process.stdout.write(String(event.data ?? ""));
5930
+ * if (event.type === "done") break;
6552
5931
  * }
6553
5932
  *
6554
5933
  * // Expose a port
@@ -6901,18 +6280,6 @@ interface SandboxCreateParams {
6901
6280
  agent_profile_id?: string;
6902
6281
  skipRuntimeProfile?: boolean;
6903
6282
  skip_agent_runtime_profile?: boolean;
6904
- workspaceId?: string;
6905
- workspace_id?: string;
6906
- workspaceSlug?: string;
6907
- workspace_slug?: string;
6908
- workspaceName?: string;
6909
- workspace_name?: string;
6910
- projectId?: string;
6911
- project_id?: string;
6912
- projectSlug?: string;
6913
- project_slug?: string;
6914
- projectName?: string;
6915
- project_name?: string;
6916
6283
  externalWorkspaceId?: string;
6917
6284
  external_workspace_id?: string;
6918
6285
  externalUserId?: string;
@@ -7036,8 +6403,6 @@ interface SandboxUsage {
7036
6403
  state: string;
7037
6404
  runtime_sec: number;
7038
6405
  provisioned_vcpu_ms: number;
7039
- provisioned_memory_mb_ms: number | null;
7040
- creation_count: number;
7041
6406
  active_cpu_ms: number | null;
7042
6407
  network_ingress_bytes: number | null;
7043
6408
  network_egress_bytes: number | null;
@@ -7051,8 +6416,6 @@ interface SandboxUsage {
7051
6416
  timeout_remaining_ms: number | null;
7052
6417
  }
7053
6418
  interface SandboxForkParams {
7054
- snapshotId?: string;
7055
- snapshot_id?: string;
7056
6419
  timeoutSec?: number;
7057
6420
  timeout_sec?: number;
7058
6421
  templateId?: string;
@@ -7274,22 +6637,7 @@ declare class SandboxFiles {
7274
6637
  tree(path?: string, depth?: number): Promise<SandboxFileTreeNode>;
7275
6638
  /** POST /api/v1/sandboxes/{id}/files/write-many — write multiple files atomically. */
7276
6639
  writeMany(files: SandboxWriteManyEntry[]): Promise<SandboxWriteManyResult>;
7277
- /**
7278
- * GET /api/v1/sandboxes/{id}/files/watch (SSE) — live file change events.
7279
- *
7280
- * SANDBOXES-HOST ONLY. This route is declared in `Web.Router.Sandboxes`
7281
- * and not in `Web.Router.Platform`, so it 404s against the SDK's default
7282
- * `https://api.miosa.ai/api/v1` base URL. Construct the client with
7283
- * `baseUrl: "https://sandboxes.miosa.ai/api/v1"` to reach it, or poll
7284
- * {@link list}/{@link stat} instead. See `./sandbox-host-routes.ts`.
7285
- *
7286
- * The server opens with a handshake record (`event: connected` /
7287
- * `data: {"sandbox_id":...}`) before any change events. That record is
7288
- * not a file change, so it is dropped here rather than yielded as a
7289
- * `SandboxFileChange` with `type: "connected"` and no `path`. Real change
7290
- * records carry their own `type` (`created` | `modified` | `deleted`) in
7291
- * the JSON body, so the SSE `event: file_change` name never overwrites it.
7292
- */
6640
+ /** GET /api/v1/sandboxes/{id}/files/watch (SSE) — live file change events. */
7293
6641
  watch(): AsyncIterableIterator<SandboxFileChange>;
7294
6642
  }
7295
6643
  declare class SandboxPreview {
@@ -7506,11 +6854,6 @@ declare class Sandbox {
7506
6854
  resume(idempotencyKey?: string): Promise<Sandbox>;
7507
6855
  deploy(params?: SandboxDeployParams): Promise<Record<string, unknown>>;
7508
6856
  deployDocker(params?: SandboxDeployParams): Promise<Record<string, unknown>>;
7509
- /** Deploy an immutable snapshot without modifying the editable sandbox. */
7510
- deploySnapshot(snapshotId: string, params?: SandboxDeployParams, options?: {
7511
- cleanup?: boolean;
7512
- forkIdempotencyKey?: string;
7513
- }): Promise<Record<string, unknown>>;
7514
6857
  /** Check readiness of the sandbox (GET /sandboxes/:id/readiness). */
7515
6858
  readiness(): Promise<Record<string, unknown>>;
7516
6859
  /**
@@ -7533,16 +6876,6 @@ declare class Sandbox {
7533
6876
  timeout?: number;
7534
6877
  stream?: boolean;
7535
6878
  }): Promise<boolean>;
7536
- /**
7537
- * Readiness answers from the server; `assertRunning` reads the local
7538
- * snapshot. Leaving that snapshot behind meant a caller could await
7539
- * `waitUntilReady()`, receive `true`, and have the very next call refused
7540
- * for being "provisioning" — the sandbox was running the whole time, only
7541
- * this object had not been told. Nothing here can fail the wait: readiness
7542
- * has already answered, so a refresh that does not land is not the caller's
7543
- * problem.
7544
- */
7545
- private adoptReadyState;
7546
6879
  /**
7547
6880
  * Returns `true` / `false` for terminal SSE events, or `null` if the
7548
6881
  * stream endpoint is unavailable (404 or transport error) so callers
@@ -8581,7 +7914,6 @@ declare class Miosa {
8581
7914
  readonly orgInvites: OrgInvites;
8582
7915
  /** Organizations available to the user session, membership, invites, and switching. */
8583
7916
  readonly organizations: Organizations;
8584
- readonly forge: Forge;
8585
7917
  /** Current tenant plan, limits, and live usage counters. */
8586
7918
  readonly tenant: Tenant;
8587
7919
  /** Datacenter regions, compute sizes, pricing, community templates. */
@@ -8606,8 +7938,6 @@ declare class Miosa {
8606
7938
  readonly projectIntegrations: ProjectIntegrations;
8607
7939
  /** Built-in auth for generated apps inside sandboxes/deployments. */
8608
7940
  readonly projectAuth: ProjectAuth;
8609
- /** Durable generated App Documents, exact-version reviews, and publication bindings. */
8610
- readonly appDocuments: AppDocuments;
8611
7941
  /** BYOK encrypted per-user provider keys. */
8612
7942
  readonly externalKeys: ExternalKeys;
8613
7943
  /** Model Context Protocol — JSON-RPC dispatch + streaming channel. */
@@ -8622,8 +7952,6 @@ declare class Miosa {
8622
7952
  readonly agentRunGroups: AgentRunGroups;
8623
7953
  /** Agent runtime profiles — tenant/workspace defaults for sandbox/computer agents. */
8624
7954
  readonly agentRuntimeProfiles: AgentRuntimeProfiles;
8625
- /** Persisted workspace Agent definitions and immutable versions. */
8626
- readonly agents: AgentDefinitions;
8627
7955
  /** MIOSA Connect — provider connectors and runtime tokens. */
8628
7956
  readonly connectors: Connectors;
8629
7957
  /** Inherited runtime env — tenant/workspace/project defaults for agent runtimes. */
@@ -8919,4 +8247,73 @@ declare class AppAuth {
8919
8247
  private _post;
8920
8248
  }
8921
8249
 
8922
- export { AGENT_BUILD_KIND_SPECS, type AcceptOrgInviteResponse, type AcceptWorkspaceInviteResponse, type AddDomainParams, type AddWorkspaceMemberParams, Admin, type AgentBuildExecutionPacket, type AgentBuildFileSpec, type AgentBuildKind, type AgentBuildKindSpec, type AgentBuildPlannerDocument, type AgentDefinitionCreateParams, type AgentDefinitionData, type AgentDefinitionListParams, type AgentDefinitionUpdateParams, AgentDefinitions, type AgentDispatchParams, type AgentEvent$1 as AgentEvent, type AgentEventType, AgentRuntimeProfiles, type AgentSessionCreateParams, type AgentSessionData, type AgentSessionListResponse$1 as AgentSessionListResponse, type AgentSessionStatus$1 as AgentSessionStatus, type AgentVersionData, type AllowParams, Analytics, type AnalyticsFilters, type ApiKeyCreateParams, type ApiKeyCreateResult, type ApiKeyData, type ApiKeyId, type ApiKeyListParams, ApiKeys, type AppActionDecision, AppAuth, type AppAuthConfig, type AppAuthResourceType, type AppAuthSession, type AppAuthTokenPayload, type AppAutomationRun, type AppCatalogEntry, type AppCollectionRecord, type AppDocument, type AppDocumentCreateParams, type AppDocumentDiagnostics, type AppDocumentRecord, type AppDocumentUpdateParams, AppDocuments, type AppInstallData, type AppInstallEvent, type AppJson, type AppReleaseApproval, type AppReleaseCandidate, type AttachAwsRoleParams, type AuditListParams, AuditLog, type AuditLogEvent, type AuditLogListParams, type AuditTailParams, AuthError, type AuthToken, type BenchmarkCompareParams, type BenchmarkCreateParams, Benchmarks, type BindingCreateParams, type BindingListParams, type BrandingData, type BrandingUpdateParams, type BucketCreateParams, type BucketData, type BucketId, type BuilderSessionListParams, BuilderSessions, type BulkUserActionParams, type ChannelCreateParams, type ChannelData, type ChannelListParams, type ChannelUpdateParams, Channels, type ChatCompletionCreateParams, type ChatCompletionCreateStreamParams, Checkpoints, type ClickParams, Cloud, type CloudAccount, type CloudAccountCreateParams, type CloudAccountMode, type CloudAccountStatus, type CloudCredentialType, type CloudListParams, type CloudPlacementScope, type CloudPool, type CloudPoolCreateParams, type CloudPoolKind, type CloudPreflightRecordParams, type CloudPreflightRun, type CloudPreflightStatus, type CloudProvider, type CloudRegion, type CloudRegionCreateParams, type ClusterCreateParams, type ClusterData, type ClusterEvent, type ClusterId, type ClusterListResponse, type ClusterStatus, CommandCenter, Community, type CompletionCreateParams, type CompletionCreateStreamParams, Completions, type ComputeProduct, Computer, ComputerAudit, ComputerAutoStop, ComputerConnectors, type ComputerCreateParams, type ComputerData, ComputerEnv, type ComputerId, ComputerInbox, type ComputerListParams, type ComputerListResponse, ComputerLogs, type ComputerLogsGetParams, ComputerNetwork, ComputerOsa, ComputerPorts, ComputerSecrets, type ComputerSize, type ComputerStatus, type ComputerTemplateType, ComputerTerminal, type ComputerUpdateParams, type ComputerVisibility, ComputerVolumes, Computers, type ConnectorApplicableDefaultParams, type ConnectorCreateParams, type ConnectorData, type ConnectorDefault, type ConnectorDefaultListParams, type ConnectorDefaultParams, type ConnectorListParams, type ConnectorSubject, type ConnectorTokenParams, type ConnectorTokenResponse, Connectors, type CopyParams, type CreateAdminApiKeyParams, type CreateAgentBuildPacketParams, type CreateBuildRunParams, type CreateOrgInviteParams, type CreateWorkspaceInviteParams, type CreateWorkspaceInviteResponse, type CreditBalance, type CreditTransaction, type CreditTransactionListResponse, type CreditUsage, Credits, type CronJobCreateParams, type CronJobData, type CronJobExecutionData, type CronJobExecutionId, type CronJobId, type CronJobListParams, type CronJobUpdateParams, CronJobs, type CursorInfo, type CustomDomainCreateParams, type CustomDomainData, type CustomDomainId, type CustomDomainListParams, DEFAULT_AGENT_BUILD_OUTPUT_ROOT, DEFAULT_AGENT_BUILD_PACKET_VERSION, Dashboard, type DashboardSummary, type DatabaseCreateParams, type DatabaseCredentials, type DatabaseData, type DatabaseId, type DatabaseListParams, type DatabaseLogsParams, type DatabaseLogsResult, Databases, type DeploymentBuildData, DeploymentConnectors, type DeploymentCreateParams, type DeploymentData, DeploymentDomains, type DeploymentId, type DeploymentListParams, type DeploymentProduct, type DeploymentProofCheck, type DeploymentProofParams, type DeploymentProofProbe, type DeploymentProofResult, type DeploymentReleaseData, type DeploymentReleaseId, DeploymentReleases, DeploymentRuntimeInstances, type DeploymentServiceData, type DeploymentServiceId, type DeploymentServiceType, type DeploymentSourceType, type DeploymentState, type DeploymentUpdateParams, type DeploymentVersionData, type DeploymentVersionId, type DeploymentVersionKind, type DeploymentVersionState, DeploymentVersions, Deployments, Desktop$1 as Desktop, type DesktopActionResult, type DeviceBootstrapParams, type DeviceBootstrapResult, type DeviceBrowserResult, type DeviceCapabilities, type DeviceData, type DeviceExecParams, type DeviceExecResult, type DeviceExposeParams, type DeviceExposeResult, type DeviceExtendParams, type DeviceFileEntry, type DeviceFileListParams, type DeviceKind, type DeviceLifecycleResult, type DeviceListParams, type DeviceReadFileParams, type DeviceReadFileResult, type DeviceWriteFileParams, type DeviceWriteFileResult, Devices, type DirEntry, type DirListResult, type DiscordSendTestParams, DockerDeploy, type DockerDeployApplianceStatus, type DockerDeployCreateParams, type DockerDeployDoctorCheck, type DockerDeployDoctorParams, type DockerDeployDoctorProbe, type DockerDeployDoctorResult, type DockerDeployHostData, type DockerDeployHostEnsureParams, type DockerDeployHostId, type DockerDeployHostListParams, type DockerDeployHostListResponse, type DockerDeployHostResponse, type DockerDeployHostStatus, type DoubleClickParams, type DragParams, type EgressAllowlistRule, EgressAudit, type EgressAuditEvent, type EgressBindingData, EgressHostNotAllowedError, EgressNetwork, type EgressPolicyData, type EgressPolicyMode, type EgressRuleEffect, type EgressSecretData, type EgressSecretScope, type EgressSecretType, EgressSecrets, type EgressSuggestion, Email, EmailCampaigns, EmailInbox, EmailTemplates, type EmbeddingCreateParams, Embeddings, Exec, type ExecParams, type ExecPythonParams, type ExecResult, type ExternalAttribution, type ExternalKeyCreateParams, type ExternalKeyData, ExternalKeys, type FileDeleteParams, type FileDownloadParams, type FileEntry, type FileExportParams, type FileExportResult, type FileListParams, type FileListResult, type FileStat, Files, FlatCustomDomains, Forge, ForgeContractError, type ForgeDeleteReceipt, type ForgeOrganizationId, ForgePolicyViolationError, ForgeRepositories, type ForgeRepository, type ForgeRepositoryCreateParams, type ForgeRepositoryDeleteOptions, type ForgeRepositoryId, type ForgeRepositoryState, type ForgeRepositoryUpdateParams, type ForgeRepositoryVisibility, ForgeStorageError, ForgeUnavailableError, type FsEntry, type FsListResponse, type FsStat, type FunctionCreateParams, type FunctionData, type FunctionId, type FunctionInvokeParams, type FunctionListParams, type FunctionUpdateParams, Functions, type GithubRepo, type GithubSshKey, type HealthCheckCreateParams, type HealthCheckData, type HealthCheckId, type HealthCheckListParams, type HealthCheckUpdateParams, HealthChecks, type HostCreateParams, type HostData, type HostEvent, type HostId, type HostListResponse, type HostStatus, type HostUpdateParams, InstallationRequiredError, InsufficientCreditsError, type IntegrationCatalogEntry, type IntegrationData, Integrations, type JobAuditEvent, type JobChunkEvent, type JobData, type JobErrorEvent, type JobEvent, type JobEventType, type JobExecResult, type JobId, type JobListResponse, type JobResultEvent, type JobRunParams, type JobState, type JobStatus, type KeyParams, type LaunchParams, type LinearCreateIssueParams, type ListAdminApiKeysParams, type ListAdminComputersParams, type ListAdminTenantsParams, type ListAdminUsersParams, ManagedProviderBindingOnlyError, Mcp, type McpDispatchParams, Miosa, type MiosaClientConfig, MiosaError, type MiosaErrorBody, type MkdirParams, type ModeParams, Models, type MouseButton, NetworkError, NetworkPolicy, type NetworkPolicyData, type NetworkPolicyEffect, type NetworkPolicyProtocol, type NetworkPolicyRule, type NetworkPolicySetParams, NotFoundError, type NotificationPrefsUpdateParams, OAuthFlow, type OauthConnectParams, type OauthProvider, type OauthStartResult, type OauthStatusResult, type ObjectListParams, type AgentEvent as OcAgentEvent, type OcAgentSessionData, type AgentSessionListResponse as OcAgentSessionListResponse, type OcWorkspaceCreateParams, type OcWorkspaceData, type OcWorkspaceEvent, type OcWorkspaceListResponse, type OcWorkspaceStatus, type OcWorkspaceUpdateParams, OpenComputers, type OrgInvite, type OrgInviteCreated, type OrgInviteCreatedResponse, type OrgInviteListResponse, type OrgInvitePreview, type OrgInviteRevokeResponse, OrgInvites, type OrgRole, type OrganizationMember, type OrganizationMemberList, type OrganizationMemberRemoved, OrganizationMembers, type OrganizationRole, type OrganizationSummary, type OrganizationSwitchResult, Organizations, type OverviewData, type PolicyCreateParams, type PolicyListParams, type PolicyUpdateParams, type PresignParams, type PresignResult, type PreviewDomainData, type ProductCatalogEntry, type ProductTemplate, type ProductTemplateCatalog, ProjectAuth, type ProjectAuthEnableParams, type ProjectAuthStatus, type ProjectAuthUpdateParams, type ProjectIntegrationCatalogEntry, type ProjectIntegrationCreateParams, type ProjectIntegrationData, type ProjectIntegrationListParams, type ProjectIntegrationUpdateParams, ProjectIntegrations, ProjectNotLinkedError, ProviderDefaults, type ProviderKeyUpsertParams, type PublishFromSandboxParams, type PublishParams, type PublishResult, RateLimitError, type RegionData, Regions, type RollbackParams, type RulesListParams, type Run, type RunActivity, type RunCommandOutput, type RunCreateParams, type RunDiagnostic, type RunDownload, type RunFile, type RunGroup, type RunGroupActivity, type RunGroupCounts, type RunGroupCreateParams, type RunGroupDispatchEntry, type RunGroupDispatchResult, type RunGroupFile, type RunGroupListParams, type RunGroupStatus, type RunGroupWaitOptions, RunGroups, type RunListParams, type RunMessage, type RunOutputs, type RunPreview, type RunStatus, type RunTargetKind, type RunWaitOptions, Runs, type RuntimeCapabilities, RuntimeCapabilitiesResource, RuntimeEnv, type RuntimeEnvListParams, type RuntimeEnvScope, type RuntimeEnvSetParams, type RuntimeEnvTarget, type RuntimeEnvVar, type RuntimeInstanceData, type RuntimeInstanceId, type RuntimeInstanceState, type RuntimeLogsResult, SANDBOX_TEMPLATE, Sandbox, SandboxAudit, type SandboxBuildSpec, type SandboxBuildSpecError, type SandboxBuildSpecValidation, SandboxCommands, type SandboxConnectorAttachParams, type SandboxConnectorBinding, type SandboxConnectorPreflightParams, type SandboxConnectorPreflightResult, SandboxConnectors, type SandboxCreateParams, type SandboxData, SandboxEnv, SandboxEvents, type SandboxExecEvent, type SandboxExecOptions, type SandboxExecResult, type SandboxExecRunner, SandboxFiles, type SandboxGetOrCreateParams, type SandboxId, type SandboxListParams, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, type SandboxState, SandboxTags, type SandboxTemplate, type SandboxTemplateBuild, type SandboxTemplateBuildCreateParams, type SandboxTemplateBuildResourceData, type SandboxTemplateBuildResourceId, type SandboxTemplateCreateParams, type SandboxTemplateList, type SandboxTemplateListParams, type SandboxTemplateResourceData, type SandboxTemplateResourceId, SandboxTemplates, SandboxTerminal, Sandboxes, ScopeNotAllowedError, ScopedFs, type ScrollDirection, type ScrollParams, type SecretCreateParams, type SecretData, type SecretId, type SecretListParams, type SecretRotateParams, type SecretSetParams, type SecretUpdateParams, type SessionId, Settings, type SettingsUpdateParams, type SizeData, type SlackSendTestParams, type SnapshotCreateParams, type SnapshotData, type SnapshotListResponse, type SnapshotProgressEvent, type SnapshotRestoreResult, type SnapshotStatus, SnapshotsStandalone, Storage, type StorageObjectData, SubjectNotAllowedError, type SuggestionsParams, type TemplateBenchmarkLane, type TemplateBuildCreateParams, type TemplateCreateParams, type TemplateData, type TemplateReadinessContract, type TemplateReadinessState, type TemplateSizeReadiness, Templates, type TemplatesListParams, Tenant, type TenantBrandingUpdateParams, type TenantId, type TenantPlan, type TenantSummary, type TerminalCreateParams, TimeoutError, type TimeseriesParams, TokenRefreshFailedError, type TunnelAuthMode, type TunnelCreateParams, type TunnelData, type TunnelId, type TunnelListResponse, type TunnelUpdateParams, type TypeParams, type UpdateWorkspaceMemberRoleParams, Usage, type UsageReportParams, type UsageSession, type UsageSessionsParams, type UsageSummary, UserAuthorizationRequiredError, type UserId, ValidationError, type VersionListParams, type VolumeAttachParams, type VolumeAttachmentData, type VolumeCreateParams, type VolumeData, type VolumeId, type VolumeListParams, Volumes, type WaitParams, type WebhookCreateParams, type WebhookData, type WebhookDeliveryData, type WebhookDeliveryId, type WebhookId, type WebhookListParams, type WebhookUpdateParams, Webhooks, type WindowFocusParams, type WindowInfo, type WorkspaceId, type WorkspaceInvite, type WorkspaceInviteCreatedResponse, type WorkspaceInviteListResponse, type WorkspaceInvitePreview, type WorkspaceInviteRevokeResponse, WorkspaceInvites, type WorkspaceMember, type WorkspaceMemberAddedResponse, type WorkspaceMemberDeleteResponse, type WorkspaceMemberListResponse, type WorkspaceMemberRecord, type WorkspaceMemberRecordResponse, WorkspaceMembers, type WorkspaceRole, type WsTicket, createAgentBuildExecutionPacket, createAgentBuildExpectedOutputs, createAgentBuildPrompt, createBuildRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };
8250
+ interface MiosaErrorBody {
8251
+ error?: string | {
8252
+ code?: string;
8253
+ message?: string;
8254
+ details?: unknown;
8255
+ };
8256
+ message?: string;
8257
+ code?: string;
8258
+ detail?: string;
8259
+ details?: unknown;
8260
+ reason?: string;
8261
+ request_id?: string;
8262
+ }
8263
+ declare class MiosaError extends Error {
8264
+ readonly status: number;
8265
+ readonly code: string;
8266
+ readonly details: unknown;
8267
+ readonly requestId: string | undefined;
8268
+ constructor(message: string, status: number, code: string, details?: unknown, requestId?: string);
8269
+ static fromResponse(status: number, body: MiosaErrorBody, requestId?: string): MiosaError;
8270
+ }
8271
+ declare class AuthError extends MiosaError {
8272
+ constructor(message: string, status?: number, code?: string, details?: unknown, requestId?: string);
8273
+ }
8274
+ declare class NotFoundError extends MiosaError {
8275
+ constructor(message: string, code?: string, details?: unknown, requestId?: string);
8276
+ }
8277
+ declare class RateLimitError extends MiosaError {
8278
+ readonly retryAfter: number | undefined;
8279
+ constructor(message: string, details?: unknown, requestId?: string, retryAfter?: number);
8280
+ }
8281
+ declare class InsufficientCreditsError extends MiosaError {
8282
+ constructor(message: string, details?: unknown, requestId?: string);
8283
+ }
8284
+ declare class ValidationError extends MiosaError {
8285
+ constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string);
8286
+ }
8287
+ declare class TimeoutError extends MiosaError {
8288
+ constructor(message?: string);
8289
+ }
8290
+ declare class NetworkError extends MiosaError {
8291
+ readonly cause: Error;
8292
+ constructor(message: string, cause: Error);
8293
+ }
8294
+ declare class ProjectNotLinkedError extends MiosaError {
8295
+ constructor(message: string, status?: number, details?: unknown, requestId?: string);
8296
+ }
8297
+ declare class SubjectNotAllowedError extends MiosaError {
8298
+ constructor(message: string, status?: number, details?: unknown, requestId?: string);
8299
+ }
8300
+ declare class ScopeNotAllowedError extends MiosaError {
8301
+ constructor(message: string, status?: number, details?: unknown, requestId?: string);
8302
+ }
8303
+ declare class ManagedProviderBindingOnlyError extends MiosaError {
8304
+ constructor(message: string, status?: number, details?: unknown, requestId?: string);
8305
+ }
8306
+ declare class InstallationRequiredError extends MiosaError {
8307
+ constructor(message: string, status?: number, details?: unknown, requestId?: string);
8308
+ }
8309
+ declare class UserAuthorizationRequiredError extends MiosaError {
8310
+ constructor(message: string, status?: number, details?: unknown, requestId?: string);
8311
+ }
8312
+ declare class EgressHostNotAllowedError extends MiosaError {
8313
+ constructor(message: string, status?: number, details?: unknown, requestId?: string);
8314
+ }
8315
+ declare class TokenRefreshFailedError extends MiosaError {
8316
+ constructor(message: string, status?: number, details?: unknown, requestId?: string);
8317
+ }
8318
+
8319
+ export { AGENT_BUILD_KIND_SPECS, type AcceptOrgInviteResponse, type AcceptWorkspaceInviteResponse, type AddDomainParams, type AddWorkspaceMemberParams, Admin, type AgentBuildExecutionPacket, type AgentBuildFileSpec, type AgentBuildKind, type AgentBuildKindSpec, type AgentBuildPlannerDocument, type AgentDispatchParams, type AgentEvent$1 as AgentEvent, type AgentEventType, AgentRuntimeProfiles, type AgentSessionCreateParams, type AgentSessionData, type AgentSessionListResponse$1 as AgentSessionListResponse, type AgentSessionStatus$1 as AgentSessionStatus, type AllowParams, Analytics, type AnalyticsFilters, type ApiKeyCreateParams, type ApiKeyCreateResult, type ApiKeyData, type ApiKeyId, type ApiKeyListParams, ApiKeys, AppAuth, type AppAuthConfig, type AppAuthResourceType, type AppAuthSession, type AppAuthTokenPayload, type AppCatalogEntry, type AppInstallData, type AppInstallEvent, type AttachAwsRoleParams, type AuditListParams, AuditLog, type AuditLogEvent, type AuditLogListParams, type AuditTailParams, AuthError, type AuthToken, type BenchmarkCompareParams, type BenchmarkCreateParams, Benchmarks, type BindingCreateParams, type BindingListParams, type BrandingData, type BrandingUpdateParams, type BucketCreateParams, type BucketData, type BucketId, type BuilderSessionListParams, BuilderSessions, type BulkUserActionParams, type ChannelCreateParams, type ChannelData, type ChannelListParams, type ChannelUpdateParams, Channels, type ChatCompletionCreateParams, type ChatCompletionCreateStreamParams, Checkpoints, type ClickParams, Cloud, type CloudAccount, type CloudAccountCreateParams, type CloudAccountMode, type CloudAccountStatus, type CloudCredentialType, type CloudListParams, type CloudPlacementScope, type CloudPool, type CloudPoolCreateParams, type CloudPoolKind, type CloudPreflightRecordParams, type CloudPreflightRun, type CloudPreflightStatus, type CloudProvider, type CloudRegion, type CloudRegionCreateParams, type ClusterCreateParams, type ClusterData, type ClusterEvent, type ClusterId, type ClusterListResponse, type ClusterStatus, CommandCenter, Community, type CompletionCreateParams, type CompletionCreateStreamParams, Completions, type ComputeProduct, Computer, ComputerAudit, ComputerAutoStop, ComputerConnectors, type ComputerCreateParams, type ComputerData, ComputerEnv, type ComputerId, ComputerInbox, type ComputerListParams, type ComputerListResponse, ComputerLogs, type ComputerLogsGetParams, ComputerNetwork, ComputerOsa, ComputerPorts, ComputerSecrets, type ComputerSize, type ComputerStatus, type ComputerTemplateType, ComputerTerminal, type ComputerUpdateParams, type ComputerVisibility, ComputerVolumes, Computers, type ConnectorApplicableDefaultParams, type ConnectorCreateParams, type ConnectorData, type ConnectorDefault, type ConnectorDefaultListParams, type ConnectorDefaultParams, type ConnectorListParams, type ConnectorSubject, type ConnectorTokenParams, type ConnectorTokenResponse, Connectors, type CopyParams, type CreateAdminApiKeyParams, type CreateAgentBuildPacketParams, type CreateBuildRunParams, type CreateOrgInviteParams, type CreateWorkspaceInviteParams, type CreateWorkspaceInviteResponse, type CreditBalance, type CreditTransaction, type CreditTransactionListResponse, type CreditUsage, Credits, type CronJobCreateParams, type CronJobData, type CronJobExecutionData, type CronJobExecutionId, type CronJobId, type CronJobListParams, type CronJobUpdateParams, CronJobs, type CursorInfo, type CustomDomainCreateParams, type CustomDomainData, type CustomDomainId, type CustomDomainListParams, DEFAULT_AGENT_BUILD_OUTPUT_ROOT, DEFAULT_AGENT_BUILD_PACKET_VERSION, Dashboard, type DashboardSummary, type DatabaseCreateParams, type DatabaseCredentials, type DatabaseData, type DatabaseId, type DatabaseListParams, type DatabaseLogsParams, type DatabaseLogsResult, Databases, type DeploymentBuildData, DeploymentConnectors, type DeploymentCreateParams, type DeploymentData, DeploymentDomains, type DeploymentId, type DeploymentListParams, type DeploymentProduct, type DeploymentProofCheck, type DeploymentProofParams, type DeploymentProofProbe, type DeploymentProofResult, type DeploymentReleaseData, type DeploymentReleaseId, DeploymentReleases, DeploymentRuntimeInstances, type DeploymentServiceData, type DeploymentServiceId, type DeploymentServiceType, type DeploymentSourceType, type DeploymentState, type DeploymentUpdateParams, type DeploymentVersionData, type DeploymentVersionId, type DeploymentVersionKind, type DeploymentVersionState, DeploymentVersions, Deployments, Desktop$1 as Desktop, type DesktopActionResult, type DeviceBootstrapParams, type DeviceBootstrapResult, type DeviceBrowserResult, type DeviceCapabilities, type DeviceData, type DeviceExecParams, type DeviceExecResult, type DeviceExposeParams, type DeviceExposeResult, type DeviceExtendParams, type DeviceFileEntry, type DeviceFileListParams, type DeviceKind, type DeviceLifecycleResult, type DeviceListParams, type DeviceReadFileParams, type DeviceReadFileResult, type DeviceWriteFileParams, type DeviceWriteFileResult, Devices, type DirEntry, type DirListResult, type DiscordSendTestParams, DockerDeploy, type DockerDeployApplianceStatus, type DockerDeployCreateParams, type DockerDeployDoctorCheck, type DockerDeployDoctorParams, type DockerDeployDoctorProbe, type DockerDeployDoctorResult, type DockerDeployHostData, type DockerDeployHostEnsureParams, type DockerDeployHostId, type DockerDeployHostListParams, type DockerDeployHostListResponse, type DockerDeployHostResponse, type DockerDeployHostStatus, type DoubleClickParams, type DragParams, type EgressAllowlistRule, EgressAudit, type EgressAuditEvent, type EgressBindingData, EgressHostNotAllowedError, EgressNetwork, type EgressPolicyData, type EgressPolicyMode, type EgressRuleEffect, type EgressSecretData, type EgressSecretScope, type EgressSecretType, EgressSecrets, type EgressSuggestion, Email, EmailCampaigns, EmailInbox, EmailTemplates, type EmbeddingCreateParams, Embeddings, Exec, type ExecParams, type ExecPythonParams, type ExecResult, type ExternalAttribution, type ExternalKeyCreateParams, type ExternalKeyData, ExternalKeys, type FileDeleteParams, type FileDownloadParams, type FileEntry, type FileExportParams, type FileExportResult, type FileListParams, type FileListResult, type FileStat, Files, FlatCustomDomains, type FsEntry, type FsListResponse, type FsStat, type FunctionCreateParams, type FunctionData, type FunctionId, type FunctionInvokeParams, type FunctionListParams, type FunctionUpdateParams, Functions, type GithubRepo, type GithubSshKey, type HealthCheckCreateParams, type HealthCheckData, type HealthCheckId, type HealthCheckListParams, type HealthCheckUpdateParams, HealthChecks, type HostCreateParams, type HostData, type HostEvent, type HostId, type HostListResponse, type HostStatus, type HostUpdateParams, InstallationRequiredError, InsufficientCreditsError, type IntegrationCatalogEntry, type IntegrationData, Integrations, type JobData, type JobEvent, type JobEventType, type JobId, type JobListResponse, type JobRunParams, type JobStatus, type KeyParams, type LaunchParams, type LinearCreateIssueParams, type ListAdminApiKeysParams, type ListAdminComputersParams, type ListAdminTenantsParams, type ListAdminUsersParams, ManagedProviderBindingOnlyError, Mcp, type McpDispatchParams, Miosa, type MiosaClientConfig, MiosaError, type MiosaErrorBody, type MkdirParams, type ModeParams, Models, type MouseButton, NetworkError, NetworkPolicy, type NetworkPolicyData, type NetworkPolicyEffect, type NetworkPolicyProtocol, type NetworkPolicyRule, type NetworkPolicySetParams, NotFoundError, type NotificationPrefsUpdateParams, OAuthFlow, type OauthConnectParams, type OauthProvider, type OauthStartResult, type OauthStatusResult, type ObjectListParams, type AgentEvent as OcAgentEvent, type OcAgentSessionData, type AgentSessionListResponse as OcAgentSessionListResponse, type OcWorkspaceCreateParams, type OcWorkspaceData, type OcWorkspaceEvent, type OcWorkspaceListResponse, type OcWorkspaceStatus, type OcWorkspaceUpdateParams, OpenComputers, type OrgInvite, type OrgInviteCreated, type OrgInviteCreatedResponse, type OrgInviteListResponse, type OrgInvitePreview, type OrgInviteRevokeResponse, OrgInvites, type OrgRole, type OrganizationMember, type OrganizationMemberList, type OrganizationMemberRemoved, OrganizationMembers, type OrganizationRole, type OrganizationSummary, type OrganizationSwitchResult, Organizations, type OverviewData, type PolicyCreateParams, type PolicyListParams, type PolicyUpdateParams, type PresignParams, type PresignResult, type PreviewDomainData, type ProductCatalogEntry, type ProductTemplate, type ProductTemplateCatalog, ProjectAuth, type ProjectAuthEnableParams, type ProjectAuthStatus, type ProjectAuthUpdateParams, type ProjectIntegrationCatalogEntry, type ProjectIntegrationCreateParams, type ProjectIntegrationData, type ProjectIntegrationListParams, type ProjectIntegrationUpdateParams, ProjectIntegrations, ProjectNotLinkedError, ProviderDefaults, type ProviderKeyUpsertParams, type PublishFromSandboxParams, type PublishParams, type PublishResult, RateLimitError, type RegionData, Regions, type RollbackParams, type RulesListParams, type Run, type RunActivity, type RunCommandOutput, type RunCreateParams, type RunDiagnostic, type RunDownload, type RunFile, type RunGroup, type RunGroupActivity, type RunGroupCounts, type RunGroupCreateParams, type RunGroupDispatchEntry, type RunGroupDispatchResult, type RunGroupFile, type RunGroupListParams, type RunGroupStatus, type RunGroupWaitOptions, RunGroups, type RunListParams, type RunMessage, type RunOutputs, type RunPreview, type RunStatus, type RunTargetKind, type RunWaitOptions, Runs, type RuntimeCapabilities, RuntimeCapabilitiesResource, RuntimeEnv, type RuntimeEnvListParams, type RuntimeEnvScope, type RuntimeEnvSetParams, type RuntimeEnvTarget, type RuntimeEnvVar, type RuntimeInstanceData, type RuntimeInstanceId, type RuntimeInstanceState, type RuntimeLogsResult, SANDBOX_TEMPLATE, Sandbox, SandboxAudit, type SandboxBuildSpec, type SandboxBuildSpecError, type SandboxBuildSpecValidation, SandboxCommands, type SandboxConnectorAttachParams, type SandboxConnectorBinding, type SandboxConnectorPreflightParams, type SandboxConnectorPreflightResult, SandboxConnectors, type SandboxCreateParams, type SandboxData, SandboxEnv, SandboxEvents, type SandboxExecEvent, type SandboxExecOptions, type SandboxExecResult, type SandboxExecRunner, SandboxFiles, type SandboxGetOrCreateParams, type SandboxId, type SandboxListParams, SandboxNetwork, SandboxPreview, SandboxPreviews, SandboxSecrets, type SandboxState, SandboxTags, type SandboxTemplate, type SandboxTemplateBuild, type SandboxTemplateBuildCreateParams, type SandboxTemplateBuildResourceData, type SandboxTemplateBuildResourceId, type SandboxTemplateCreateParams, type SandboxTemplateList, type SandboxTemplateListParams, type SandboxTemplateResourceData, type SandboxTemplateResourceId, SandboxTemplates, SandboxTerminal, Sandboxes, ScopeNotAllowedError, ScopedFs, type ScrollDirection, type ScrollParams, type SecretCreateParams, type SecretData, type SecretId, type SecretListParams, type SecretRotateParams, type SecretSetParams, type SecretUpdateParams, type SessionId, Settings, type SettingsUpdateParams, type SizeData, type SlackSendTestParams, type SnapshotCreateParams, type SnapshotData, type SnapshotListResponse, type SnapshotProgressEvent, type SnapshotRestoreResult, type SnapshotStatus, SnapshotsStandalone, Storage, type StorageObjectData, SubjectNotAllowedError, type SuggestionsParams, type TemplateBenchmarkLane, type TemplateBuildCreateParams, type TemplateCreateParams, type TemplateData, type TemplateReadinessContract, type TemplateReadinessState, type TemplateSizeReadiness, Templates, type TemplatesListParams, Tenant, type TenantBrandingUpdateParams, type TenantId, type TenantPlan, type TenantSummary, type TerminalCreateParams, TimeoutError, type TimeseriesParams, TokenRefreshFailedError, type TunnelAuthMode, type TunnelCreateParams, type TunnelData, type TunnelId, type TunnelListResponse, type TunnelUpdateParams, type TypeParams, type UpdateWorkspaceMemberRoleParams, Usage, type UsageReportParams, type UsageSession, type UsageSessionsParams, type UsageSummary, UserAuthorizationRequiredError, type UserId, ValidationError, type VersionListParams, type VolumeAttachParams, type VolumeAttachmentData, type VolumeCreateParams, type VolumeData, type VolumeId, type VolumeListParams, Volumes, type WaitParams, type WebhookCreateParams, type WebhookData, type WebhookDeliveryData, type WebhookDeliveryId, type WebhookId, type WebhookListParams, type WebhookUpdateParams, Webhooks, type WindowFocusParams, type WindowInfo, type WorkspaceId, type WorkspaceInvite, type WorkspaceInviteCreatedResponse, type WorkspaceInviteListResponse, type WorkspaceInvitePreview, type WorkspaceInviteRevokeResponse, WorkspaceInvites, type WorkspaceMember, type WorkspaceMemberAddedResponse, type WorkspaceMemberDeleteResponse, type WorkspaceMemberListResponse, type WorkspaceMemberRecord, type WorkspaceMemberRecordResponse, WorkspaceMembers, type WorkspaceRole, type WsTicket, createAgentBuildExecutionPacket, createAgentBuildExpectedOutputs, createAgentBuildPrompt, createBuildRunParams, getAgentBuildKindSpec, resolveAgentBuildKind, verifySignature };