@tetral-ai/sdk 0.110.0-alpha.1

package/resources/beta/environments/work.js

@@ -0,0 +1,281 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentWorker = exports.WorkPoller = exports.Work = void 0;
+const resource_1 = require("../../../core/resource.js");
+const pagination_1 = require("../../../core/pagination.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+const poller_1 = require("../../../lib/environments/poller.js");
+const worker_1 = require("../../../lib/environments/worker.js");
+/**
+ * Retained self-hosted Environment work surface. Tetral Cloud Environments do
+ * not implement these APIs in this stage; calls are kept as normal generated
+ * request paths and Tetral backend admission rejects them fail-closed.
+ */
+class Work extends resource_1.APIResource {
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Retrieve detailed information about a specific work item.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.retrieve('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    retrieve(workID, params, options) {
+        const { environment_id, betas } = params;
+        return this._client.get((0, path_1.path) `/v1/environments/${environment_id}/work/${workID}?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Update work item metadata with merge semantics.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.update('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *     metadata: { foo: 'string' },
+     *   });
+     * ```
+     */
+    update(workID, params, options) {
+        const { environment_id, betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/environments/${environment_id}/work/${workID}?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * List work items in an environment.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaSelfHostedWork of client.beta.environments.work.list(
+     *   'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(environmentID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/v1/environments/${environmentID}/work?beta=true`, (pagination_1.PageCursor), {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Acknowledge receipt of a work item, transitioning it from 'queued' to 'starting'
+     * and removing it from the queue.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.ack('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    ack(workID, params, options) {
+        const { environment_id, betas } = params;
+        return this._client.post((0, path_1.path) `/v1/environments/${environment_id}/work/${workID}/ack?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Record a heartbeat for a work item to maintain the lease.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWorkHeartbeatResponse =
+     *   await client.beta.environments.work.heartbeat('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    heartbeat(workID, params, options) {
+        const { environment_id, desired_ttl_seconds, expected_last_heartbeat, betas } = params;
+        return this._client.post((0, path_1.path) `/v1/environments/${environment_id}/work/${workID}/heartbeat?beta=true`, {
+            query: { desired_ttl_seconds, expected_last_heartbeat },
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Long poll for work items in the queue.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.poll(
+     *     'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   );
+     * ```
+     */
+    poll(environmentID, params = {}, options) {
+        const { betas, 'Anthropic-Worker-ID': anthropicWorkerID, ...query } = params ?? {};
+        return this._client.get((0, path_1.path) `/v1/environments/${environmentID}/work/poll?beta=true`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString(),
+                    ...(anthropicWorkerID != null ? { 'Anthropic-Worker-ID': anthropicWorkerID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Get statistics about the work queue for an environment.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWorkQueueStats =
+     *   await client.beta.environments.work.stats(
+     *     'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   );
+     * ```
+     */
+    stats(environmentID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.get((0, path_1.path) `/v1/environments/${environmentID}/work/stats?beta=true`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Stop a work item, initiating graceful or forced shutdown.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.stop('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    stop(workID, params, options) {
+        const { environment_id, betas, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/environments/${environment_id}/work/${workID}/stop?beta=true`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Retained self-hosted helper. Tetral Cloud-hosted Environments do not use the
+     * work queue in this stage. Continuously claim work from a self-hosted
+     * environment, ack each item, and yield it. Posts `stop` automatically when the
+     * consumer's loop body returns or when iteration ends.
+     *
+     * @example
+     * ```ts
+     * for await (const work of client.beta.environments.work.poller({
+     *   environmentId,
+     *   environmentKey,
+     * })) {
+     *   if (work.data.type !== 'session') continue;
+     *   // ...service the work...
+     * }
+     * ```
+     */
+    poller(opts) {
+        return new poller_1.WorkPoller({ ...opts, client: this._client });
+    }
+    /**
+     * Retained self-hosted helper. Tetral Cloud-hosted Environments do not use the
+     * work queue in this stage. The self-hosted environment runner polls for work,
+     * and for each claimed session sets up the workdir, downloads the agent's
+     * skills, runs the tools while heartbeating the lease, and force-stops on exit.
+     *
+     * @example
+     * ```ts
+     * // Long-running daemon — poll, serve each session, loop:
+     * await client.beta.environments.work
+     *   .worker({ environmentId, environmentKey, workdir: '/workspace' })
+     *   .run();
+     *
+     * // Or service one already-claimed work item (e.g. inside a sandbox spawned
+     * // by `ant worker poll --on-work`) — handleItem() reads the ANTHROPIC_* env vars:
+     * await client.beta.environments.work.worker({ workdir: '/workspace' }).handleItem();
+     * ```
+     */
+    worker(opts) {
+        return new worker_1.EnvironmentWorker({ ...opts, client: this._client });
+    }
+}
+exports.Work = Work;
+var poller_2 = require("../../../lib/environments/poller.js");
+Object.defineProperty(exports, "WorkPoller", { enumerable: true, get: function () { return poller_2.WorkPoller; } });
+var worker_2 = require("../../../lib/environments/worker.js");
+Object.defineProperty(exports, "EnvironmentWorker", { enumerable: true, get: function () { return worker_2.EnvironmentWorker; } });
+Work.WorkPoller = poller_1.WorkPoller;
+Work.EnvironmentWorker = worker_1.EnvironmentWorker;
+//# sourceMappingURL=work.js.map

package/resources/beta/environments/work.js.map

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

package/resources/beta/environments/work.mjs

@@ -0,0 +1,275 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { PageCursor } from "../../../core/pagination.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+import { WorkPoller, } from "../../../lib/environments/poller.mjs";
+import { EnvironmentWorker, } from "../../../lib/environments/worker.mjs";
+/**
+ * Retained self-hosted Environment work surface. Tetral Cloud Environments do
+ * not implement these APIs in this stage; calls are kept as normal generated
+ * request paths and Tetral backend admission rejects them fail-closed.
+ */
+export class Work extends APIResource {
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Retrieve detailed information about a specific work item.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.retrieve('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    retrieve(workID, params, options) {
+        const { environment_id, betas } = params;
+        return this._client.get(path `/v1/environments/${environment_id}/work/${workID}?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Update work item metadata with merge semantics.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.update('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *     metadata: { foo: 'string' },
+     *   });
+     * ```
+     */
+    update(workID, params, options) {
+        const { environment_id, betas, ...body } = params;
+        return this._client.post(path `/v1/environments/${environment_id}/work/${workID}?beta=true`, {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * List work items in an environment.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const betaSelfHostedWork of client.beta.environments.work.list(
+     *   'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(environmentID, params = {}, options) {
+        const { betas, ...query } = params ?? {};
+        return this._client.getAPIList(path `/v1/environments/${environmentID}/work?beta=true`, (PageCursor), {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Acknowledge receipt of a work item, transitioning it from 'queued' to 'starting'
+     * and removing it from the queue.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.ack('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    ack(workID, params, options) {
+        const { environment_id, betas } = params;
+        return this._client.post(path `/v1/environments/${environment_id}/work/${workID}/ack?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Record a heartbeat for a work item to maintain the lease.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWorkHeartbeatResponse =
+     *   await client.beta.environments.work.heartbeat('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    heartbeat(workID, params, options) {
+        const { environment_id, desired_ttl_seconds, expected_last_heartbeat, betas } = params;
+        return this._client.post(path `/v1/environments/${environment_id}/work/${workID}/heartbeat?beta=true`, {
+            query: { desired_ttl_seconds, expected_last_heartbeat },
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Long poll for work items in the queue.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.poll(
+     *     'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   );
+     * ```
+     */
+    poll(environmentID, params = {}, options) {
+        const { betas, 'Anthropic-Worker-ID': anthropicWorkerID, ...query } = params ?? {};
+        return this._client.get(path `/v1/environments/${environmentID}/work/poll?beta=true`, {
+            query,
+            ...options,
+            headers: buildHeaders([
+                {
+                    'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString(),
+                    ...(anthropicWorkerID != null ? { 'Anthropic-Worker-ID': anthropicWorkerID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Get statistics about the work queue for an environment.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWorkQueueStats =
+     *   await client.beta.environments.work.stats(
+     *     'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   );
+     * ```
+     */
+    stats(environmentID, params = {}, options) {
+        const { betas } = params ?? {};
+        return this._client.get(path `/v1/environments/${environmentID}/work/stats?beta=true`, {
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Note: these endpoints are called automatically by the pre-built environment
+     * worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted
+     * sandbox environments. They are included here as a reference; you do not need to
+     * invoke them directly.
+     *
+     * Stop a work item, initiating graceful or forced shutdown.
+     *
+     * @example
+     * ```ts
+     * const betaSelfHostedWork =
+     *   await client.beta.environments.work.stop('work_id', {
+     *     environment_id: 'env_011CZkZ9X2dpNyB7HsEFoRfW',
+     *   });
+     * ```
+     */
+    stop(workID, params, options) {
+        const { environment_id, betas, ...body } = params;
+        return this._client.post(path `/v1/environments/${environment_id}/work/${workID}/stop?beta=true`, {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Retained self-hosted helper. Tetral Cloud-hosted Environments do not use the
+     * work queue in this stage. Continuously claim work from a self-hosted
+     * environment, ack each item, and yield it. Posts `stop` automatically when the
+     * consumer's loop body returns or when iteration ends.
+     *
+     * @example
+     * ```ts
+     * for await (const work of client.beta.environments.work.poller({
+     *   environmentId,
+     *   environmentKey,
+     * })) {
+     *   if (work.data.type !== 'session') continue;
+     *   // ...service the work...
+     * }
+     * ```
+     */
+    poller(opts) {
+        return new WorkPoller({ ...opts, client: this._client });
+    }
+    /**
+     * Retained self-hosted helper. Tetral Cloud-hosted Environments do not use the
+     * work queue in this stage. The self-hosted environment runner polls for work,
+     * and for each claimed session sets up the workdir, downloads the agent's
+     * skills, runs the tools while heartbeating the lease, and force-stops on exit.
+     *
+     * @example
+     * ```ts
+     * // Long-running daemon — poll, serve each session, loop:
+     * await client.beta.environments.work
+     *   .worker({ environmentId, environmentKey, workdir: '/workspace' })
+     *   .run();
+     *
+     * // Or service one already-claimed work item (e.g. inside a sandbox spawned
+     * // by `ant worker poll --on-work`) — handleItem() reads the ANTHROPIC_* env vars:
+     * await client.beta.environments.work.worker({ workdir: '/workspace' }).handleItem();
+     * ```
+     */
+    worker(opts) {
+        return new EnvironmentWorker({ ...opts, client: this._client });
+    }
+}
+export { WorkPoller } from "../../../lib/environments/poller.mjs";
+export { EnvironmentWorker } from "../../../lib/environments/worker.mjs";
+Work.WorkPoller = WorkPoller;
+Work.EnvironmentWorker = EnvironmentWorker;
+//# sourceMappingURL=work.mjs.map

package/resources/beta/environments/work.mjs.map

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

package/resources/beta/environments.d.mts

@@ -0,0 +1,2 @@
+export * from "./environments/index.mjs";
+//# sourceMappingURL=environments.d.mts.map

package/resources/beta/environments.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.d.mts","sourceRoot":"","sources":["../../src/resources/beta/environments.ts"],"names":[],"mappings":"AAEA,yCAAqC"}

package/resources/beta/environments.d.ts

@@ -0,0 +1,2 @@
+export * from "./environments/index.js";
+//# sourceMappingURL=environments.d.ts.map

package/resources/beta/environments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../../src/resources/beta/environments.ts"],"names":[],"mappings":"AAEA,wCAAqC"}

package/resources/beta/environments.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../../internal/tslib.js");
+tslib_1.__exportStar(require("./environments/index.js"), exports);
+//# sourceMappingURL=environments.js.map

package/resources/beta/environments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.js","sourceRoot":"","sources":["../../src/resources/beta/environments.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kEAAqC"}

package/resources/beta/environments.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./environments/index.mjs";
+//# sourceMappingURL=environments.mjs.map

package/resources/beta/environments.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.mjs","sourceRoot":"","sources":["../../src/resources/beta/environments.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,yCAAqC"}