@archastro/sdk 0.5.0 → 0.5.3

package/dist/v1/resources/solutions.d.ts

@@ -0,0 +1,309 @@
+import { HttpClient } from "../../runtime/http-client.js";
+import type { SolutionDependentsResponse, SolutionImportResponse, SolutionInstallResponse, SolutionListResponse, SolutionSummary, SolutionUpgradeResponse } from "../../types/common.js";
+export declare class SolutionResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List Solutions
+     * Returns a paginated list of Solutions visible to the authenticated caller,
+     * merging two scopes: app-level Solutions (system-owned rows with no org
+     * affiliation, visible to all authenticated viewers in the app) and org-level
+     * Solutions (system-owned rows stamped with the viewer's org ID, included when
+     * the viewer carries an org context).
+     * Solutions that appear under both scopes are deduplicated by their stable
+     * `solution_id` value. The merged entry's `owners` array lists every scope the
+     * Solution was found under (`"system"` and/or `"org"`). When the app-level copy
+     * has a higher `solution_version` than the org-level copy, the response includes
+     * `upgrade_available: true` and `latest_version` so callers can prompt for an
+     * upgrade.
+     * @param params - Query parameters.
+     * @param params.page - Page number to return. Defaults to `1`.
+     * @param params.pageSize - Number of Solutions per page. Defaults to `25`.
+     * @param params.lookupKey - Filter to the Solution whose `lookup_key` matches exactly.
+     * @param params.pathPrefix - Filter to Solutions whose `virtual_path` starts with this prefix.
+     * @param params.owners - Restrict results to a subset of owner scopes. Accepted values: `"system"` (app-level Solutions) and `"org"` (viewer's org-level Solutions). Omit to include all scopes the viewer can see.
+     * @returns Paginated list of Solution summaries visible to the caller.
+     */
+    list(params?: {
+        page?: number;
+        pageSize?: number;
+        lookupKey?: string;
+        pathPrefix?: string;
+        owners?: string[];
+    }): Promise<SolutionListResponse>;
+    /**
+     * Import a Solution into the library
+     * Imports a Solution and its bundled configs (skills, scripts, templates, files)
+     * into the library for the target scope. Two mutually exclusive import modes
+     * are supported: pass `solution` to re-import an existing system-owned catalog
+     * Solution by ID or `lookup_key`, or pass `solution_bundle` to supply a
+     * self-contained inline bundle. Exactly one must be present.
+     * The operation upserts the bundle in a single transaction. When `dry_run` is
+     * `true` the same pipeline runs but the transaction is rolled back — no rows are
+     * persisted and the response reflects what would have been written. The
+     * response shape is the same in both cases: the Solution summary plus
+     * `installed_configs` listing each config the import created or would create.
+     * Pairs with `POST /api/v1/solutions/:solution/install`: this endpoint puts the
+     * Solution into the library; install provisions a runtime resource (Agent,
+     * AgentRoutine, AgentTool, etc.) from an already-imported Solution.
+     * @param input - Request body.
+     * @param input.dry_run - When `true`, runs the full import pipeline but rolls back the transaction — no rows are persisted. The response reflects what would have been written. Defaults to `false`.
+     * @param input.org - Organization ID (`org_...`) for the import destination scope.
+     * @param input.solution - Config ID (`cfg_...`) or `lookup_key` of an existing system-owned, org-less Solution to import into the target scope. Mutually exclusive with `solution_bundle`.
+     * @param input.solution_bundle - Self-contained inline bundle containing the Solution metadata plus all bundled configs (skills, templates, configs, files). Mutually exclusive with `solution`.
+     * @param input.team - Team ID (`team_...`) for the import destination scope.
+     * @param input.user - User ID (`usr_...`) for the import destination scope. Only one of `org`, `team`, or `user` may be set.
+     * @param input.virtual_path_prefix - Path prefix under which all uploaded configs' `virtual_path` values are anchored (for example `solutions/<uuid>`). Stable per install; omit to use no prefix.
+     * @returns The imported Solution in summary form, plus `installed_configs` — one entry per config the transaction created or would create in `dry_run` mode. `installed_configs` is deprecated; prefer the `solution` summary shape for new integrations.
+     */
+    create(input: {
+        dry_run?: boolean | undefined;
+        org?: string | undefined;
+        solution?: string | undefined;
+        solution_bundle?: {
+            configs?: {
+                content: string;
+                content_type?: string | undefined;
+                relative_path: string;
+            }[] | undefined;
+            lookup_key_prefix?: string | undefined;
+            lookup_key_suffix?: string | undefined;
+            setup_actions?: {
+                depends_on?: string[] | undefined;
+                description?: string | undefined;
+                kind: string;
+                params?: Record<string, unknown> | undefined;
+                required?: boolean | undefined;
+                sort_order?: number | undefined;
+                title: string;
+                verify_config?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            skills?: {
+                content: string;
+                content_type?: string | undefined;
+                files?: {
+                    content: string;
+                    content_type?: string | undefined;
+                    relative_path: string;
+                }[] | undefined;
+                relative_path: string;
+            }[] | undefined;
+            solution: {
+                content: string;
+                content_type?: string | undefined;
+                files?: {
+                    content: string;
+                    content_type?: string | undefined;
+                    data_encoding?: string | undefined;
+                    relative_path: string;
+                }[] | undefined;
+                lookup_key: string;
+            };
+            template?: {
+                content: string;
+                content_type?: string | undefined;
+                relative_path: string;
+            } | undefined;
+            templates?: {
+                content: string;
+                content_type?: string | undefined;
+                relative_path: string;
+            }[] | undefined;
+        } | undefined;
+        team?: string | undefined;
+        user?: string | undefined;
+        virtual_path_prefix?: string | undefined;
+    }): Promise<SolutionImportResponse>;
+    /**
+     * Delete a Solution
+     * Permanently deletes an imported Solution and all configs bundled with it,
+     * including templates, skills, scripts, and files. The deletion runs in a
+     * single transaction; provider-stored blobs are swept asynchronously after commit.
+     * Org-scope callers (for example, an org admin in the Library settings page) can
+     * only delete their org's copy of the Solution. App-scope callers can delete
+     * Solutions at either scope. RBAC is enforced inside the core delete flow.
+     * Returns `204 No Content` on success.
+     * @param solution - Solution config ID (`cfg_...`) or `lookup_key` of the Solution to delete.
+     * @returns Empty body. HTTP 204 indicates the Solution was deleted successfully.
+     */
+    delete(solution: string): Promise<void>;
+    /**
+     * Retrieve a Solution
+     * Returns a single Solution identified by its config ID (`cfg_...`) or
+     * `lookup_key`, in the same summary shape the list endpoint emits. The response
+     * always includes a freshly-minted `readme_url` — call this endpoint to refresh
+     * an expired README token without making any other state change.
+     * Visibility matches the list endpoint: app-level Solutions (no org affiliation)
+     * are visible to every authenticated viewer in the app; org-scoped Solutions are
+     * only visible to viewers whose org context matches. Anything else returns 404.
+     * When the resolved Solution is org-scoped, the endpoint compares its
+     * `solution_version` against the matching app-level copy. If the app-level copy
+     * is at a higher version the response includes `upgrade_available: true` and
+     * `latest_version`. App-level resolutions always report `upgrade_available: false`.
+     * @param solution - Solution config ID (`cfg_...`) or `lookup_key` of the Solution to retrieve.
+     * @returns Solution summary including a freshly-minted `readme_url` token valid for one hour.
+     */
+    get(solution: string): Promise<SolutionSummary>;
+    /**
+     * Preview Solution delete impact
+     * Returns a read-only preview of what deleting the specified Solution would
+     * affect: the agents that reference the Solution's bundle, and the count of
+     * bundled configs that would be orphaned rather than cascade-deleted.
+     * Use this endpoint before calling `DELETE /api/v1/solutions/:solution` to
+     * surface a warning when live agents depend on the Solution.
+     * Visibility scope mirrors the delete endpoint: org-scope viewers see their
+     * org's copy; app-scope viewers can inspect either scope.
+     * @param solution - Solution config ID (`cfg_...`) or `lookup_key` of the Solution to inspect.
+     * @returns Agents that reference this Solution's bundle plus the count of configs that would be orphaned on delete.
+     */
+    dependents(solution: string): Promise<SolutionDependentsResponse>;
+    /**
+     * Install a Solution
+     * Provisions a runtime resource from an already-imported Solution. The type of
+     * resource created depends on the template the Solution wraps: an
+     * `AgentTemplate` produces an Agent, an `AutomationTemplate` produces an
+     * Automation, and attachment templates (`AgentRoutineTemplate`,
+     * `AgentToolTemplate`, `AgentSkillTemplate`, `AgentComputerTemplate`) attach a
+     * sub-resource to an existing Agent specified by `target`.
+     * For Solutions that bundle more than one template, pass `template` (the ID or
+     * `lookup_key` of the desired template) to select which one to provision.
+     * Single-template Solutions do not require `template`.
+     * Pairs with `POST /api/v1/solutions` (import): import puts the Solution into
+     * the library; install provisions a runtime resource from it.
+     * @param solution - Config ID (`cfg_...`) or `lookup_key` of the already-imported Solution to install from.
+     * @param input - Request body.
+     * @param input.allow_auto_import - When `true`, automatically imports the Solution into the target tenant before installing if the org-scoped copy does not yet exist. Requires either an authenticated org user (member or admin) or a platform-privileged caller (S2S, developer JWT) that also supplies an explicit `org` param. Defaults to `false`; without it the endpoint returns 404 when the org-scoped Solution is missing.
+     * @param input.lookup_key - Lookup key override for the provisioned resource (for example, the Agent's `agent_key`).
+     * @param input.lookup_key_suffix - Suffix appended to every `config_ref:` resolution at install time. Should be stable per logical install and unique per attempt — allows the same Solution to be installed multiple times in the same app without collisions.
+     * @param input.name - Display name override for the provisioned Agent. Ignored for non-Agent Solutions.
+     * @param input.org - Organization ID (`org_...`) for the install destination scope.
+     * @param input.target - ID or `lookup_key` of the parent Agent to attach to. Required when installing an `AgentRoutineTemplate`, `AgentToolTemplate`, `AgentSkillTemplate`, or `AgentComputerTemplate` Solution, since those produce sub-resources attached to an existing Agent. Omit for `AgentTemplate` and `AutomationTemplate` Solutions, which provision standalone resources.
+     * @param input.team - Team ID (`team_...`) for the install destination scope.
+     * @param input.template - Config ID (`cfg_...`) or `lookup_key` of the template within the Solution to provision. Required when the Solution bundles more than one template; omit for single-template Solutions, where the only template is selected implicitly.
+     * @param input.user - User ID (`usr_...`) for the install destination scope.
+     * @returns The provisioned runtime resource (Agent, Automation, AgentRoutine, AgentTool, AgentSkill, or AgentComputer) together with the source Solution's config ID.
+     */
+    install(solution: string, input: {
+        allow_auto_import?: boolean | undefined;
+        lookup_key?: string | undefined;
+        lookup_key_suffix?: string | undefined;
+        name?: string | undefined;
+        org?: string | undefined;
+        target?: string | undefined;
+        team?: string | undefined;
+        template?: string | undefined;
+        user?: string | undefined;
+    }): Promise<SolutionInstallResponse>;
+    /**
+     * Retrieve a Solution README or asset
+     * Serves the README markdown or a bundled asset for an imported Solution. Both
+     * modes use the same path and require a short-lived signed `token` in the query
+     * string rather than an `Authorization` header, so browsers can load asset URLs
+     * directly from `<img src>` attributes without custom request logic.
+     * When `file` is omitted the response is the Solution's `readme` field rendered
+     * as `text/markdown`. All local asset references in the markdown are rewritten to
+     * point back at this endpoint with `?file=PATH&token=TOKEN` so browsers can load
+     * images inline without additional authentication.
+     * When `file` is set the response is the raw bytes of the matching asset (a File
+     * child whose `relative_path` equals `PATH`, or an inline `assets` entry by
+     * name) with the asset's stored `Content-Type`.
+     * Tokens are scoped to a single Solution, carry the viewer's app, org, and
+     * sandbox context from the time they were minted, and expire after one hour.
+     * Obtain a fresh token by calling `GET /api/v1/solutions/:solution`, which
+     * always returns a newly minted `readme_url`.
+     * @param solution - Solution config ID (`cfg_...`) identifying the Solution whose README or asset to retrieve.
+     * @param params - Query parameters.
+     * @param params.token - Signed URL token minted by the list or show endpoint. Expires after one hour.
+     * @param params.file - Relative path of the asset to retrieve (for example `images/hero.png`). When present the response is the raw asset bytes with its real `Content-Type`; when absent the response is the README markdown.
+     * @returns README markdown (`text/markdown`) when `file` is omitted, or the raw asset bytes with the asset's `Content-Type` when `file` is set.
+     */
+    readme(solution: string, params?: {
+        token?: string;
+        file?: string;
+    }): Promise<{
+        content: ArrayBuffer;
+        mimeType: string;
+    }>;
+    /**
+     * Upgrade an installed Solution
+     * Applies an incoming bundle to an already-installed Solution in a single atomic
+     * transaction, bringing its configs in line with the new bundle. Config IDs are
+     * preserved across the upgrade. Configs that existed in the old bundle but are
+     * absent from the new one are orphaned (top-level) or hard-deleted (child rows).
+     * Two mutually exclusive source modes: pass `target_solution` to pull the
+     * incoming bundle from an existing Solution by ID or `lookup_key`, or pass
+     * `solution_bundle` to supply a complete inline bundle directly. Exactly one
+     * must be present.
+     * When `dry_run` is `true` the full diff is computed and returned but no
+     * changes are written. Pass the dry-run response's `review_fingerprint` as
+     * `expected_review_fingerprint` when applying to guard against the bundle
+     * changing between review and apply.
+     * @param solution - Config ID (`cfg_...`) or `lookup_key` of the currently installed Solution to upgrade.
+     * @param input - Request body.
+     * @param input.allow_downgrade - When `true`, permits an incoming `solution_version` lower than the currently installed version. Defaults to `false`.
+     * @param input.dry_run - When `true`, computes and returns the full upgrade diff without persisting any changes. Defaults to `false`.
+     * @param input.expected_review_fingerprint - Optional stale-review guard. Pass the `review_fingerprint` returned by a prior `dry_run` call to ensure the bundle has not changed between review and apply.
+     * @param input.org - Organization ID (`org_...`) used to resolve org-scoped `lookup_key` values. Config IDs (`cfg_...`) are globally unique and do not require this.
+     * @param input.solution_bundle - Complete inline bundle for a direct upgrade, including Solution metadata, templates, skills, configs, files, and setup actions. Mutually exclusive with `target_solution`.
+     * @param input.target_solution - Config ID (`cfg_...`) or `lookup_key` of the Solution to use as the incoming upgrade source. Mutually exclusive with `solution_bundle`.
+     * @returns Updated Solution plus the full upgrade diff.
+     */
+    upgrade(solution: string, input: {
+        allow_downgrade?: boolean | undefined;
+        dry_run?: boolean | undefined;
+        expected_review_fingerprint?: string | undefined;
+        org?: string | undefined;
+        solution_bundle?: {
+            configs?: {
+                content: string;
+                content_type?: string | undefined;
+                relative_path: string;
+            }[] | undefined;
+            lookup_key_prefix?: string | undefined;
+            lookup_key_suffix?: string | undefined;
+            setup_actions?: {
+                depends_on?: string[] | undefined;
+                description?: string | undefined;
+                kind: string;
+                params?: Record<string, unknown> | undefined;
+                required?: boolean | undefined;
+                sort_order?: number | undefined;
+                title: string;
+                verify_config?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            skills?: {
+                content: string;
+                content_type?: string | undefined;
+                files?: {
+                    content: string;
+                    content_type?: string | undefined;
+                    relative_path: string;
+                }[] | undefined;
+                relative_path: string;
+            }[] | undefined;
+            solution: {
+                content: string;
+                content_type?: string | undefined;
+                files?: {
+                    content: string;
+                    content_type?: string | undefined;
+                    data_encoding?: string | undefined;
+                    relative_path: string;
+                }[] | undefined;
+                lookup_key: string;
+            };
+            template?: {
+                content: string;
+                content_type?: string | undefined;
+                relative_path: string;
+            } | undefined;
+            templates?: {
+                content: string;
+                content_type?: string | undefined;
+                relative_path: string;
+            }[] | undefined;
+        } | undefined;
+        target_solution?: string | undefined;
+    }): Promise<SolutionUpgradeResponse>;
+}
+//# sourceMappingURL=solutions.d.ts.map

package/dist/v1/resources/solutions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solutions.d.ts","sourceRoot":"","sources":["../../../src/v1/resources/solutions.ts"],"names":[],"mappings":"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"}

package/dist/v1/resources/solutions.js

@@ -0,0 +1,214 @@
+// Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
+// This file is auto-generated by @archastro/sdk-generator. Do not edit.
+// Content hash: fe6c5a3321d1
+export class SolutionResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List Solutions
+     * Returns a paginated list of Solutions visible to the authenticated caller,
+     * merging two scopes: app-level Solutions (system-owned rows with no org
+     * affiliation, visible to all authenticated viewers in the app) and org-level
+     * Solutions (system-owned rows stamped with the viewer's org ID, included when
+     * the viewer carries an org context).
+     * Solutions that appear under both scopes are deduplicated by their stable
+     * `solution_id` value. The merged entry's `owners` array lists every scope the
+     * Solution was found under (`"system"` and/or `"org"`). When the app-level copy
+     * has a higher `solution_version` than the org-level copy, the response includes
+     * `upgrade_available: true` and `latest_version` so callers can prompt for an
+     * upgrade.
+     * @param params - Query parameters.
+     * @param params.page - Page number to return. Defaults to `1`.
+     * @param params.pageSize - Number of Solutions per page. Defaults to `25`.
+     * @param params.lookupKey - Filter to the Solution whose `lookup_key` matches exactly.
+     * @param params.pathPrefix - Filter to Solutions whose `virtual_path` starts with this prefix.
+     * @param params.owners - Restrict results to a subset of owner scopes. Accepted values: `"system"` (app-level Solutions) and `"org"` (viewer's org-level Solutions). Omit to include all scopes the viewer can see.
+     * @returns Paginated list of Solution summaries visible to the caller.
+     */
+    async list(params) {
+        const query = {};
+        if (params?.page !== undefined) {
+            query["page"] = params?.page;
+        }
+        if (params?.pageSize !== undefined) {
+            query["page_size"] = params?.pageSize;
+        }
+        if (params?.lookupKey !== undefined) {
+            query["lookup_key"] = params?.lookupKey;
+        }
+        if (params?.pathPrefix !== undefined) {
+            query["path_prefix"] = params?.pathPrefix;
+        }
+        if (params?.owners !== undefined) {
+            query["owners"] = params?.owners;
+        }
+        return this.http.request(`/api/v1/solutions`, { query });
+    }
+    /**
+     * Import a Solution into the library
+     * Imports a Solution and its bundled configs (skills, scripts, templates, files)
+     * into the library for the target scope. Two mutually exclusive import modes
+     * are supported: pass `solution` to re-import an existing system-owned catalog
+     * Solution by ID or `lookup_key`, or pass `solution_bundle` to supply a
+     * self-contained inline bundle. Exactly one must be present.
+     * The operation upserts the bundle in a single transaction. When `dry_run` is
+     * `true` the same pipeline runs but the transaction is rolled back — no rows are
+     * persisted and the response reflects what would have been written. The
+     * response shape is the same in both cases: the Solution summary plus
+     * `installed_configs` listing each config the import created or would create.
+     * Pairs with `POST /api/v1/solutions/:solution/install`: this endpoint puts the
+     * Solution into the library; install provisions a runtime resource (Agent,
+     * AgentRoutine, AgentTool, etc.) from an already-imported Solution.
+     * @param input - Request body.
+     * @param input.dry_run - When `true`, runs the full import pipeline but rolls back the transaction — no rows are persisted. The response reflects what would have been written. Defaults to `false`.
+     * @param input.org - Organization ID (`org_...`) for the import destination scope.
+     * @param input.solution - Config ID (`cfg_...`) or `lookup_key` of an existing system-owned, org-less Solution to import into the target scope. Mutually exclusive with `solution_bundle`.
+     * @param input.solution_bundle - Self-contained inline bundle containing the Solution metadata plus all bundled configs (skills, templates, configs, files). Mutually exclusive with `solution`.
+     * @param input.team - Team ID (`team_...`) for the import destination scope.
+     * @param input.user - User ID (`usr_...`) for the import destination scope. Only one of `org`, `team`, or `user` may be set.
+     * @param input.virtual_path_prefix - Path prefix under which all uploaded configs' `virtual_path` values are anchored (for example `solutions/<uuid>`). Stable per install; omit to use no prefix.
+     * @returns The imported Solution in summary form, plus `installed_configs` — one entry per config the transaction created or would create in `dry_run` mode. `installed_configs` is deprecated; prefer the `solution` summary shape for new integrations.
+     */
+    async create(input) {
+        return this.http.request(`/api/v1/solutions`, { method: "POST", body: input });
+    }
+    /**
+     * Delete a Solution
+     * Permanently deletes an imported Solution and all configs bundled with it,
+     * including templates, skills, scripts, and files. The deletion runs in a
+     * single transaction; provider-stored blobs are swept asynchronously after commit.
+     * Org-scope callers (for example, an org admin in the Library settings page) can
+     * only delete their org's copy of the Solution. App-scope callers can delete
+     * Solutions at either scope. RBAC is enforced inside the core delete flow.
+     * Returns `204 No Content` on success.
+     * @param solution - Solution config ID (`cfg_...`) or `lookup_key` of the Solution to delete.
+     * @returns Empty body. HTTP 204 indicates the Solution was deleted successfully.
+     */
+    async delete(solution) {
+        await this.http.request(`/api/v1/solutions/${solution}`, { method: "DELETE" });
+    }
+    /**
+     * Retrieve a Solution
+     * Returns a single Solution identified by its config ID (`cfg_...`) or
+     * `lookup_key`, in the same summary shape the list endpoint emits. The response
+     * always includes a freshly-minted `readme_url` — call this endpoint to refresh
+     * an expired README token without making any other state change.
+     * Visibility matches the list endpoint: app-level Solutions (no org affiliation)
+     * are visible to every authenticated viewer in the app; org-scoped Solutions are
+     * only visible to viewers whose org context matches. Anything else returns 404.
+     * When the resolved Solution is org-scoped, the endpoint compares its
+     * `solution_version` against the matching app-level copy. If the app-level copy
+     * is at a higher version the response includes `upgrade_available: true` and
+     * `latest_version`. App-level resolutions always report `upgrade_available: false`.
+     * @param solution - Solution config ID (`cfg_...`) or `lookup_key` of the Solution to retrieve.
+     * @returns Solution summary including a freshly-minted `readme_url` token valid for one hour.
+     */
+    async get(solution) {
+        return this.http.request(`/api/v1/solutions/${solution}`);
+    }
+    /**
+     * Preview Solution delete impact
+     * Returns a read-only preview of what deleting the specified Solution would
+     * affect: the agents that reference the Solution's bundle, and the count of
+     * bundled configs that would be orphaned rather than cascade-deleted.
+     * Use this endpoint before calling `DELETE /api/v1/solutions/:solution` to
+     * surface a warning when live agents depend on the Solution.
+     * Visibility scope mirrors the delete endpoint: org-scope viewers see their
+     * org's copy; app-scope viewers can inspect either scope.
+     * @param solution - Solution config ID (`cfg_...`) or `lookup_key` of the Solution to inspect.
+     * @returns Agents that reference this Solution's bundle plus the count of configs that would be orphaned on delete.
+     */
+    async dependents(solution) {
+        return this.http.request(`/api/v1/solutions/${solution}/dependents`);
+    }
+    /**
+     * Install a Solution
+     * Provisions a runtime resource from an already-imported Solution. The type of
+     * resource created depends on the template the Solution wraps: an
+     * `AgentTemplate` produces an Agent, an `AutomationTemplate` produces an
+     * Automation, and attachment templates (`AgentRoutineTemplate`,
+     * `AgentToolTemplate`, `AgentSkillTemplate`, `AgentComputerTemplate`) attach a
+     * sub-resource to an existing Agent specified by `target`.
+     * For Solutions that bundle more than one template, pass `template` (the ID or
+     * `lookup_key` of the desired template) to select which one to provision.
+     * Single-template Solutions do not require `template`.
+     * Pairs with `POST /api/v1/solutions` (import): import puts the Solution into
+     * the library; install provisions a runtime resource from it.
+     * @param solution - Config ID (`cfg_...`) or `lookup_key` of the already-imported Solution to install from.
+     * @param input - Request body.
+     * @param input.allow_auto_import - When `true`, automatically imports the Solution into the target tenant before installing if the org-scoped copy does not yet exist. Requires either an authenticated org user (member or admin) or a platform-privileged caller (S2S, developer JWT) that also supplies an explicit `org` param. Defaults to `false`; without it the endpoint returns 404 when the org-scoped Solution is missing.
+     * @param input.lookup_key - Lookup key override for the provisioned resource (for example, the Agent's `agent_key`).
+     * @param input.lookup_key_suffix - Suffix appended to every `config_ref:` resolution at install time. Should be stable per logical install and unique per attempt — allows the same Solution to be installed multiple times in the same app without collisions.
+     * @param input.name - Display name override for the provisioned Agent. Ignored for non-Agent Solutions.
+     * @param input.org - Organization ID (`org_...`) for the install destination scope.
+     * @param input.target - ID or `lookup_key` of the parent Agent to attach to. Required when installing an `AgentRoutineTemplate`, `AgentToolTemplate`, `AgentSkillTemplate`, or `AgentComputerTemplate` Solution, since those produce sub-resources attached to an existing Agent. Omit for `AgentTemplate` and `AutomationTemplate` Solutions, which provision standalone resources.
+     * @param input.team - Team ID (`team_...`) for the install destination scope.
+     * @param input.template - Config ID (`cfg_...`) or `lookup_key` of the template within the Solution to provision. Required when the Solution bundles more than one template; omit for single-template Solutions, where the only template is selected implicitly.
+     * @param input.user - User ID (`usr_...`) for the install destination scope.
+     * @returns The provisioned runtime resource (Agent, Automation, AgentRoutine, AgentTool, AgentSkill, or AgentComputer) together with the source Solution's config ID.
+     */
+    async install(solution, input) {
+        return this.http.request(`/api/v1/solutions/${solution}/install`, { method: "POST", body: input });
+    }
+    /**
+     * Retrieve a Solution README or asset
+     * Serves the README markdown or a bundled asset for an imported Solution. Both
+     * modes use the same path and require a short-lived signed `token` in the query
+     * string rather than an `Authorization` header, so browsers can load asset URLs
+     * directly from `<img src>` attributes without custom request logic.
+     * When `file` is omitted the response is the Solution's `readme` field rendered
+     * as `text/markdown`. All local asset references in the markdown are rewritten to
+     * point back at this endpoint with `?file=PATH&token=TOKEN` so browsers can load
+     * images inline without additional authentication.
+     * When `file` is set the response is the raw bytes of the matching asset (a File
+     * child whose `relative_path` equals `PATH`, or an inline `assets` entry by
+     * name) with the asset's stored `Content-Type`.
+     * Tokens are scoped to a single Solution, carry the viewer's app, org, and
+     * sandbox context from the time they were minted, and expire after one hour.
+     * Obtain a fresh token by calling `GET /api/v1/solutions/:solution`, which
+     * always returns a newly minted `readme_url`.
+     * @param solution - Solution config ID (`cfg_...`) identifying the Solution whose README or asset to retrieve.
+     * @param params - Query parameters.
+     * @param params.token - Signed URL token minted by the list or show endpoint. Expires after one hour.
+     * @param params.file - Relative path of the asset to retrieve (for example `images/hero.png`). When present the response is the raw asset bytes with its real `Content-Type`; when absent the response is the README markdown.
+     * @returns README markdown (`text/markdown`) when `file` is omitted, or the raw asset bytes with the asset's `Content-Type` when `file` is set.
+     */
+    async readme(solution, params) {
+        const query = {};
+        query["token"] = params?.token;
+        if (params?.file !== undefined) {
+            query["file"] = params?.file;
+        }
+        return this.http.requestRaw(`/api/v1/solutions/${solution}/readme`, { query });
+    }
+    /**
+     * Upgrade an installed Solution
+     * Applies an incoming bundle to an already-installed Solution in a single atomic
+     * transaction, bringing its configs in line with the new bundle. Config IDs are
+     * preserved across the upgrade. Configs that existed in the old bundle but are
+     * absent from the new one are orphaned (top-level) or hard-deleted (child rows).
+     * Two mutually exclusive source modes: pass `target_solution` to pull the
+     * incoming bundle from an existing Solution by ID or `lookup_key`, or pass
+     * `solution_bundle` to supply a complete inline bundle directly. Exactly one
+     * must be present.
+     * When `dry_run` is `true` the full diff is computed and returned but no
+     * changes are written. Pass the dry-run response's `review_fingerprint` as
+     * `expected_review_fingerprint` when applying to guard against the bundle
+     * changing between review and apply.
+     * @param solution - Config ID (`cfg_...`) or `lookup_key` of the currently installed Solution to upgrade.
+     * @param input - Request body.
+     * @param input.allow_downgrade - When `true`, permits an incoming `solution_version` lower than the currently installed version. Defaults to `false`.
+     * @param input.dry_run - When `true`, computes and returns the full upgrade diff without persisting any changes. Defaults to `false`.
+     * @param input.expected_review_fingerprint - Optional stale-review guard. Pass the `review_fingerprint` returned by a prior `dry_run` call to ensure the bundle has not changed between review and apply.
+     * @param input.org - Organization ID (`org_...`) used to resolve org-scoped `lookup_key` values. Config IDs (`cfg_...`) are globally unique and do not require this.
+     * @param input.solution_bundle - Complete inline bundle for a direct upgrade, including Solution metadata, templates, skills, configs, files, and setup actions. Mutually exclusive with `target_solution`.
+     * @param input.target_solution - Config ID (`cfg_...`) or `lookup_key` of the Solution to use as the incoming upgrade source. Mutually exclusive with `solution_bundle`.
+     * @returns Updated Solution plus the full upgrade diff.
+     */
+    async upgrade(solution, input) {
+        return this.http.request(`/api/v1/solutions/${solution}/upgrade`, { method: "POST", body: input });
+    }
+}
+//# sourceMappingURL=solutions.js.map

package/dist/v1/resources/solutions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solutions.js","sourceRoot":"","sources":["../../../src/v1/resources/solutions.ts"],"names":[],"mappings":"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"}

package/dist/v1/resources/team_memberships.d.ts

@@ -3,6 +3,26 @@ import type { TeamMembershipListResponse } from "../../types/teams.js";
 export declare class TeamMembershipResource {
     private http;
     constructor(http: HttpClient);
+    /**
+     * List team memberships
+     * Returns a paginated list of team memberships across all teams accessible to
+     * the authenticated caller. Use the `team`, `user`, and `agent` filters to
+     * narrow results to a specific team or principal.
+     * This endpoint requires S2S (service-to-service) authentication. Callers
+     * authenticated with a user token receive a 401. Each membership includes the
+     * resolved `type` (`"user"`, `"agent"`, or `"unknown"`), display name, and
+     * profile picture derived from the associated user or agent at request time.
+     * Results are returned in offset-based pages. Pass `page` and `page_size` to
+     * navigate; the response includes `has_next` and `has_prev` to determine
+     * whether adjacent pages exist.
+     * @param params - Query parameters.
+     * @param params.team - Filter results to memberships belonging to these team IDs (`tm_...`). Multiple values are combined with OR.
+     * @param params.user - Filter results to memberships held by these user IDs (`usr_...`). Multiple values are combined with OR.
+     * @param params.agent - Filter results to memberships held by these agent IDs (`agt_...`). Multiple values are combined with OR.
+     * @param params.page - Page number to retrieve, starting at `1`. Defaults to `1`.
+     * @param params.pageSize - Number of memberships to return per page. Defaults to `25`.
+     * @returns Paginated list of team memberships matching the applied filters.
+     */
     list(params?: {
         team?: string[];
         user?: string[];
@@ -10,6 +30,17 @@ export declare class TeamMembershipResource {
         page?: number;
         pageSize?: number;
     }): Promise<TeamMembershipListResponse>;
+    /**
+     * Remove a team membership by ID
+     * Removes a team membership identified directly by its membership ID. On
+     * success, returns 204 No Content.
+     * This endpoint is intended for server-to-server callers that already hold the
+     * membership ID. To remove a member by user or agent ID instead, use the team
+     * members delete endpoint. The caller must have permission to manage the team
+     * that the membership belongs to.
+     * @param teamMembership - Team membership ID (`tmb_...`) to remove. The membership must be within the caller's app scope.
+     * @returns Empty response. Returns 204 No Content on success.
+     */
     delete(teamMembership: string): Promise<void>;
 }
 //# sourceMappingURL=team_memberships.d.ts.map

package/dist/v1/resources/team_memberships.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"team_memberships.d.ts","sourceRoot":"","sources":["../../../src/v1/resources/team_memberships.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,qBAAa,sBAAsB;IACrB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE9B,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAI5I,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}
+{"version":3,"file":"team_memberships.d.ts","sourceRoot":"","sources":["../../../src/v1/resources/team_memberships.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,qBAAa,sBAAsB;IACrB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAqBlJ;;;;;;;;;;OAUG;IACG,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}