@orchestraworks/cli 0.5.1 → 0.5.3

package/dist/generated/managed-skills.d.ts

@@ -0,0 +1,2 @@
+/** The ids of the skills the platform manages, which the kit adds to each agent's skills at synth. */
+export declare const MANAGED_SKILL_IDS: readonly string[];

package/dist/generated/managed-skills.js

@@ -0,0 +1,13 @@
+// GENERATED — do not edit; run node scripts/generate-catalog-skills.mjs
+//
+// Source: PlatformSkillDefinition.declared in the platform, the skills every stack serves.
+/** The ids of the skills the platform manages, which the kit adds to each agent's skills at synth. */
+export const MANAGED_SKILL_IDS = Object.freeze([
+    "skill_artifacts",
+    "skill_code-review",
+    "skill_visualize",
+    "skill_assessment",
+    "skill_bug-fixing",
+    "skill_feature-development",
+    "skill_progress-report",
+]);

package/dist/index.d.ts

@@ -29,7 +29,7 @@ export type { GatewayKeyProps } from "./constructs/gateway-key.js";
 export { ModelProviderKey } from "./constructs/model-provider-key.js";
 export type { ModelProviderKeyProps } from "./constructs/model-provider-key.js";
 export { EgressPolicy, Environment, basic, bearer, header, inject, } from "./constructs/environment.js";
-export type { AllowConnectionOptions, DenyRuleOptions, DiskMount, EnvironmentProps, IngressEndpoint, PlatformSpec, ResourceSpec, RouteModelsViaGatewayOptions, VolumeMount, } from "./constructs/environment.js";
+export type { AllowConnectionOptions, DenyRuleOptions, DiskMount, EnvironmentHook, EnvironmentHooks, EnvironmentProps, IngressEndpoint, PlatformSpec, ResourceSpec, RouteModelsViaGatewayOptions, VolumeMount, } from "./constructs/environment.js";
 export { egressPreset } from "./constructs/egress-preset.js";
 export type { EgressRuleBundle, PresetRule } from "./constructs/egress-preset.js";
 export { Agent } from "./constructs/agent.js";

package/docs/REFERENCE.md

@@ -188,7 +188,7 @@ fitting a starter to your codebase.
 ### Start from another starter: `orchestra fdk init --template <name>`
 
 The kit carries more than one starter. `engineering-team` is a factory for one engineering team: a Manager
-Agent and Engineer Agents sm, md and lg, their machines, and four pipelines. A starter other than `bug-fix`
+Agent and Engineer Agents sm, md and lg, their machines, and three pipelines. A starter other than `bug-fix`
 brings its own `package.json`, so run it in a new, empty folder, with nothing installed:
 
 ```bash
@@ -1109,6 +1109,25 @@ and polls until the grant activates — you finish it in your own signed-in brow
 what the platform's authenticated callback requires. `--timeout 0` mints and prints without waiting. Grants
 carry lifecycle metadata only; no surface ever reads the credential back.
 
+### Check a Launcher (`orchestra compute-providers check`)
+
+A Launcher is the program that runs machines in your own cloud. It polls the platform once a second
+for its compute provider record. When it does not run machines, run this command first:
+
+```bash
+orchestra compute-providers check azure-east
+```
+
+The command reads the record once. It shows the record's name and state (`connected`, `silent` or
+`never_connected`), the last poll time and its age, the protocol version and any protocol refusal,
+the health counts (orders held, cloud errors, reports pending), and each target with `passed` or
+the reason the platform refused it. A target whose self-check failed shows the cloud's message.
+
+The exit code is 0 when the Launcher polls, its protocol was accepted, and every target passed.
+Otherwise it is 1, and stderr has one line that names each failure, so a script can wait on it.
+`--output json` prints the record as the platform returns it. A managed provider has no Launcher,
+so the command exits 0.
+
 ### Chat presence (Slack and Microsoft Teams)
 
 There is **no chat construct** — the `Channel` construct was removed, because the orchestra convention is
@@ -1244,6 +1263,7 @@ every derived slug (factory name + construct path) must stay ≤ 60 chars, so ke
 | **401 / 403** | The token lacks access to the resolved org, or it expired and could not be renewed. A profile from a browser `login` renews itself silently, so a 401 that survives that means the renewal credential is gone too — re-run `orchestra auth login`. A pasted or exported token has no renewal path at all: replace it, or fix `ORCHESTRA_ORGANIZATION_ID`. |
 | **"the platform rejected the stored refresh credential… Run `orchestra auth login` to sign in again."** | The stored renewal credential was refused (revoked, expired, or a sibling process already rotated past it). Nothing on disk is changed by that failure, so re-running `orchestra auth login` is the whole remedy. A *retryable* failure — the platform unreachable, timing out, or answering `temporarily_unavailable` — reports itself as such and never tells you to log in again; run the command again. |
 | **`ERR_PACKAGE_PATH_NOT_EXPORTED` at first import** | The factory program's own `package.json` is missing `"type": "module"` (a fresh `npm init -y` defaults to CommonJS). orchestra is ESM-only — its `exports` map defines only an `import` condition — so add `"type": "module"` to the factory `package.json` (see §4). |
+| **A Launcher runs no machines** | Run `orchestra compute-providers check <id-or-slug>` (§7). It names what failed: no poll for 60 seconds, a refused protocol version, or a target the platform refused, with the reason. |
 | **Import 404** | The referenced slug/id isn't visible in the resolved org. Check the org and the reference. |
 | **"refusing to send secrets over plain HTTP to non-loopback host …"** | A secret write needs TLS. Use an `https://` base URL; only loopback (`127.0.0.1`/`localhost`/`::1`) dev stacks may use `http://`. |
 | **`tsc` error on `target: Targets.…({ binding })`** | The binding is scoped to events the trigger does not fully select (its field is absent from one payload shape). Split into per-shape triggers sharing one binding constant and one anchor (the composition pattern), or author a binding valid for the whole selection. |

package/node_modules/@orchestraworks/client/dist/esm/models/ApiKey.d.ts

@@ -45,6 +45,12 @@ export interface ApiKey {
      * @memberof ApiKey
      */
     lastUsedAt?: Date;
+    /**
+     * When the key stops signing its principal in, fixed at create; absent when it never expires
+     * @type {Date}
+     * @memberof ApiKey
+     */
+    expiresAt?: Date;
     /**
      * Creation timestamp
      * @type {Date}

package/node_modules/@orchestraworks/client/dist/esm/models/ApiKey.js

@@ -50,6 +50,7 @@ export function ApiKeyFromJSONTyped(json, ignoreDiscriminator) {
         'principalId': json['principalId'],
         'name': json['name'],
         'lastUsedAt': json['lastUsedAt'] == null ? undefined : (new Date(json['lastUsedAt'])),
+        'expiresAt': json['expiresAt'] == null ? undefined : (new Date(json['expiresAt'])),
         'createdAt': (new Date(json['createdAt'])),
         'updatedAt': (new Date(json['updatedAt'])),
     };
@@ -67,6 +68,7 @@ export function ApiKeyToJSONTyped(value, ignoreDiscriminator = false) {
         'principalId': value['principalId'],
         'name': value['name'],
         'lastUsedAt': value['lastUsedAt'] == null ? value['lastUsedAt'] : value['lastUsedAt'].toISOString(),
+        'expiresAt': value['expiresAt'] == null ? value['expiresAt'] : value['expiresAt'].toISOString(),
         'createdAt': value['createdAt'].toISOString(),
         'updatedAt': value['updatedAt'].toISOString(),
     };

package/node_modules/@orchestraworks/client/dist/esm/models/ComputeProvider.d.ts

@@ -20,7 +20,7 @@ import type { ComputeProviderHealth } from './ComputeProviderHealth';
  */
 export interface ComputeProvider {
     /**
-     * Compute provider id: a self-hosted record's TypeID, or a managed provider's key
+     * Compute provider id: a self-hosted record's TypeID, or cprov_orchestra for the managed provider
      * @type {string}
      * @memberof ComputeProvider
      */
@@ -32,7 +32,7 @@ export interface ComputeProvider {
      */
     kind: ComputeProviderKindEnum;
     /**
-     * A self-hosted record's slug, fixed at create
+     * A self-hosted record's slug, fixed at create, or orchestra for the managed provider
      * @type {string}
      * @memberof ComputeProvider
      */
@@ -92,7 +92,7 @@ export interface ComputeProvider {
      */
     state?: ComputeProviderStateEnum;
     /**
-     * The operating systems and architectures a managed provider runs
+     * The operating systems and architectures the managed provider runs
      * @type {Array<EnvironmentPlatform>}
      * @memberof ComputeProvider
      */

package/node_modules/@orchestraworks/client/dist/esm/models/CreateApiKeyRequest.d.ts

@@ -16,7 +16,7 @@
  */
 export interface CreateApiKeyRequest {
     /**
-     * The type of the principal the key signs in. A key of a type that cannot sign in yet is refused 403; today a service account's key alone signs in
+     * The type of the principal the key signs in. A key of a type that cannot sign in is refused 403; a person's key and a service account's key sign in, and an agent's does not
      * @type {CreateApiKeyRequestPrincipalTypeEnum}
      * @memberof CreateApiKeyRequest
      */
@@ -33,6 +33,12 @@ export interface CreateApiKeyRequest {
      * @memberof CreateApiKeyRequest
      */
     name: string;
+    /**
+     * When the key stops signing its principal in, after the request's time and fixed at create; absent means the key never expires
+     * @type {Date}
+     * @memberof CreateApiKeyRequest
+     */
+    expiresAt?: Date;
 }
 /**
  * @export

package/node_modules/@orchestraworks/client/dist/esm/models/CreateApiKeyRequest.js

@@ -42,6 +42,7 @@ export function CreateApiKeyRequestFromJSONTyped(json, ignoreDiscriminator) {
         'principalType': json['principalType'],
         'principalId': json['principalId'],
         'name': json['name'],
+        'expiresAt': json['expiresAt'] == null ? undefined : (new Date(json['expiresAt'])),
     };
 }
 export function CreateApiKeyRequestToJSON(json) {
@@ -55,5 +56,6 @@ export function CreateApiKeyRequestToJSONTyped(value, ignoreDiscriminator = fals
         'principalType': value['principalType'],
         'principalId': value['principalId'],
         'name': value['name'],
+        'expiresAt': value['expiresAt'] == null ? value['expiresAt'] : value['expiresAt'].toISOString(),
     };
 }

package/node_modules/@orchestraworks/client/dist/esm/models/CreateEnvironmentRequest.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { EnvironmentIngressPolicy } from './EnvironmentIngressPolicy';
+import type { EnvironmentHooks } from './EnvironmentHooks';
 import type { EnvironmentPlatformRequest } from './EnvironmentPlatformRequest';
 import type { EnvironmentEgressPolicy } from './EnvironmentEgressPolicy';
 import type { EnvironmentProvisionSpecRequest } from './EnvironmentProvisionSpecRequest';
@@ -67,6 +68,18 @@ export interface CreateEnvironmentRequest {
      * @memberof CreateEnvironmentRequest
      */
     projectId?: string;
+    /**
+     * The absolute folder every conversation's agent starts in, on every kind: a path starting with / on linux and macos, and a drive or UNC path on windows, at most 1024 characters. A machine keeps the value it was created with. The worker creates the folder when it is missing, owned by the account the agent runs as, and an agent placement whose folder cannot be created or entered fails. Absent, the agent starts in the worker's own folder for its harness. An empty value declares none.
+     * @type {string}
+     * @memberof CreateEnvironmentRequest
+     */
+    workingDirectory?: string;
+    /**
+     * Scripts the worker runs at points of a machine's and an agent's life. onStartMachine and onStartAgent are built; onStartSession, onStopSession, onStopAgent and onStopMachine are reserved.
+     * @type {EnvironmentHooks}
+     * @memberof CreateEnvironmentRequest
+     */
+    hooks?: EnvironmentHooks;
     /**
      * Labels: the customer's key-to-value tags; the platform reads no key
      * @type {{ [key: string]: string; }}

package/node_modules/@orchestraworks/client/dist/esm/models/CreateEnvironmentRequest.js

@@ -12,6 +12,7 @@
  * Do not edit the class manually.
  */
 import { EnvironmentIngressPolicyFromJSON, EnvironmentIngressPolicyToJSON, } from './EnvironmentIngressPolicy';
+import { EnvironmentHooksFromJSON, EnvironmentHooksToJSON, } from './EnvironmentHooks';
 import { EnvironmentPlatformRequestFromJSON, EnvironmentPlatformRequestToJSON, } from './EnvironmentPlatformRequest';
 import { EnvironmentEgressPolicyFromJSON, EnvironmentEgressPolicyToJSON, } from './EnvironmentEgressPolicy';
 import { EnvironmentProvisionSpecRequestFromJSON, EnvironmentProvisionSpecRequestToJSON, } from './EnvironmentProvisionSpecRequest';
@@ -46,6 +47,8 @@ export function CreateEnvironmentRequestFromJSONTyped(json, ignoreDiscriminator)
         'kind': json['kind'] == null ? undefined : json['kind'],
         'provisionSpec': json['provisionSpec'] == null ? undefined : EnvironmentProvisionSpecRequestFromJSON(json['provisionSpec']),
         'projectId': json['projectId'] == null ? undefined : json['projectId'],
+        'workingDirectory': json['workingDirectory'] == null ? undefined : json['workingDirectory'],
+        'hooks': json['hooks'] == null ? undefined : EnvironmentHooksFromJSON(json['hooks']),
         'labels': json['labels'] == null ? undefined : json['labels'],
     };
 }
@@ -65,6 +68,8 @@ export function CreateEnvironmentRequestToJSONTyped(value, ignoreDiscriminator =
         'kind': value['kind'],
         'provisionSpec': EnvironmentProvisionSpecRequestToJSON(value['provisionSpec']),
         'projectId': value['projectId'],
+        'workingDirectory': value['workingDirectory'],
+        'hooks': EnvironmentHooksToJSON(value['hooks']),
         'labels': value['labels'],
     };
 }

package/node_modules/@orchestraworks/client/dist/esm/models/Environment.d.ts

@@ -11,6 +11,7 @@
  */
 import type { EnvironmentIngressPolicy } from './EnvironmentIngressPolicy';
 import type { EnvironmentPlatformWithRuntime } from './EnvironmentPlatformWithRuntime';
+import type { EnvironmentHooks } from './EnvironmentHooks';
 import type { EnvironmentEgressPolicy } from './EnvironmentEgressPolicy';
 import type { EnvironmentProvisionSpec } from './EnvironmentProvisionSpec';
 /**
@@ -79,6 +80,18 @@ export interface Environment {
      * @memberof Environment
      */
     provisionSpec?: EnvironmentProvisionSpec;
+    /**
+     * The absolute folder every conversation's agent starts in, on every kind: a path starting with / on linux and macos, and a drive or UNC path on windows, at most 1024 characters. A machine keeps the value it was created with. The worker creates the folder when it is missing, owned by the account the agent runs as, and an agent placement whose folder cannot be created or entered fails. Absent, the agent starts in the worker's own folder for its harness.
+     * @type {string}
+     * @memberof Environment
+     */
+    workingDirectory?: string;
+    /**
+     * Scripts the worker runs at points of a machine's and an agent's life. onStartMachine and onStartAgent are built; onStartSession, onStopSession, onStopAgent and onStopMachine are reserved.
+     * @type {EnvironmentHooks}
+     * @memberof Environment
+     */
+    hooks?: EnvironmentHooks;
     /**
      * Creation timestamp
      * @type {Date}

package/node_modules/@orchestraworks/client/dist/esm/models/Environment.js

@@ -13,6 +13,7 @@
  */
 import { EnvironmentIngressPolicyFromJSON, EnvironmentIngressPolicyToJSON, } from './EnvironmentIngressPolicy';
 import { EnvironmentPlatformWithRuntimeFromJSON, EnvironmentPlatformWithRuntimeToJSON, } from './EnvironmentPlatformWithRuntime';
+import { EnvironmentHooksFromJSON, EnvironmentHooksToJSON, } from './EnvironmentHooks';
 import { EnvironmentEgressPolicyFromJSON, EnvironmentEgressPolicyToJSON, } from './EnvironmentEgressPolicy';
 import { EnvironmentProvisionSpecFromJSON, EnvironmentProvisionSpecToJSON, } from './EnvironmentProvisionSpec';
 /**
@@ -66,6 +67,8 @@ export function EnvironmentFromJSONTyped(json, ignoreDiscriminator) {
         'ingressPolicy': json['ingressPolicy'] == null ? undefined : EnvironmentIngressPolicyFromJSON(json['ingressPolicy']),
         'kind': json['kind'],
         'provisionSpec': json['provisionSpec'] == null ? undefined : EnvironmentProvisionSpecFromJSON(json['provisionSpec']),
+        'workingDirectory': json['workingDirectory'] == null ? undefined : json['workingDirectory'],
+        'hooks': json['hooks'] == null ? undefined : EnvironmentHooksFromJSON(json['hooks']),
         'createdAt': (new Date(json['createdAt'])),
         'updatedAt': (new Date(json['updatedAt'])),
         'labels': json['labels'],
@@ -88,6 +91,8 @@ export function EnvironmentToJSONTyped(value, ignoreDiscriminator = false) {
         'egressPolicy': EnvironmentEgressPolicyToJSON(value['egressPolicy']),
         'ingressPolicy': EnvironmentIngressPolicyToJSON(value['ingressPolicy']),
         'provisionSpec': EnvironmentProvisionSpecToJSON(value['provisionSpec']),
+        'workingDirectory': value['workingDirectory'],
+        'hooks': EnvironmentHooksToJSON(value['hooks']),
         'createdAt': value['createdAt'].toISOString(),
         'updatedAt': value['updatedAt'].toISOString(),
         'labels': value['labels'],

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentHook.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Orchestra platform API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface EnvironmentHook
+ */
+export interface EnvironmentHook {
+    /**
+     * The script's text. Required, at most 64 KiB.
+     * @type {string}
+     * @memberof EnvironmentHook
+     */
+    script: string;
+    /**
+     * How long the script may run, in whole seconds. onStartAgent takes 1 to 240, and absent means 120. onStartMachine takes 1 to 3600, and absent means the deployment's bound, 600 unless it sets another. At the bound the worker kills the script and every process it started.
+     * @type {number}
+     * @memberof EnvironmentHook
+     */
+    timeoutSeconds?: number;
+}
+/**
+ * Check if a given object implements the EnvironmentHook interface.
+ */
+export declare function instanceOfEnvironmentHook(value: object): value is EnvironmentHook;
+export declare function EnvironmentHookFromJSON(json: any): EnvironmentHook;
+export declare function EnvironmentHookFromJSONTyped(json: any, ignoreDiscriminator: boolean): EnvironmentHook;
+export declare function EnvironmentHookToJSON(json: any): EnvironmentHook;
+export declare function EnvironmentHookToJSONTyped(value?: EnvironmentHook | null, ignoreDiscriminator?: boolean): any;

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentHook.js

@@ -0,0 +1,45 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Orchestra platform API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Check if a given object implements the EnvironmentHook interface.
+ */
+export function instanceOfEnvironmentHook(value) {
+    if (!('script' in value) || value['script'] === undefined)
+        return false;
+    return true;
+}
+export function EnvironmentHookFromJSON(json) {
+    return EnvironmentHookFromJSONTyped(json, false);
+}
+export function EnvironmentHookFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'script': json['script'],
+        'timeoutSeconds': json['timeoutSeconds'] == null ? undefined : json['timeoutSeconds'],
+    };
+}
+export function EnvironmentHookToJSON(json) {
+    return EnvironmentHookToJSONTyped(json, false);
+}
+export function EnvironmentHookToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'script': value['script'],
+        'timeoutSeconds': value['timeoutSeconds'],
+    };
+}

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentHooks.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Orchestra platform API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { EnvironmentHook } from './EnvironmentHook';
+/**
+ *
+ * @export
+ * @interface EnvironmentHooks
+ */
+export interface EnvironmentHooks {
+    /**
+     * A script run once as root on each new machine before it registers: bash on Linux, PowerShell on Windows. Provisioned environments only. A machine keeps the value it was created with. provisionSpec.setup is the same script under its older name.
+     * @type {EnvironmentHook}
+     * @memberof EnvironmentHooks
+     */
+    onStartMachine?: EnvironmentHook;
+    /**
+     * A script the worker runs once for each agent placement, after the agent's content is installed and before its first conversation starts: as the account the agent runs as, in workingDirectory, with the agent's environment and the egress edge's authority, so a rule binding a credential applies to it. bash -e on linux and macos, PowerShell on windows. A script that fails or runs past its bound fails the placement with on_start_agent_failed. A machine keeps the value it was created with.
+     * @type {EnvironmentHook}
+     * @memberof EnvironmentHooks
+     */
+    onStartAgent?: EnvironmentHook;
+}
+/**
+ * Check if a given object implements the EnvironmentHooks interface.
+ */
+export declare function instanceOfEnvironmentHooks(value: object): value is EnvironmentHooks;
+export declare function EnvironmentHooksFromJSON(json: any): EnvironmentHooks;
+export declare function EnvironmentHooksFromJSONTyped(json: any, ignoreDiscriminator: boolean): EnvironmentHooks;
+export declare function EnvironmentHooksToJSON(json: any): EnvironmentHooks;
+export declare function EnvironmentHooksToJSONTyped(value?: EnvironmentHooks | null, ignoreDiscriminator?: boolean): any;

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentHooks.js

@@ -0,0 +1,44 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Orchestra platform API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { EnvironmentHookFromJSON, EnvironmentHookToJSON, } from './EnvironmentHook';
+/**
+ * Check if a given object implements the EnvironmentHooks interface.
+ */
+export function instanceOfEnvironmentHooks(value) {
+    return true;
+}
+export function EnvironmentHooksFromJSON(json) {
+    return EnvironmentHooksFromJSONTyped(json, false);
+}
+export function EnvironmentHooksFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'onStartMachine': json['onStartMachine'] == null ? undefined : EnvironmentHookFromJSON(json['onStartMachine']),
+        'onStartAgent': json['onStartAgent'] == null ? undefined : EnvironmentHookFromJSON(json['onStartAgent']),
+    };
+}
+export function EnvironmentHooksToJSON(json) {
+    return EnvironmentHooksToJSONTyped(json, false);
+}
+export function EnvironmentHooksToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'onStartMachine': EnvironmentHookToJSON(value['onStartMachine']),
+        'onStartAgent': EnvironmentHookToJSON(value['onStartAgent']),
+    };
+}

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentHooksRequest.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Orchestra platform API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { EnvironmentHook } from './EnvironmentHook';
+/**
+ *
+ * @export
+ * @interface EnvironmentHooksRequest
+ */
+export interface EnvironmentHooksRequest {
+    /**
+     * A script run once as root on each new machine before it registers: bash on Linux, PowerShell on Windows. Provisioned environments only. A machine keeps the value it was created with. provisionSpec.setup is the same script under its older name. On an update, absent leaves the stored hook and null removes it.
+     * @type {EnvironmentHook}
+     * @memberof EnvironmentHooksRequest
+     */
+    onStartMachine?: EnvironmentHook | null;
+    /**
+     * A script the worker runs once for each agent placement, after the agent's content is installed and before its first conversation starts: as the account the agent runs as, in workingDirectory, with the agent's environment and the egress edge's authority, so a rule binding a credential applies to it. bash -e on linux and macos, PowerShell on windows. A script that fails or runs past its bound fails the placement with on_start_agent_failed. A machine keeps the value it was created with. On an update, absent leaves the stored hook and null removes it.
+     * @type {EnvironmentHook}
+     * @memberof EnvironmentHooksRequest
+     */
+    onStartAgent?: EnvironmentHook | null;
+}
+/**
+ * Check if a given object implements the EnvironmentHooksRequest interface.
+ */
+export declare function instanceOfEnvironmentHooksRequest(value: object): value is EnvironmentHooksRequest;
+export declare function EnvironmentHooksRequestFromJSON(json: any): EnvironmentHooksRequest;
+export declare function EnvironmentHooksRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): EnvironmentHooksRequest;
+export declare function EnvironmentHooksRequestToJSON(json: any): EnvironmentHooksRequest;
+export declare function EnvironmentHooksRequestToJSONTyped(value?: EnvironmentHooksRequest | null, ignoreDiscriminator?: boolean): any;

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentHooksRequest.js

@@ -0,0 +1,44 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Orchestra platform API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { EnvironmentHookFromJSON, EnvironmentHookToJSON, } from './EnvironmentHook';
+/**
+ * Check if a given object implements the EnvironmentHooksRequest interface.
+ */
+export function instanceOfEnvironmentHooksRequest(value) {
+    return true;
+}
+export function EnvironmentHooksRequestFromJSON(json) {
+    return EnvironmentHooksRequestFromJSONTyped(json, false);
+}
+export function EnvironmentHooksRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'onStartMachine': json['onStartMachine'] == null ? undefined : EnvironmentHookFromJSON(json['onStartMachine']),
+        'onStartAgent': json['onStartAgent'] == null ? undefined : EnvironmentHookFromJSON(json['onStartAgent']),
+    };
+}
+export function EnvironmentHooksRequestToJSON(json) {
+    return EnvironmentHooksRequestToJSONTyped(json, false);
+}
+export function EnvironmentHooksRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'onStartMachine': EnvironmentHookToJSON(value['onStartMachine']),
+        'onStartAgent': EnvironmentHookToJSON(value['onStartAgent']),
+    };
+}

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentProvisionSpec.d.ts

@@ -56,9 +56,10 @@ export interface EnvironmentProvisionSpec {
      */
     command?: Array<string>;
     /**
-     * A script run once as root on each new machine before it registers: bash on Linux, PowerShell on Windows. At most 64 KiB.
+     * Deprecated: use hooks.onStartMachine. A script run once as root on each new machine before it registers: bash on Linux, PowerShell on Windows. At most 64 KiB. A request may send it beside hooks.onStartMachine only when the two scripts are the same, and a read carries both.
      * @type {string}
      * @memberof EnvironmentProvisionSpec
+     * @deprecated
      */
     setup?: string;
     /**

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentProvisionSpecRequest.d.ts

@@ -48,9 +48,10 @@ export interface EnvironmentProvisionSpecRequest {
      */
     command?: Array<string>;
     /**
-     * A script run once as root on each new machine before it registers: bash on Linux, PowerShell on Windows. At most 64 KiB. On an update, absent leaves the stored value and an empty one clears it.
+     * Deprecated: use hooks.onStartMachine. A script run once as root on each new machine before it registers: bash on Linux, PowerShell on Windows. At most 64 KiB. A request may send it beside hooks.onStartMachine only when the two scripts are the same, and a read carries both. On an update, absent leaves the stored value and an empty one clears it.
      * @type {string}
      * @memberof EnvironmentProvisionSpecRequest
+     * @deprecated
      */
     setup?: string;
     /**

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentSnapshot.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { EnvironmentIngressPolicy } from './EnvironmentIngressPolicy';
+import type { EnvironmentHooks } from './EnvironmentHooks';
 import type { EnvironmentVolumeMount } from './EnvironmentVolumeMount';
 import type { EnvironmentEgressPolicy } from './EnvironmentEgressPolicy';
 import type { EnvironmentDisk } from './EnvironmentDisk';
@@ -137,6 +138,24 @@ export interface EnvironmentSnapshot {
      * @memberof EnvironmentSnapshot
      */
     shutdownGracePeriodSeconds?: number;
+    /**
+     * Working directory captured at machine creation; absent means none was declared
+     * @type {string}
+     * @memberof EnvironmentSnapshot
+     */
+    workingDirectory?: string;
+    /**
+     * Hooks captured at machine creation; absent means none was declared
+     * @type {EnvironmentHooks}
+     * @memberof EnvironmentSnapshot
+     */
+    hooks?: EnvironmentHooks;
+    /**
+     * Setup script bound captured at machine creation; absent means the deployment's
+     * @type {number}
+     * @memberof EnvironmentSnapshot
+     */
+    setupTimeoutSeconds?: number;
 }
 /**
  * @export

package/node_modules/@orchestraworks/client/dist/esm/models/EnvironmentSnapshot.js

@@ -12,6 +12,7 @@
  * Do not edit the class manually.
  */
 import { EnvironmentIngressPolicyFromJSON, EnvironmentIngressPolicyToJSON, } from './EnvironmentIngressPolicy';
+import { EnvironmentHooksFromJSON, EnvironmentHooksToJSON, } from './EnvironmentHooks';
 import { EnvironmentVolumeMountFromJSON, EnvironmentVolumeMountToJSON, } from './EnvironmentVolumeMount';
 import { EnvironmentEgressPolicyFromJSON, EnvironmentEgressPolicyToJSON, } from './EnvironmentEgressPolicy';
 import { EnvironmentDiskFromJSON, EnvironmentDiskToJSON, } from './EnvironmentDisk';
@@ -82,6 +83,9 @@ export function EnvironmentSnapshotFromJSONTyped(json, ignoreDiscriminator) {
         'keepAliveWhenIdle': json['keepAliveWhenIdle'],
         'ttl': json['ttl'] == null ? undefined : json['ttl'],
         'shutdownGracePeriodSeconds': json['shutdownGracePeriodSeconds'] == null ? undefined : json['shutdownGracePeriodSeconds'],
+        'workingDirectory': json['workingDirectory'] == null ? undefined : json['workingDirectory'],
+        'hooks': json['hooks'] == null ? undefined : EnvironmentHooksFromJSON(json['hooks']),
+        'setupTimeoutSeconds': json['setupTimeoutSeconds'] == null ? undefined : json['setupTimeoutSeconds'],
     };
 }
 export function EnvironmentSnapshotToJSON(json) {
@@ -111,5 +115,8 @@ export function EnvironmentSnapshotToJSONTyped(value, ignoreDiscriminator = fals
         'keepAliveWhenIdle': value['keepAliveWhenIdle'],
         'ttl': value['ttl'],
         'shutdownGracePeriodSeconds': value['shutdownGracePeriodSeconds'],
+        'workingDirectory': value['workingDirectory'],
+        'hooks': EnvironmentHooksToJSON(value['hooks']),
+        'setupTimeoutSeconds': value['setupTimeoutSeconds'],
     };
 }

package/node_modules/@orchestraworks/client/dist/esm/models/Machine.d.ts

@@ -43,11 +43,17 @@ export interface Machine {
      */
     environmentId: string;
     /**
-     * Compute registration key this machine launched on
+     * The internal registration key this machine launched on, for operators; computeProviderId names the compute provider
      * @type {string}
      * @memberof Machine
      */
     computeProviderKey: string;
+    /**
+     * The compute provider this machine runs on: cprov_orchestra on hosted compute, or the self-hosted record whose Launcher runs it. Absent on a customer's own enrolled machine
+     * @type {string}
+     * @memberof Machine
+     */
+    computeProviderId?: string;
     /**
      * Compute-provider instance id
      * @type {string}