@openkaiden/opnshll-sdk 0.0.110 → 0.0.113

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.
@@ -362,6 +362,20 @@ export type SandboxSpec = Message<"openshell.v1.SandboxSpec"> & {
362
362
  * @generated from field: openshell.v1.ResourceRequirements resource_requirements = 9;
363
363
  */
364
364
  resourceRequirements?: ResourceRequirements | undefined;
365
+ /**
366
+ * Canonical command launched once by the sandbox supervisor. No shell
367
+ * parsing is performed. The gateway normalizes an omitted command to the
368
+ * portable scratch login shell before persistence.
369
+ *
370
+ * @generated from field: repeated string command = 12;
371
+ */
372
+ command: string[];
373
+ /**
374
+ * Allocate a retained pseudo-terminal for the main process.
375
+ *
376
+ * @generated from field: bool tty = 13;
377
+ */
378
+ tty: boolean;
365
379
  };
366
380
  /**
367
381
  * Describes the message openshell.v1.SandboxSpec.
@@ -532,6 +546,20 @@ export type SandboxStatus = Message<"openshell.v1.SandboxStatus"> & {
532
546
  * @generated from field: uint32 current_policy_version = 7;
533
547
  */
534
548
  currentPolicyVersion: number;
549
+ /**
550
+ * Supervisor instance currently associated with the canonical main process.
551
+ * The gateway uses this to reject stale exit reports after a restart.
552
+ *
553
+ * @generated from field: string main_process_instance_id = 8;
554
+ */
555
+ mainProcessInstanceId: string;
556
+ /**
557
+ * Normalized main process result. Signal exits use 128 + signal number.
558
+ * Presence indicates that the main process exited and the sandbox is in Error.
559
+ *
560
+ * @generated from field: optional int32 exit_code = 9;
561
+ */
562
+ exitCode?: number | undefined;
535
563
  };
536
564
  /**
537
565
  * Describes the message openshell.v1.SandboxStatus.
@@ -2224,9 +2252,36 @@ export type ProviderCredentialTokenGrantAudienceOverride = Message<"openshell.v1
2224
2252
  */
2225
2253
  export declare const ProviderCredentialTokenGrantAudienceOverrideSchema: GenMessage<ProviderCredentialTokenGrantAudienceOverride>;
2226
2254
  /**
2227
- * Provider credential token grant configuration.
2228
- * When present, the credential is obtained dynamically via OAuth2 grant when needed.
2229
- *
2255
+ * @generated from message openshell.v1.ProviderCredentialTokenGrantSubjectToken
2256
+ */
2257
+ export type ProviderCredentialTokenGrantSubjectToken = Message<"openshell.v1.ProviderCredentialTokenGrantSubjectToken"> & {
2258
+ /**
2259
+ * Source for the token exchange subject token. Phase one supports
2260
+ * "provider_credential".
2261
+ *
2262
+ * @generated from field: string source = 1;
2263
+ */
2264
+ source: string;
2265
+ /**
2266
+ * Provider credential key that stores the subject token.
2267
+ *
2268
+ * @generated from field: string credential = 2;
2269
+ */
2270
+ credential: string;
2271
+ /**
2272
+ * OAuth2 subject_token_type. If omitted, OpenShell uses
2273
+ * urn:ietf:params:oauth:token-type:access_token.
2274
+ *
2275
+ * @generated from field: string subject_token_type = 3;
2276
+ */
2277
+ subjectTokenType: string;
2278
+ };
2279
+ /**
2280
+ * Describes the message openshell.v1.ProviderCredentialTokenGrantSubjectToken.
2281
+ * Use `create(ProviderCredentialTokenGrantSubjectTokenSchema)` to create a new message.
2282
+ */
2283
+ export declare const ProviderCredentialTokenGrantSubjectTokenSchema: GenMessage<ProviderCredentialTokenGrantSubjectToken>;
2284
+ /**
2230
2285
  * @generated from message openshell.v1.ProviderCredentialTokenGrant
2231
2286
  */
2232
2287
  export type ProviderCredentialTokenGrant = Message<"openshell.v1.ProviderCredentialTokenGrant"> & {
@@ -2275,6 +2330,26 @@ export type ProviderCredentialTokenGrant = Message<"openshell.v1.ProviderCredent
2275
2330
  * @generated from field: string client_assertion_type = 7;
2276
2331
  */
2277
2332
  clientAssertionType: string;
2333
+ /**
2334
+ * Grant type. If omitted/unspecified, OpenShell treats this as client_credentials
2335
+ * for backwards compatibility.
2336
+ *
2337
+ * @generated from field: openshell.v1.ProviderCredentialTokenGrantType grant_type = 8;
2338
+ */
2339
+ grantType: ProviderCredentialTokenGrantType;
2340
+ /**
2341
+ * Subject token metadata for token_exchange grants.
2342
+ *
2343
+ * @generated from field: openshell.v1.ProviderCredentialTokenGrantSubjectToken subject_token = 9;
2344
+ */
2345
+ subjectToken?: ProviderCredentialTokenGrantSubjectToken | undefined;
2346
+ /**
2347
+ * OAuth2 requested_token_type. If omitted for token_exchange, OpenShell uses
2348
+ * urn:ietf:params:oauth:token-type:access_token.
2349
+ *
2350
+ * @generated from field: string requested_token_type = 10;
2351
+ */
2352
+ requestedTokenType: string;
2278
2353
  };
2279
2354
  /**
2280
2355
  * Describes the message openshell.v1.ProviderCredentialTokenGrant.
@@ -3287,6 +3362,63 @@ export type GetSandboxProviderEnvironmentResponse = Message<"openshell.v1.GetSan
3287
3362
  * Use `create(GetSandboxProviderEnvironmentResponseSchema)` to create a new message.
3288
3363
  */
3289
3364
  export declare const GetSandboxProviderEnvironmentResponseSchema: GenMessage<GetSandboxProviderEnvironmentResponse>;
3365
+ /**
3366
+ * @generated from message openshell.v1.ExchangeProviderSubjectTokenRequest
3367
+ */
3368
+ export type ExchangeProviderSubjectTokenRequest = Message<"openshell.v1.ExchangeProviderSubjectTokenRequest"> & {
3369
+ /**
3370
+ * The sandbox ID. Must match the authenticated sandbox principal.
3371
+ *
3372
+ * @generated from field: string sandbox_id = 1;
3373
+ */
3374
+ sandboxId: string;
3375
+ /**
3376
+ * Attached provider record holding the configured subject token credential.
3377
+ *
3378
+ * @generated from field: string provider = 2;
3379
+ */
3380
+ provider: string;
3381
+ /**
3382
+ * Provider profile credential that declares the token_exchange grant.
3383
+ *
3384
+ * @generated from field: string credential_key = 3;
3385
+ */
3386
+ credentialKey: string;
3387
+ /**
3388
+ * Supervisor JWT-SVID. The gateway verifies this and uses its `sub` claim
3389
+ * as the requested audience for the intermediate token.
3390
+ *
3391
+ * @generated from field: string supervisor_jwt_svid = 4;
3392
+ */
3393
+ supervisorJwtSvid: string;
3394
+ };
3395
+ /**
3396
+ * Describes the message openshell.v1.ExchangeProviderSubjectTokenRequest.
3397
+ * Use `create(ExchangeProviderSubjectTokenRequestSchema)` to create a new message.
3398
+ */
3399
+ export declare const ExchangeProviderSubjectTokenRequestSchema: GenMessage<ExchangeProviderSubjectTokenRequest>;
3400
+ /**
3401
+ * @generated from message openshell.v1.ExchangeProviderSubjectTokenResponse
3402
+ */
3403
+ export type ExchangeProviderSubjectTokenResponse = Message<"openshell.v1.ExchangeProviderSubjectTokenResponse"> & {
3404
+ /**
3405
+ * @generated from field: string access_token = 1;
3406
+ */
3407
+ accessToken: string;
3408
+ /**
3409
+ * @generated from field: int64 expires_in = 2;
3410
+ */
3411
+ expiresIn: bigint;
3412
+ /**
3413
+ * @generated from field: string token_type = 3;
3414
+ */
3415
+ tokenType: string;
3416
+ };
3417
+ /**
3418
+ * Describes the message openshell.v1.ExchangeProviderSubjectTokenResponse.
3419
+ * Use `create(ExchangeProviderSubjectTokenResponseSchema)` to create a new message.
3420
+ */
3421
+ export declare const ExchangeProviderSubjectTokenResponseSchema: GenMessage<ExchangeProviderSubjectTokenResponse>;
3290
3422
  /**
3291
3423
  * Update sandbox policy request.
3292
3424
  *
@@ -4102,6 +4234,42 @@ export type GatewayHeartbeat = Message<"openshell.v1.GatewayHeartbeat"> & {};
4102
4234
  * Use `create(GatewayHeartbeatSchema)` to create a new message.
4103
4235
  */
4104
4236
  export declare const GatewayHeartbeatSchema: GenMessage<GatewayHeartbeat>;
4237
+ /**
4238
+ * Terminal result reported before the supervisor shuts down. A successful RPC
4239
+ * response confirms that the result was durably handled by the gateway.
4240
+ *
4241
+ * @generated from message openshell.v1.ReportMainProcessExitRequest
4242
+ */
4243
+ export type ReportMainProcessExitRequest = Message<"openshell.v1.ReportMainProcessExitRequest"> & {
4244
+ /**
4245
+ * @generated from field: string sandbox_id = 1;
4246
+ */
4247
+ sandboxId: string;
4248
+ /**
4249
+ * @generated from field: string instance_id = 2;
4250
+ */
4251
+ instanceId: string;
4252
+ /**
4253
+ * Normalized process result. Signal exits use 128 + signal number.
4254
+ *
4255
+ * @generated from field: int32 exit_code = 3;
4256
+ */
4257
+ exitCode: number;
4258
+ };
4259
+ /**
4260
+ * Describes the message openshell.v1.ReportMainProcessExitRequest.
4261
+ * Use `create(ReportMainProcessExitRequestSchema)` to create a new message.
4262
+ */
4263
+ export declare const ReportMainProcessExitRequestSchema: GenMessage<ReportMainProcessExitRequest>;
4264
+ /**
4265
+ * @generated from message openshell.v1.ReportMainProcessExitResponse
4266
+ */
4267
+ export type ReportMainProcessExitResponse = Message<"openshell.v1.ReportMainProcessExitResponse"> & {};
4268
+ /**
4269
+ * Describes the message openshell.v1.ReportMainProcessExitResponse.
4270
+ * Use `create(ReportMainProcessExitResponseSchema)` to create a new message.
4271
+ */
4272
+ export declare const ReportMainProcessExitResponseSchema: GenMessage<ReportMainProcessExitResponse>;
4105
4273
  /**
4106
4274
  * Gateway requests the supervisor to open a relay channel.
4107
4275
  *
@@ -4618,6 +4786,42 @@ export type PolicyChunk = Message<"openshell.v1.PolicyChunk"> & {
4618
4786
  * @generated from field: string rejection_reason = 18;
4619
4787
  */
4620
4788
  rejectionReason: string;
4789
+ /**
4790
+ * Gateway-side merge/application preflight failure. Kept separate from
4791
+ * prover output and operator rejection so clients can explain why a
4792
+ * prover-clean proposal is not currently applicable.
4793
+ *
4794
+ * @generated from field: string application_error = 19;
4795
+ */
4796
+ applicationError: string;
4797
+ /**
4798
+ * Opaque digest binding review to the exact live inputs and complete
4799
+ * effective candidate evaluated by the gateway.
4800
+ *
4801
+ * @generated from field: string review_token = 20;
4802
+ */
4803
+ reviewToken: string;
4804
+ /**
4805
+ * Deterministic hashes for compact candidate display and diagnostics.
4806
+ *
4807
+ * @generated from field: string current_effective_policy_hash = 21;
4808
+ */
4809
+ currentEffectivePolicyHash: string;
4810
+ /**
4811
+ * @generated from field: string candidate_effective_policy_hash = 22;
4812
+ */
4813
+ candidateEffectivePolicyHash: string;
4814
+ /**
4815
+ * Complete effective policies used for review. These contain policy
4816
+ * configuration only; credential secret values are never materialized.
4817
+ *
4818
+ * @generated from field: openshell.sandbox.v1.SandboxPolicy current_effective_policy = 23;
4819
+ */
4820
+ currentEffectivePolicy?: SandboxPolicy | undefined;
4821
+ /**
4822
+ * @generated from field: openshell.sandbox.v1.SandboxPolicy candidate_effective_policy = 24;
4823
+ */
4824
+ candidateEffectivePolicy?: SandboxPolicy | undefined;
4621
4825
  };
4622
4826
  /**
4623
4827
  * Describes the message openshell.v1.PolicyChunk.
@@ -4838,6 +5042,13 @@ export type ApproveDraftChunkRequest = Message<"openshell.v1.ApproveDraftChunkRe
4838
5042
  * @generated from field: string workspace = 3;
4839
5043
  */
4840
5044
  workspace: string;
5045
+ /**
5046
+ * Token returned with the reviewed PolicyChunk. Approval fails with
5047
+ * FAILED_PRECONDITION if live decision inputs no longer match it.
5048
+ *
5049
+ * @generated from field: string review_token = 4;
5050
+ */
5051
+ reviewToken: string;
4841
5052
  };
4842
5053
  /**
4843
5054
  * Describes the message openshell.v1.ApproveDraftChunkRequest.
@@ -4914,6 +5125,24 @@ export declare const RejectDraftChunkResponseSchema: GenMessage<RejectDraftChunk
4914
5125
  /**
4915
5126
  * Approve all pending chunks.
4916
5127
  *
5128
+ * @generated from message openshell.v1.DraftChunkApproval
5129
+ */
5130
+ export type DraftChunkApproval = Message<"openshell.v1.DraftChunkApproval"> & {
5131
+ /**
5132
+ * @generated from field: string chunk_id = 1;
5133
+ */
5134
+ chunkId: string;
5135
+ /**
5136
+ * @generated from field: string review_token = 2;
5137
+ */
5138
+ reviewToken: string;
5139
+ };
5140
+ /**
5141
+ * Describes the message openshell.v1.DraftChunkApproval.
5142
+ * Use `create(DraftChunkApprovalSchema)` to create a new message.
5143
+ */
5144
+ export declare const DraftChunkApprovalSchema: GenMessage<DraftChunkApproval>;
5145
+ /**
4917
5146
  * @generated from message openshell.v1.ApproveAllDraftChunksRequest
4918
5147
  */
4919
5148
  export type ApproveAllDraftChunksRequest = Message<"openshell.v1.ApproveAllDraftChunksRequest"> & {
@@ -4935,6 +5164,13 @@ export type ApproveAllDraftChunksRequest = Message<"openshell.v1.ApproveAllDraft
4935
5164
  * @generated from field: string workspace = 3;
4936
5165
  */
4937
5166
  workspace: string;
5167
+ /**
5168
+ * Exact reviewed chunks and tokens. The server validates them against one
5169
+ * live snapshot, stages compatible operations in order, and writes once.
5170
+ *
5171
+ * @generated from field: repeated openshell.v1.DraftChunkApproval approvals = 4;
5172
+ */
5173
+ approvals: DraftChunkApproval[];
4938
5174
  };
4939
5175
  /**
4940
5176
  * Describes the message openshell.v1.ApproveAllDraftChunksRequest.
@@ -4964,7 +5200,8 @@ export type ApproveAllDraftChunksResponse = Message<"openshell.v1.ApproveAllDraf
4964
5200
  */
4965
5201
  chunksApproved: number;
4966
5202
  /**
4967
- * Number of chunks skipped (security-flagged).
5203
+ * Number of chunks skipped for any reason, including security flags,
5204
+ * stale or invalid candidates, and conflicts within the staged batch.
4968
5205
  *
4969
5206
  * @generated from field: uint32 chunks_skipped = 4;
4970
5207
  */
@@ -5311,6 +5548,30 @@ export type DraftChunkPayload = Message<"openshell.v1.DraftChunkPayload"> & {
5311
5548
  * @generated from field: string rejection_reason = 12;
5312
5549
  */
5313
5550
  rejectionReason: string;
5551
+ /**
5552
+ * @generated from field: string application_error = 13;
5553
+ */
5554
+ applicationError: string;
5555
+ /**
5556
+ * @generated from field: string review_token = 14;
5557
+ */
5558
+ reviewToken: string;
5559
+ /**
5560
+ * @generated from field: string current_effective_policy_hash = 15;
5561
+ */
5562
+ currentEffectivePolicyHash: string;
5563
+ /**
5564
+ * @generated from field: string candidate_effective_policy_hash = 16;
5565
+ */
5566
+ candidateEffectivePolicyHash: string;
5567
+ /**
5568
+ * @generated from field: openshell.sandbox.v1.SandboxPolicy current_effective_policy = 17;
5569
+ */
5570
+ currentEffectivePolicy?: SandboxPolicy | undefined;
5571
+ /**
5572
+ * @generated from field: openshell.sandbox.v1.SandboxPolicy candidate_effective_policy = 18;
5573
+ */
5574
+ candidateEffectivePolicy?: SandboxPolicy | undefined;
5314
5575
  };
5315
5576
  /**
5316
5577
  * Describes the message openshell.v1.DraftChunkPayload.
@@ -5457,6 +5718,30 @@ export type StoredDraftChunk = Message<"openshell.v1.StoredDraftChunk"> & {
5457
5718
  * @generated from field: string rejection_reason = 19;
5458
5719
  */
5459
5720
  rejectionReason: string;
5721
+ /**
5722
+ * @generated from field: string application_error = 20;
5723
+ */
5724
+ applicationError: string;
5725
+ /**
5726
+ * @generated from field: string review_token = 21;
5727
+ */
5728
+ reviewToken: string;
5729
+ /**
5730
+ * @generated from field: string current_effective_policy_hash = 22;
5731
+ */
5732
+ currentEffectivePolicyHash: string;
5733
+ /**
5734
+ * @generated from field: string candidate_effective_policy_hash = 23;
5735
+ */
5736
+ candidateEffectivePolicyHash: string;
5737
+ /**
5738
+ * @generated from field: openshell.sandbox.v1.SandboxPolicy current_effective_policy = 24;
5739
+ */
5740
+ currentEffectivePolicy?: SandboxPolicy | undefined;
5741
+ /**
5742
+ * @generated from field: openshell.sandbox.v1.SandboxPolicy candidate_effective_policy = 25;
5743
+ */
5744
+ candidateEffectivePolicy?: SandboxPolicy | undefined;
5460
5745
  };
5461
5746
  /**
5462
5747
  * Describes the message openshell.v1.StoredDraftChunk.
@@ -5854,6 +6139,30 @@ export declare enum SandboxPhase {
5854
6139
  * Describes the enum openshell.v1.SandboxPhase.
5855
6140
  */
5856
6141
  export declare const SandboxPhaseSchema: GenEnum<SandboxPhase>;
6142
+ /**
6143
+ * Provider credential token grant configuration.
6144
+ * When present, the credential is obtained dynamically via OAuth2 grant when needed.
6145
+ *
6146
+ * @generated from enum openshell.v1.ProviderCredentialTokenGrantType
6147
+ */
6148
+ export declare enum ProviderCredentialTokenGrantType {
6149
+ /**
6150
+ * @generated from enum value: PROVIDER_CREDENTIAL_TOKEN_GRANT_TYPE_UNSPECIFIED = 0;
6151
+ */
6152
+ UNSPECIFIED = 0,
6153
+ /**
6154
+ * @generated from enum value: PROVIDER_CREDENTIAL_TOKEN_GRANT_TYPE_CLIENT_CREDENTIALS = 1;
6155
+ */
6156
+ CLIENT_CREDENTIALS = 1,
6157
+ /**
6158
+ * @generated from enum value: PROVIDER_CREDENTIAL_TOKEN_GRANT_TYPE_TOKEN_EXCHANGE = 2;
6159
+ */
6160
+ TOKEN_EXCHANGE = 2
6161
+ }
6162
+ /**
6163
+ * Describes the enum openshell.v1.ProviderCredentialTokenGrantType.
6164
+ */
6165
+ export declare const ProviderCredentialTokenGrantTypeSchema: GenEnum<ProviderCredentialTokenGrantType>;
5857
6166
  /**
5858
6167
  * @generated from enum openshell.v1.ProviderCredentialRefreshStrategy
5859
6168
  */
@@ -6475,6 +6784,17 @@ export declare const OpenShell: GenService<{
6475
6784
  input: typeof GetSandboxProviderEnvironmentRequestSchema;
6476
6785
  output: typeof GetSandboxProviderEnvironmentResponseSchema;
6477
6786
  };
6787
+ /**
6788
+ * Exchange a stored provider subject token for an intermediate token scoped
6789
+ * to the calling supervisor's SPIFFE identity.
6790
+ *
6791
+ * @generated from rpc openshell.v1.OpenShell.ExchangeProviderSubjectToken
6792
+ */
6793
+ exchangeProviderSubjectToken: {
6794
+ methodKind: "unary";
6795
+ input: typeof ExchangeProviderSubjectTokenRequestSchema;
6796
+ output: typeof ExchangeProviderSubjectTokenResponseSchema;
6797
+ };
6478
6798
  /**
6479
6799
  * Fetch recent sandbox logs (one-shot).
6480
6800
  *
@@ -6511,6 +6831,16 @@ export declare const OpenShell: GenService<{
6511
6831
  input: typeof SupervisorMessageSchema;
6512
6832
  output: typeof GatewayMessageSchema;
6513
6833
  };
6834
+ /**
6835
+ * Persist the canonical main process result before the supervisor exits.
6836
+ *
6837
+ * @generated from rpc openshell.v1.OpenShell.ReportMainProcessExit
6838
+ */
6839
+ reportMainProcessExit: {
6840
+ methodKind: "unary";
6841
+ input: typeof ReportMainProcessExitRequestSchema;
6842
+ output: typeof ReportMainProcessExitResponseSchema;
6843
+ };
6514
6844
  /**
6515
6845
  * Raw byte relay between supervisor and gateway.
6516
6846
  *