@veruna/api-contracts 19.1.0 → 20.1.0

package/build/v1/tasks/schemas/task-requirements.schema.js

@@ -3,6 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskRequirementsSchema = void 0;
 const zod_1 = require("zod");
 const task_requirement_enum_1 = require("./task-requirement.enum");
+/**
+ * Ordered list of prerequisites for a task. Duplicates are not
+ * permitted. May be empty (task has no prerequisites).
+ */
+/**
+ * Upper bound equals the cardinality of `TaskRequirement` — any longer
+ * array is necessarily a duplicate or malformed payload. Explicit
+ * `.max()` rejects it BEFORE the `.refine()` Set allocation, guarding
+ * against memory-exhaustion DoS via crafted admin requests.
+ */
 const TASK_REQUIREMENT_CARDINALITY = 5;
 exports.TaskRequirementsSchema = zod_1.z
     .array(zod_1.z.enum(task_requirement_enum_1.TaskRequirement))

package/build/v1/tasks/schemas/task-requirements.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-requirements.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-requirements.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mEAA0D;AAY1D,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE1B,QAAA,sBAAsB,GAAG,OAAC;KAClC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,uCAAe,CAAC,CAAC;KAC9B,GAAG,CAAC,4BAA4B,CAAC;KACjC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,6BAA6B;CACzC,CAAC,CAAC"}
+{"version":3,"file":"task-requirements.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-requirements.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,mEAA0D;AAE1D;;;GAGG;AACH;;;;;GAKG;AACH,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE1B,QAAA,sBAAsB,GAAG,OAAC;KAClC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,uCAAe,CAAC,CAAC;KAC9B,GAAG,CAAC,4BAA4B,CAAC;KACjC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,6BAA6B;CACzC,CAAC,CAAC"}

package/build/v1/tasks/schemas/task-type.enum.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Verification flow used by a TaskDefinition.
+ *
+ * - `UI_ONLY`        — display-only (no verify/claim endpoints), e.g. teaser
+ * - `INTERNAL`       — verified server-side via `TaskVerifierRegistry`
+ * - `EXTERNAL_LINK`  — reserved for future flows that delegate verification
+ *                      to an external link/redirect
+ * - `MANUAL`         — reserved for future flows where an admin manually
+ *                      approves a completion
+ */
 export declare enum TaskType {
     UI_ONLY = "UI_ONLY",
     INTERNAL = "INTERNAL",

package/build/v1/tasks/schemas/task-type.enum.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskType = void 0;
+/**
+ * Verification flow used by a TaskDefinition.
+ *
+ * - `UI_ONLY`        — display-only (no verify/claim endpoints), e.g. teaser
+ * - `INTERNAL`       — verified server-side via `TaskVerifierRegistry`
+ * - `EXTERNAL_LINK`  — reserved for future flows that delegate verification
+ *                      to an external link/redirect
+ * - `MANUAL`         — reserved for future flows where an admin manually
+ *                      approves a completion
+ */
 var TaskType;
 (function (TaskType) {
     TaskType["UI_ONLY"] = "UI_ONLY";

package/build/v1/tasks/schemas/task-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-type.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-type.enum.ts"],"names":[],"mappings":";;;AAUA,IAAY,QAKX;AALD,WAAY,QAAQ;IAChB,+BAAmB,CAAA;IACnB,iCAAqB,CAAA;IACrB,2CAA+B,CAAA;IAC/B,6BAAiB,CAAA;AACrB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB"}
+{"version":3,"file":"task-type.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/task-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,IAAY,QAKX;AALD,WAAY,QAAQ;IAChB,+BAAmB,CAAA;IACnB,iCAAqB,CAAA;IACrB,2CAA+B,CAAA;IAC/B,6BAAiB,CAAA;AACrB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB"}

package/build/v1/tasks/schemas/user-task-response.schema.js

@@ -17,6 +17,12 @@ exports.UserTaskItemSchema = zod_1.z.object({
     status: zod_1.z.enum(user_task_status_enum_1.UserTaskStatus),
     currentCompletion: zod_1.z.number().int(),
     maxCompletions: zod_1.z.number().int(),
+    /**
+     * Ordered list of `TaskRequirement` values the user hasn't satisfied
+     * for this task. The client localises each entry via its own i18n
+     * dictionary (e.g. `TELEGRAM_LINKED` → "Привяжите Telegram"). Empty
+     * array when the task is fully accessible.
+     */
     unmetRequirements: zod_1.z.array(zod_1.z.enum(task_requirement_enum_1.TaskRequirement)),
     metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable(),
 });

package/build/v1/tasks/schemas/user-task-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-task-response.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/user-task-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qDAA4C;AAC5C,mEAAyD;AACzD,mEAA0D;AAE7C,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACnC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,CAAC;IACtB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE;IACxB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE;IACnB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC;IAC9B,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACnC,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAOhC,iBAAiB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,uCAAe,CAAC,CAAC;IACnD,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAEU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,0BAAkB,CAAC;CACrC,CAAC,CAAC"}
+{"version":3,"file":"user-task-response.schema.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/user-task-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qDAA4C;AAC5C,mEAAyD;AACzD,mEAA0D;AAE7C,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACnC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAQ,CAAC;IACtB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE;IACxB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE;IACnB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC;IAC9B,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACnC,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAChC;;;;;OAKG;IACH,iBAAiB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,uCAAe,CAAC,CAAC;IACnD,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAEU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,0BAAkB,CAAC;CACrC,CAAC,CAAC"}

package/build/v1/tasks/schemas/user-task-status.enum.d.ts

@@ -1,3 +1,12 @@
+/**
+ * State of a single user-task completion.
+ *
+ * - `AVAILABLE` — virtual state used by `getUserTasks` when the user has no
+ *                 (or fewer than `maxCompletions`) UserTask records and the
+ *                 next attempt is allowed
+ * - `COMPLETED` — verifier ran successfully, reward not yet claimed
+ * - `CLAIMED`   — reward credited to the user balance
+ */
 export declare enum UserTaskStatus {
     AVAILABLE = "AVAILABLE",
     COMPLETED = "COMPLETED",

package/build/v1/tasks/schemas/user-task-status.enum.js

@@ -1,6 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserTaskStatus = void 0;
+/**
+ * State of a single user-task completion.
+ *
+ * - `AVAILABLE` — virtual state used by `getUserTasks` when the user has no
+ *                 (or fewer than `maxCompletions`) UserTask records and the
+ *                 next attempt is allowed
+ * - `COMPLETED` — verifier ran successfully, reward not yet claimed
+ * - `CLAIMED`   — reward credited to the user balance
+ */
 var UserTaskStatus;
 (function (UserTaskStatus) {
     UserTaskStatus["AVAILABLE"] = "AVAILABLE";

package/build/v1/tasks/schemas/user-task-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-task-status.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/user-task-status.enum.ts"],"names":[],"mappings":";;;AASA,IAAY,cAIX;AAJD,WAAY,cAAc;IACtB,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;IACvB,qCAAmB,CAAA;AACvB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB"}
+{"version":3,"file":"user-task-status.enum.js","sourceRoot":"","sources":["../../../../v1/tasks/schemas/user-task-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,IAAY,cAIX;AAJD,WAAY,cAAc;IACtB,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;IACvB,qCAAmB,CAAA;AACvB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB"}

package/build/v1/tasks/tasks.constants.d.ts

@@ -1,8 +1,20 @@
+/**
+ * Regex for admin-defined `taskCode` values. Must start with an
+ * uppercase letter and consist of uppercase letters, digits and
+ * underscores only. Max length is 100.
+ */
 export declare const TASK_CODE_REGEX: RegExp;
+/** Max length of `description` field (free-form admin text). */
 export declare const MAX_TASK_DESCRIPTION_LENGTH = 2000;
+/** Max number of keys allowed in the `metadata` JSON object. */
 export declare const MAX_TASK_METADATA_KEYS = 50;
+/** Max serialized size (in bytes) of the `metadata` JSON object. */
 export declare const MAX_TASK_METADATA_BYTES = 8192;
+/** Max nesting depth allowed inside the `metadata` JSON object. */
 export declare const MAX_TASK_METADATA_DEPTH = 5;
+/** Upper bound for `maxCompletions` on a single task definition. */
 export declare const MAX_TASK_COMPLETIONS = 1000;
+/** Upper bound for the `order` sort key used in list endpoints. */
 export declare const MAX_TASK_ORDER = 100000;
+/** Max length of a task `title` (matches the Prisma column limit). */
 export declare const MAX_TASK_TITLE_LENGTH = 255;

package/build/v1/tasks/tasks.constants.js

@@ -1,12 +1,30 @@
 "use strict";
+// ─────────────────────────────────────────────────────────────────────
+// Field limits (shared between admin request/response schemas and
+// domain invariants). Prefixed with `TASK_` to avoid collisions with
+// similarly-named constants exported from other modules (e.g. wallet's
+// `MAX_METADATA_KEYS`).
+// ─────────────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_TASK_TITLE_LENGTH = exports.MAX_TASK_ORDER = exports.MAX_TASK_COMPLETIONS = exports.MAX_TASK_METADATA_DEPTH = exports.MAX_TASK_METADATA_BYTES = exports.MAX_TASK_METADATA_KEYS = exports.MAX_TASK_DESCRIPTION_LENGTH = exports.TASK_CODE_REGEX = void 0;
+/**
+ * Regex for admin-defined `taskCode` values. Must start with an
+ * uppercase letter and consist of uppercase letters, digits and
+ * underscores only. Max length is 100.
+ */
 exports.TASK_CODE_REGEX = /^[A-Z][A-Z0-9_]{0,99}$/;
+/** Max length of `description` field (free-form admin text). */
 exports.MAX_TASK_DESCRIPTION_LENGTH = 2000;
+/** Max number of keys allowed in the `metadata` JSON object. */
 exports.MAX_TASK_METADATA_KEYS = 50;
+/** Max serialized size (in bytes) of the `metadata` JSON object. */
 exports.MAX_TASK_METADATA_BYTES = 8192;
+/** Max nesting depth allowed inside the `metadata` JSON object. */
 exports.MAX_TASK_METADATA_DEPTH = 5;
+/** Upper bound for `maxCompletions` on a single task definition. */
 exports.MAX_TASK_COMPLETIONS = 1000;
+/** Upper bound for the `order` sort key used in list endpoints. */
 exports.MAX_TASK_ORDER = 100_000;
+/** Max length of a task `title` (matches the Prisma column limit). */
 exports.MAX_TASK_TITLE_LENGTH = 255;
 //# sourceMappingURL=tasks.constants.js.map

package/build/v1/tasks/tasks.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.constants.js","sourceRoot":"","sources":["../../../v1/tasks/tasks.constants.ts"],"names":[],"mappings":";;;AAYa,QAAA,eAAe,GAAG,wBAAwB,CAAC;AAG3C,QAAA,2BAA2B,GAAG,IAAI,CAAC;AAGnC,QAAA,sBAAsB,GAAG,EAAE,CAAC;AAG5B,QAAA,uBAAuB,GAAG,IAAI,CAAC;AAG/B,QAAA,uBAAuB,GAAG,CAAC,CAAC;AAG5B,QAAA,oBAAoB,GAAG,IAAI,CAAC;AAG5B,QAAA,cAAc,GAAG,OAAO,CAAC;AAGzB,QAAA,qBAAqB,GAAG,GAAG,CAAC"}
+{"version":3,"file":"tasks.constants.js","sourceRoot":"","sources":["../../../v1/tasks/tasks.constants.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,kEAAkE;AAClE,qEAAqE;AACrE,uEAAuE;AACvE,wBAAwB;AACxB,wEAAwE;;;AAExE;;;;GAIG;AACU,QAAA,eAAe,GAAG,wBAAwB,CAAC;AAExD,gEAAgE;AACnD,QAAA,2BAA2B,GAAG,IAAI,CAAC;AAEhD,gEAAgE;AACnD,QAAA,sBAAsB,GAAG,EAAE,CAAC;AAEzC,oEAAoE;AACvD,QAAA,uBAAuB,GAAG,IAAI,CAAC;AAE5C,mEAAmE;AACtD,QAAA,uBAAuB,GAAG,CAAC,CAAC;AAEzC,oEAAoE;AACvD,QAAA,oBAAoB,GAAG,IAAI,CAAC;AAEzC,mEAAmE;AACtD,QAAA,cAAc,GAAG,OAAO,CAAC;AAEtC,sEAAsE;AACzD,QAAA,qBAAqB,GAAG,GAAG,CAAC"}

package/build/v1/tasks/tasks.errors.js

@@ -77,6 +77,10 @@ exports.TASK_ERRORS = {
     },
     [TaskErrorCode.USER_NOT_REGISTERED]: {
         code: TaskErrorCode.USER_NOT_REGISTERED,
+        // 403 Forbidden: the request is authenticated (JwtAuthGuard passed)
+        // but the caller's registration state does not satisfy the task
+        // requirement. 401 would imply missing/invalid credentials, which
+        // is not the case here.
         statusCode: 403,
     },
     [TaskErrorCode.USER_NOT_VERIFIED]: {

package/build/v1/tasks/tasks.errors.js.map

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

package/build/v1/telegram-auth/commands/exchange-telegram-auth.command.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Exchange Telegram Auth Command
+ * POST /api/v1/auth/telegram/exchange
+ */
 export declare namespace ExchangeTelegramAuthCommand {
     const Request: z.ZodObject<{
         uuid: z.ZodString;

package/build/v1/telegram-auth/commands/exchange-telegram-auth.command.js

@@ -4,6 +4,10 @@ exports.ExchangeTelegramAuthCommand = void 0;
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Exchange Telegram Auth Command
+ * POST /api/v1/auth/telegram/exchange
+ */
 var ExchangeTelegramAuthCommand;
 (function (ExchangeTelegramAuthCommand) {
     ExchangeTelegramAuthCommand.Request = schemas_1.TelegramAuthExchangeRequestSchema;

package/build/v1/telegram-auth/commands/exchange-telegram-auth.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"exchange-telegram-auth.command.js","sourceRoot":"","sources":["../../../../v1/telegram-auth/commands/exchange-telegram-auth.command.ts"],"names":[],"mappings":";;;AACA,wCAAmG;AACnG,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,2BAA2B,CAS3C;AATD,WAAiB,2BAA2B;IAC3B,mCAAO,GAAG,2CAAiC,CAAC;IAC5C,oCAAQ,GAAG,4CAAkC,CAAC;IAE9C,+BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;IAChD,kCAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,2BAA2B,2CAA3B,2BAA2B,QAS3C"}
+{"version":3,"file":"exchange-telegram-auth.command.js","sourceRoot":"","sources":["../../../../v1/telegram-auth/commands/exchange-telegram-auth.command.ts"],"names":[],"mappings":";;;AACA,wCAAmG;AACnG,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,2BAA2B,CAS3C;AATD,WAAiB,2BAA2B;IAC3B,mCAAO,GAAG,2CAAiC,CAAC;IAC5C,oCAAQ,GAAG,4CAAkC,CAAC;IAE9C,+BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;IAChD,kCAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,2BAA2B,2CAA3B,2BAA2B,QAS3C"}

package/build/v1/telegram-auth/commands/init-telegram-auth.command.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Init Telegram Auth Command
+ * POST /api/v1/auth/telegram/init
+ */
 export declare namespace InitTelegramAuthCommand {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{

package/build/v1/telegram-auth/commands/init-telegram-auth.command.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Init Telegram Auth Command
+ * POST /api/v1/auth/telegram/init
+ */
 var InitTelegramAuthCommand;
 (function (InitTelegramAuthCommand) {
     InitTelegramAuthCommand.Request = zod_1.z.object({});

package/build/v1/telegram-auth/commands/init-telegram-auth.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-telegram-auth.command.js","sourceRoot":"","sources":["../../../../v1/telegram-auth/commands/init-telegram-auth.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA4D;AAC5D,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,uBAAuB,CASvC;AATD,WAAiB,uBAAuB;IACvB,+BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,gCAAQ,GAAG,wCAA8B,CAAC;IAE1C,2BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;IAC5C,8BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,uBAAuB,uCAAvB,uBAAuB,QASvC"}
+{"version":3,"file":"init-telegram-auth.command.js","sourceRoot":"","sources":["../../../../v1/telegram-auth/commands/init-telegram-auth.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA4D;AAC5D,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,uBAAuB,CASvC;AATD,WAAiB,uBAAuB;IACvB,+BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,gCAAQ,GAAG,wCAA8B,CAAC;IAE1C,2BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;IAC5C,8BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,uBAAuB,uCAAvB,uBAAuB,QASvC"}

package/build/v1/telegram-auth/constants/telegram-auth.constants.d.ts

@@ -1,2 +1,13 @@
+/**
+ * Prefix for Telegram auth deep link payload.
+ * Used to identify auth/link requests when user clicks bot link.
+ * Examples:
+ * - auth flow: telegram.me/BotName?start=auth_<authCode>.<exchangeToken>
+ * - link flow: telegram.me/BotName?start=auth_<authCode>
+ */
 export declare const TELEGRAM_AUTH_CODE_PREFIX: "auth_";
+/**
+ * Separator for telegram deep-link payload parts.
+ * Used only for auth flow where exchange token is present.
+ */
 export declare const TELEGRAM_AUTH_PAYLOAD_SEPARATOR: ".";

package/build/v1/telegram-auth/constants/telegram-auth.constants.js

@@ -1,6 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TELEGRAM_AUTH_PAYLOAD_SEPARATOR = exports.TELEGRAM_AUTH_CODE_PREFIX = void 0;
+/**
+ * Prefix for Telegram auth deep link payload.
+ * Used to identify auth/link requests when user clicks bot link.
+ * Examples:
+ * - auth flow: telegram.me/BotName?start=auth_<authCode>.<exchangeToken>
+ * - link flow: telegram.me/BotName?start=auth_<authCode>
+ */
 exports.TELEGRAM_AUTH_CODE_PREFIX = 'auth_';
+/**
+ * Separator for telegram deep-link payload parts.
+ * Used only for auth flow where exchange token is present.
+ */
 exports.TELEGRAM_AUTH_PAYLOAD_SEPARATOR = '.';
 //# sourceMappingURL=telegram-auth.constants.js.map

package/build/v1/telegram-auth/constants/telegram-auth.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"telegram-auth.constants.js","sourceRoot":"","sources":["../../../../v1/telegram-auth/constants/telegram-auth.constants.ts"],"names":[],"mappings":";;;AAOa,QAAA,yBAAyB,GAAG,OAAgB,CAAC;AAM7C,QAAA,+BAA+B,GAAG,GAAY,CAAC"}
+{"version":3,"file":"telegram-auth.constants.js","sourceRoot":"","sources":["../../../../v1/telegram-auth/constants/telegram-auth.constants.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACU,QAAA,yBAAyB,GAAG,OAAgB,CAAC;AAE1D;;;GAGG;AACU,QAAA,+BAA+B,GAAG,GAAY,CAAC"}

package/build/v1/telegram-auth/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./telegram-auth.errors"), exports);
 __exportStar(require("./commands"), exports);
 __exportStar(require("./queries"), exports);
 __exportStar(require("./constants"), exports);
+// Re-export from centralized locations
 var controllers_1 = require("../../controllers");
 Object.defineProperty(exports, "TELEGRAM_AUTH_CONTROLLER", { enumerable: true, get: function () { return controllers_1.TELEGRAM_AUTH_CONTROLLER; } });
 var routes_1 = require("../../routes");

package/build/v1/telegram-auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/telegram-auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,yDAAuC;AACvC,6CAA2B;AAC3B,4CAA0B;AAC1B,8CAA4B;AAE5B,iDAA6D;AAApD,uHAAA,wBAAwB,OAAA;AACjC,uCAAoD;AAA3C,8GAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/telegram-auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,yDAAuC;AACvC,6CAA2B;AAC3B,4CAA0B;AAC1B,8CAA4B;AAC5B,uCAAuC;AACvC,iDAA6D;AAApD,uHAAA,wBAAwB,OAAA;AACjC,uCAAoD;AAA3C,8GAAA,oBAAoB,OAAA"}

package/build/v1/telegram-auth/queries/get-telegram-auth-status.query.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Get Telegram Auth Status Query
+ * GET /api/v1/auth/telegram/status/:uuid
+ */
 export declare namespace GetTelegramAuthStatusQuery {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{

package/build/v1/telegram-auth/queries/get-telegram-auth-status.query.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Get Telegram Auth Status Query
+ * GET /api/v1/auth/telegram/status/:uuid
+ */
 var GetTelegramAuthStatusQuery;
 (function (GetTelegramAuthStatusQuery) {
     GetTelegramAuthStatusQuery.Request = zod_1.z.object({});

package/build/v1/telegram-auth/queries/get-telegram-auth-status.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-telegram-auth-status.query.js","sourceRoot":"","sources":["../../../../v1/telegram-auth/queries/get-telegram-auth-status.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA8D;AAC9D,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,0BAA0B,CAS1C;AATD,WAAiB,0BAA0B;IAC1B,kCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,mCAAQ,GAAG,0CAAgC,CAAC;IAE5C,8BAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtE,iCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,0BAA0B,0CAA1B,0BAA0B,QAS1C"}
+{"version":3,"file":"get-telegram-auth-status.query.js","sourceRoot":"","sources":["../../../../v1/telegram-auth/queries/get-telegram-auth-status.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA8D;AAC9D,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,0BAA0B,CAS1C;AATD,WAAiB,0BAA0B;IAC1B,kCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,mCAAQ,GAAG,0CAAgC,CAAC;IAE5C,8BAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtE,iCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,0BAA0B,0CAA1B,0BAA0B,QAS1C"}

package/build/v1/telegram-profile/admin/schemas/admin-unlink.schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Identifier of the row that was soft-deleted. The HTTP status
+ * carries success/failure — payload only conveys *what* changed.
+ */
 export declare const AdminUnlinkTelegramResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
 }, z.core.$strip>;

package/build/v1/telegram-profile/admin/schemas/admin-unlink.schema.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdminUnlinkTelegramResponseSchema = void 0;
 const zod_1 = require("zod");
 const regex_1 = require("../../../../shared/regex");
+/**
+ * Identifier of the row that was soft-deleted. The HTTP status
+ * carries success/failure — payload only conveys *what* changed.
+ */
 exports.AdminUnlinkTelegramResponseSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(regex_1.UUID_REGEX),
 });

package/build/v1/telegram-profile/admin/schemas/admin-unlink.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-unlink.schema.js","sourceRoot":"","sources":["../../../../../v1/telegram-profile/admin/schemas/admin-unlink.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oDAAsD;AAMzC,QAAA,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;CACrC,CAAC,CAAC"}
+{"version":3,"file":"admin-unlink.schema.js","sourceRoot":"","sources":["../../../../../v1/telegram-profile/admin/schemas/admin-unlink.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oDAAsD;AAEtD;;;GAGG;AACU,QAAA,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;CACrC,CAAC,CAAC"}

package/build/v1/telegram-profile/commands/link-telegram.command.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Link Telegram Command
+ * POST /api/v1/profiles/telegram/link
+ */
 export declare namespace LinkTelegramCommand {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{

package/build/v1/telegram-profile/commands/link-telegram.command.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Link Telegram Command
+ * POST /api/v1/profiles/telegram/link
+ */
 var LinkTelegramCommand;
 (function (LinkTelegramCommand) {
     LinkTelegramCommand.Request = zod_1.z.object({});

package/build/v1/telegram-profile/commands/link-telegram.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"link-telegram.command.js","sourceRoot":"","sources":["../../../../v1/telegram-profile/commands/link-telegram.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAwD;AACxD,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,mBAAmB,CASnC;AATD,WAAiB,mBAAmB;IACnB,2BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,4BAAQ,GAAG,oCAA0B,CAAC;IAEtC,uBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;IAC5C,0BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,mBAAmB,mCAAnB,mBAAmB,QASnC"}
+{"version":3,"file":"link-telegram.command.js","sourceRoot":"","sources":["../../../../v1/telegram-profile/commands/link-telegram.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAAwD;AACxD,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,mBAAmB,CASnC;AATD,WAAiB,mBAAmB;IACnB,2BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,4BAAQ,GAAG,oCAA0B,CAAC;IAEtC,uBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;IAC5C,0BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;AAI1C,CAAC,EATgB,mBAAmB,mCAAnB,mBAAmB,QASnC"}

package/build/v1/telegram-profile/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./schemas"), exports);
 __exportStar(require("./commands"), exports);
 __exportStar(require("./queries"), exports);
 __exportStar(require("./admin"), exports);
+// Re-export from centralized locations
 var controllers_1 = require("../../controllers");
 Object.defineProperty(exports, "TELEGRAM_PROFILE_CONTROLLER", { enumerable: true, get: function () { return controllers_1.TELEGRAM_PROFILE_CONTROLLER; } });
 var routes_1 = require("../../routes");

package/build/v1/telegram-profile/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/telegram-profile/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,4CAA0B;AAC1B,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AAExB,iDAAgE;AAAvD,0HAAA,2BAA2B,OAAA;AACpC,uCAAuD;AAA9C,iHAAA,uBAAuB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/telegram-profile/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,4CAA0B;AAC1B,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,uCAAuC;AACvC,iDAAgE;AAAvD,0HAAA,2BAA2B,OAAA;AACpC,uCAAuD;AAA9C,iHAAA,uBAAuB,OAAA"}

package/build/v1/telegram-profile/queries/get-telegram-link-status.query.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Get Telegram Link Status Query
+ * GET /api/v1/profiles/telegram/link/:uuid
+ */
 export declare namespace GetTelegramLinkStatusQuery {
     const Response: z.ZodObject<{
         status: z.ZodEnum<typeof import("../..").TelegramAuthStatus>;

package/build/v1/telegram-profile/queries/get-telegram-link-status.query.js

@@ -4,6 +4,10 @@ exports.GetTelegramLinkStatusQuery = void 0;
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Get Telegram Link Status Query
+ * GET /api/v1/profiles/telegram/link/:uuid
+ */
 var GetTelegramLinkStatusQuery;
 (function (GetTelegramLinkStatusQuery) {
     GetTelegramLinkStatusQuery.Response = schemas_1.TelegramLinkStatusResponseSchema;

package/build/v1/telegram-profile/queries/get-telegram-link-status.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-telegram-link-status.query.js","sourceRoot":"","sources":["../../../../v1/telegram-profile/queries/get-telegram-link-status.query.ts"],"names":[],"mappings":";;;AACA,wCAA8D;AAC9D,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,0BAA0B,CAO1C;AAPD,WAAiB,0BAA0B;IAC1B,mCAAQ,GAAG,0CAAgC,CAAC;IAE5C,8BAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3E,iCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,0BAA0B,0CAA1B,0BAA0B,QAO1C"}
+{"version":3,"file":"get-telegram-link-status.query.js","sourceRoot":"","sources":["../../../../v1/telegram-profile/queries/get-telegram-link-status.query.ts"],"names":[],"mappings":";;;AACA,wCAA8D;AAC9D,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,0BAA0B,CAO1C;AAPD,WAAiB,0BAA0B;IAC1B,mCAAQ,GAAG,0CAAgC,CAAC;IAE5C,8BAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3E,iCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,0BAA0B,0CAA1B,0BAA0B,QAO1C"}

package/build/v1/telegram-profile/queries/get-telegram-profile.query.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Get Telegram Profile Query
+ * GET /api/v1/profiles/telegram
+ */
 export declare namespace GetTelegramProfileQuery {
     const Response: z.ZodObject<{
         telegramId: z.ZodString;

package/build/v1/telegram-profile/queries/get-telegram-profile.query.js

@@ -4,6 +4,10 @@ exports.GetTelegramProfileQuery = void 0;
 const schemas_1 = require("../schemas");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 const rest_api_1 = require("../../../rest-api");
+/**
+ * Get Telegram Profile Query
+ * GET /api/v1/profiles/telegram
+ */
 var GetTelegramProfileQuery;
 (function (GetTelegramProfileQuery) {
     GetTelegramProfileQuery.Response = schemas_1.TelegramProfileResponseSchema;

package/build/v1/telegram-profile/queries/get-telegram-profile.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-telegram-profile.query.js","sourceRoot":"","sources":["../../../../v1/telegram-profile/queries/get-telegram-profile.query.ts"],"names":[],"mappings":";;;AACA,wCAA2D;AAC3D,uEAA8D;AAC9D,gDAA6C;AAM7C,IAAiB,uBAAuB,CAOvC;AAPD,WAAiB,uBAAuB;IACvB,gCAAQ,GAAG,uCAA6B,CAAC;IAEzC,2BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC;IACnD,8BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,uBAAuB,uCAAvB,uBAAuB,QAOvC"}
+{"version":3,"file":"get-telegram-profile.query.js","sourceRoot":"","sources":["../../../../v1/telegram-profile/queries/get-telegram-profile.query.ts"],"names":[],"mappings":";;;AACA,wCAA2D;AAC3D,uEAA8D;AAC9D,gDAA6C;AAE7C;;;GAGG;AACH,IAAiB,uBAAuB,CAOvC;AAPD,WAAiB,uBAAuB;IACvB,gCAAQ,GAAG,uCAA6B,CAAC;IAEzC,2BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC;IACnD,8BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EAPgB,uBAAuB,uCAAvB,uBAAuB,QAOvC"}

package/build/v1/tool/sandbox/code-execution-language.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Languages supported by the code-execution sandbox.
+ */
 export declare enum CodeExecutionLanguage {
     PYTHON = "PYTHON",
     BASH = "BASH"

package/build/v1/tool/sandbox/code-execution-language.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodeExecutionLanguage = void 0;
+/**
+ * Languages supported by the code-execution sandbox.
+ */
 var CodeExecutionLanguage;
 (function (CodeExecutionLanguage) {
     CodeExecutionLanguage["PYTHON"] = "PYTHON";

package/build/v1/tool/sandbox/code-execution-language.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-execution-language.enum.js","sourceRoot":"","sources":["../../../../v1/tool/sandbox/code-execution-language.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC7B,0CAAiB,CAAA;IACjB,sCAAa,CAAA;AACjB,CAAC,EAHW,qBAAqB,qCAArB,qBAAqB,QAGhC"}
+{"version":3,"file":"code-execution-language.enum.js","sourceRoot":"","sources":["../../../../v1/tool/sandbox/code-execution-language.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC7B,0CAAiB,CAAA;IACjB,sCAAa,CAAA;AACjB,CAAC,EAHW,qBAAqB,qCAArB,qBAAqB,QAGhC"}

package/build/v1/tool/sandbox/code-execution-outcome-kind.enum.d.ts

@@ -1,5 +1,11 @@
+/**
+ * Discriminant for the RunCodeOutcome union.
+ * Distinguishes between a successful execution and a runtime error
+ * in the user's code (both are Result.ok — only infra failures use Result.fail).
+ */
 export declare enum CodeExecutionOutcomeKind {
     SUCCESS = "SUCCESS",
     RUNTIME_ERROR = "RUNTIME_ERROR",
+    /** Execution exceeded the wall-clock timeout. Partial stdout may be present. */
     TIMEOUT = "TIMEOUT"
 }

package/build/v1/tool/sandbox/code-execution-outcome-kind.enum.js

@@ -1,10 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodeExecutionOutcomeKind = void 0;
+/**
+ * Discriminant for the RunCodeOutcome union.
+ * Distinguishes between a successful execution and a runtime error
+ * in the user's code (both are Result.ok — only infra failures use Result.fail).
+ */
 var CodeExecutionOutcomeKind;
 (function (CodeExecutionOutcomeKind) {
     CodeExecutionOutcomeKind["SUCCESS"] = "SUCCESS";
     CodeExecutionOutcomeKind["RUNTIME_ERROR"] = "RUNTIME_ERROR";
+    /** Execution exceeded the wall-clock timeout. Partial stdout may be present. */
     CodeExecutionOutcomeKind["TIMEOUT"] = "TIMEOUT";
 })(CodeExecutionOutcomeKind || (exports.CodeExecutionOutcomeKind = CodeExecutionOutcomeKind = {}));
 //# sourceMappingURL=code-execution-outcome-kind.enum.js.map

package/build/v1/tool/sandbox/code-execution-outcome-kind.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-execution-outcome-kind.enum.js","sourceRoot":"","sources":["../../../../v1/tool/sandbox/code-execution-outcome-kind.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAChC,+CAAmB,CAAA;IACnB,2DAA+B,CAAA;IAE/B,+CAAmB,CAAA;AACvB,CAAC,EALW,wBAAwB,wCAAxB,wBAAwB,QAKnC"}
+{"version":3,"file":"code-execution-outcome-kind.enum.js","sourceRoot":"","sources":["../../../../v1/tool/sandbox/code-execution-outcome-kind.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAChC,+CAAmB,CAAA;IACnB,2DAA+B,CAAA;IAC/B,gFAAgF;IAChF,+CAAmB,CAAA;AACvB,CAAC,EALW,wBAAwB,wCAAxB,wBAAwB,QAKnC"}

package/build/v1/tool/sandbox/code-execution.errors.d.ts

@@ -1,9 +1,25 @@
 import { ErrorMetadata } from '../../../shared';
+/**
+ * Error codes for the code execution tool.
+ *
+ * IMPORTANT: these codes are reserved for INFRASTRUCTURE failures only
+ * (sandbox creation failed, e2b unreachable, timeout, file upload/download failed).
+ *
+ * Runtime errors produced by the user-supplied code (Python tracebacks,
+ * bash non-zero exit codes, syntax errors) are NOT represented here — they are
+ * returned as a successful Result with the traceback embedded in the outcome,
+ * so the LLM can see them and self-correct.
+ */
 export declare enum CodeExecutionErrorCode {
+    /** Generic infrastructure failure for sandbox creation / e2b API error. */
     CODE_EXECUTION_FAILED = "CODE_EXECUTION_FAILED",
+    /** Execution exceeded the configured wall-clock timeout. */
     CODE_EXECUTION_TIMEOUT = "CODE_EXECUTION_TIMEOUT",
+    /** The caller already has the maximum number of active sandboxes. */
     CODE_EXECUTION_TOO_MANY_SANDBOXES = "CODE_EXECUTION_TOO_MANY_SANDBOXES",
+    /** An input attachment does not belong to the caller / chat. */
     CODE_EXECUTION_INPUT_FILE_FORBIDDEN = "CODE_EXECUTION_INPUT_FILE_FORBIDDEN",
+    /** Failed to upload an input file into the sandbox filesystem. */
     CODE_EXECUTION_FILE_UPLOAD_FAILED = "CODE_EXECUTION_FILE_UPLOAD_FAILED"
 }
 export declare const CODE_EXECUTION_ERRORS: Record<CodeExecutionErrorCode, ErrorMetadata>;

package/build/v1/tool/sandbox/code-execution.errors.js

@@ -1,12 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CODE_EXECUTION_ERRORS = exports.CodeExecutionErrorCode = void 0;
+/**
+ * Error codes for the code execution tool.
+ *
+ * IMPORTANT: these codes are reserved for INFRASTRUCTURE failures only
+ * (sandbox creation failed, e2b unreachable, timeout, file upload/download failed).
+ *
+ * Runtime errors produced by the user-supplied code (Python tracebacks,
+ * bash non-zero exit codes, syntax errors) are NOT represented here — they are
+ * returned as a successful Result with the traceback embedded in the outcome,
+ * so the LLM can see them and self-correct.
+ */
 var CodeExecutionErrorCode;
 (function (CodeExecutionErrorCode) {
+    /** Generic infrastructure failure for sandbox creation / e2b API error. */
     CodeExecutionErrorCode["CODE_EXECUTION_FAILED"] = "CODE_EXECUTION_FAILED";
+    /** Execution exceeded the configured wall-clock timeout. */
     CodeExecutionErrorCode["CODE_EXECUTION_TIMEOUT"] = "CODE_EXECUTION_TIMEOUT";
+    /** The caller already has the maximum number of active sandboxes. */
     CodeExecutionErrorCode["CODE_EXECUTION_TOO_MANY_SANDBOXES"] = "CODE_EXECUTION_TOO_MANY_SANDBOXES";
+    /** An input attachment does not belong to the caller / chat. */
     CodeExecutionErrorCode["CODE_EXECUTION_INPUT_FILE_FORBIDDEN"] = "CODE_EXECUTION_INPUT_FILE_FORBIDDEN";
+    /** Failed to upload an input file into the sandbox filesystem. */
     CodeExecutionErrorCode["CODE_EXECUTION_FILE_UPLOAD_FAILED"] = "CODE_EXECUTION_FILE_UPLOAD_FAILED";
 })(CodeExecutionErrorCode || (exports.CodeExecutionErrorCode = CodeExecutionErrorCode = {}));
 exports.CODE_EXECUTION_ERRORS = {

package/build/v1/tool/sandbox/code-execution.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-execution.errors.js","sourceRoot":"","sources":["../../../../v1/tool/sandbox/code-execution.errors.ts"],"names":[],"mappings":";;;AAaA,IAAY,sBAWX;AAXD,WAAY,sBAAsB;IAE9B,yEAA+C,CAAA;IAE/C,2EAAiD,CAAA;IAEjD,iGAAuE,CAAA;IAEvE,qGAA2E,CAAA;IAE3E,iGAAuE,CAAA;AAC3E,CAAC,EAXW,sBAAsB,sCAAtB,sBAAsB,QAWjC;AAEY,QAAA,qBAAqB,GAAkD;IAChF,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,EAAE;QAC5C,IAAI,EAAE,sBAAsB,CAAC,qBAAqB;QAClD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,EAAE;QAC7C,IAAI,EAAE,sBAAsB,CAAC,sBAAsB;QACnD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,sBAAsB,CAAC,iCAAiC,CAAC,EAAE;QACxD,IAAI,EAAE,sBAAsB,CAAC,iCAAiC;QAC9D,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,sBAAsB,CAAC,mCAAmC,CAAC,EAAE;QAC1D,IAAI,EAAE,sBAAsB,CAAC,mCAAmC;QAChE,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,sBAAsB,CAAC,iCAAiC,CAAC,EAAE;QACxD,IAAI,EAAE,sBAAsB,CAAC,iCAAiC;QAC9D,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}
+{"version":3,"file":"code-execution.errors.js","sourceRoot":"","sources":["../../../../v1/tool/sandbox/code-execution.errors.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;GAUG;AACH,IAAY,sBAWX;AAXD,WAAY,sBAAsB;IAC9B,2EAA2E;IAC3E,yEAA+C,CAAA;IAC/C,4DAA4D;IAC5D,2EAAiD,CAAA;IACjD,qEAAqE;IACrE,iGAAuE,CAAA;IACvE,gEAAgE;IAChE,qGAA2E,CAAA;IAC3E,kEAAkE;IAClE,iGAAuE,CAAA;AAC3E,CAAC,EAXW,sBAAsB,sCAAtB,sBAAsB,QAWjC;AAEY,QAAA,qBAAqB,GAAkD;IAChF,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,EAAE;QAC5C,IAAI,EAAE,sBAAsB,CAAC,qBAAqB;QAClD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,EAAE;QAC7C,IAAI,EAAE,sBAAsB,CAAC,sBAAsB;QACnD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,sBAAsB,CAAC,iCAAiC,CAAC,EAAE;QACxD,IAAI,EAAE,sBAAsB,CAAC,iCAAiC;QAC9D,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,sBAAsB,CAAC,mCAAmC,CAAC,EAAE;QAC1D,IAAI,EAAE,sBAAsB,CAAC,mCAAmC;QAChE,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,sBAAsB,CAAC,iCAAiC,CAAC,EAAE;QACxD,IAAI,EAAE,sBAAsB,CAAC,iCAAiC;QAC9D,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}