@playcraft/common 0.0.55 → 0.0.57

package/dist/agent/openai-responses-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses-api.d.ts","sourceRoot":"","sources":["../../src/agent/openai-responses-api.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,yCAAyC,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI9E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGlE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnE"}

package/dist/agent/openai-responses-api.js

@@ -0,0 +1,28 @@
+export const IEGG_LITELLM_DEFAULT_URL = 'https://litellm.ai.levelinfinite.com';
+/**
+ * IEGG LiteLLM 官方入口是 `/v1/chat/completions`、`/v1/responses`。
+ * AI SDK 会把路径接在 baseURL 后面，所以 baseURL 必须自带 `/v1`，
+ * 否则会打到 `/chat/completions`、`/responses`。
+ */
+export function normalizeIeggLiteLLMBaseUrl(apiBaseUrl) {
+    const raw = apiBaseUrl?.trim() || IEGG_LITELLM_DEFAULT_URL;
+    const trimmed = raw.replace(/\/+$/, '');
+    return trimmed.endsWith('/v1') ? trimmed : `${trimmed}/v1`;
+}
+/**
+ * GPT chat/reasoning 模型走 `/v1/responses`（`input`），Claude 等代理模型仍走
+ * `/v1/chat/completions`（`messages`）。
+ */
+export function shouldUseOpenAIResponsesApi(model) {
+    const normalized = (model.split('/').pop() ?? model).toLowerCase();
+    return /^gpt-\d/.test(normalized);
+}
+/**
+ * OpenCode 仍走 openai-compatible Chat Completions。Azure gpt-6 + tools
+ * 在这条链路上必须显式 `reasoning_effort=none`。
+ */
+export function shouldForceChatReasoningNone(model) {
+    const normalized = (model.split('/').pop() ?? model).toLowerCase();
+    return /^gpt-6/.test(normalized);
+}
+//# sourceMappingURL=openai-responses-api.js.map

package/dist/agent/openai-responses-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses-api.js","sourceRoot":"","sources":["../../src/agent/openai-responses-api.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sCAAsC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,UAA0B;IACpE,MAAM,GAAG,GAAG,UAAU,EAAE,IAAI,EAAE,IAAI,wBAAwB,CAAC;IAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACnE,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACnE,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC"}

package/dist/agent/reference-images.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Shared sandbox protocol for user-attached reference images.
+ *
+ * Remix, Portal, OpenCode, CLI, and the remix editor must agree on:
+ * directory, allowed MIME (Multipurpose Internet Mail Extensions, 多用途互联网邮件扩展)
+ * types, prompt markers, and generate-image count. Do not copy these literals
+ * into feature packages.
+ */
+/** Project-relative directory. Absolute path = `{workDir}/{this}/{fileName}`. */
+export declare const REFERENCE_IMAGE_RELATIVE_DIR = "tmp/opencode-images";
+/** Prefix used by git exclude / change-gate ignore lists. */
+export declare const REFERENCE_IMAGE_GIT_IGNORE_PATH = "tmp/opencode-images/";
+/**
+ * Per-sandbox download cache, deliberately outside every project tree so no
+ * git exclude / change-gate entry is needed for it.
+ *
+ * File names are content-addressed, so a batch of variants downloads each
+ * attachment from object storage once and then copies inside the sandbox.
+ */
+export declare const REFERENCE_IMAGE_STAGING_ROOT = "/tmp/playcraft-reference-images";
+/** Gemini / `playcraft-generate-image` hard cap. */
+export declare const REFERENCE_IMAGE_MAX_COUNT = 8;
+/** Remix editor + CLI prompt marker. */
+export declare const REFERENCE_IMAGES_MARKER = "[Reference Images]";
+/** Portal Manager / Executor sandbox-path notice. */
+export declare const SANDBOX_REFERENCE_IMAGES_MARKER = "[Sandbox Reference Images]";
+export declare const OPENCODE_REFERENCE_IMAGES_HEADING = "## User reference images";
+/** Legacy remix UI copy; still stripped from stored prompts. */
+export declare const LEGACY_ZH_REFERENCE_IMAGES_MARKER = "[\u53C2\u8003\u56FE\u7247]";
+export declare const REFERENCE_IMAGE_MIME_TO_EXT: {
+    readonly 'image/jpeg': ".jpg";
+    readonly 'image/png': ".png";
+    readonly 'image/gif': ".gif";
+    readonly 'image/webp': ".webp";
+};
+export type ReferenceImageMimeType = keyof typeof REFERENCE_IMAGE_MIME_TO_EXT;
+/** HTML `<input accept>` for Remix / Portal attachment pickers. */
+export declare const REFERENCE_IMAGE_ACCEPT_ATTRIBUTE: string;
+export declare function isReferenceImageMime(mimeType: string): boolean;
+/** Canonical extension for sandbox / object-storage filenames (`.jpeg` → `.jpg`). */
+export declare function referenceImageExtension(mimeType: string): string | undefined;
+export declare function referenceImageMimeFromExtension(ext: string): string | undefined;
+export declare function referenceImageExtensions(): readonly string[];
+export declare function resolveReferenceImageDir(workDir: string): string;
+export declare function buildReferenceImageRelativePath(fileName: string): string;
+export declare function resolveReferenceImagePath(workDir: string, fileName: string): string;
+export declare function resolveReferenceImageStagingDir(sessionId: string): string;
+export declare function resolveReferenceImageStagingPath(sessionId: string, fileName: string): string;
+export declare function isReferenceImageSandboxPath(value: string): boolean;
+export declare function extractReferenceImagePathFromPromptLine(line: string): string | null;
+export declare function splitReferenceImagePromptSection(text: string): {
+    userText: string;
+    section: string | null;
+};
+export declare function stripReferenceImagePromptSection(text: string): string;
+export declare function extractReferenceImagePathsFromPrompt(text: string): string[];
+export type ReferenceImageDigest = {
+    sha256: string;
+    mimeType: string;
+};
+/** Content-addressed sandbox file name: `{sha256[:16]}{ext}`. */
+export declare function referenceImageFileName(attachment: ReferenceImageDigest): string;
+export declare function matchReferenceImageAttachment<T extends ReferenceImageDigest>(sandboxPath: string, attachments: readonly T[]): T | undefined;
+export declare function buildRemixReferenceImagesSection(sandboxPaths: string[]): string;
+export declare function appendRemixReferenceImagesPrompt(userText: string, sandboxPaths: string[]): string;
+//# sourceMappingURL=reference-images.d.ts.map

package/dist/agent/reference-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-images.d.ts","sourceRoot":"","sources":["../../src/agent/reference-images.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAElE,6DAA6D;AAC7D,eAAO,MAAM,+BAA+B,yBAAqC,CAAC;AAElF;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,oCAAoC,CAAC;AAE9E,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAE5D,qDAAqD;AACrD,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAE5E,eAAO,MAAM,iCAAiC,6BAA6B,CAAC;AAE5E,gEAAgE;AAChE,eAAO,MAAM,iCAAiC,+BAAW,CAAC;AAE1D,eAAO,MAAM,2BAA2B;;;;;CAK9B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAE9E,mEAAmE;AACnE,eAAO,MAAM,gCAAgC,QAElC,CAAC;AAeZ,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK9D;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO/E;AAED,wBAAgB,wBAAwB,IAAI,SAAS,MAAM,EAAE,CAE5D;AAQD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUlE;AAED,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnF;AASD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAYA;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS3E;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAK/E;AAED,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,oBAAoB,EAC1E,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,SAAS,CAAC,EAAE,GACxB,CAAC,GAAG,SAAS,CAIf;AAED,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAqB/E;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,CAIR"}

package/dist/agent/reference-images.js

@@ -0,0 +1,181 @@
+/**
+ * Shared sandbox protocol for user-attached reference images.
+ *
+ * Remix, Portal, OpenCode, CLI, and the remix editor must agree on:
+ * directory, allowed MIME (Multipurpose Internet Mail Extensions, 多用途互联网邮件扩展)
+ * types, prompt markers, and generate-image count. Do not copy these literals
+ * into feature packages.
+ */
+/** Project-relative directory. Absolute path = `{workDir}/{this}/{fileName}`. */
+export const REFERENCE_IMAGE_RELATIVE_DIR = 'tmp/opencode-images';
+/** Prefix used by git exclude / change-gate ignore lists. */
+export const REFERENCE_IMAGE_GIT_IGNORE_PATH = `${REFERENCE_IMAGE_RELATIVE_DIR}/`;
+/**
+ * Per-sandbox download cache, deliberately outside every project tree so no
+ * git exclude / change-gate entry is needed for it.
+ *
+ * File names are content-addressed, so a batch of variants downloads each
+ * attachment from object storage once and then copies inside the sandbox.
+ */
+export const REFERENCE_IMAGE_STAGING_ROOT = '/tmp/playcraft-reference-images';
+/** Gemini / `playcraft-generate-image` hard cap. */
+export const REFERENCE_IMAGE_MAX_COUNT = 8;
+/** Remix editor + CLI prompt marker. */
+export const REFERENCE_IMAGES_MARKER = '[Reference Images]';
+/** Portal Manager / Executor sandbox-path notice. */
+export const SANDBOX_REFERENCE_IMAGES_MARKER = '[Sandbox Reference Images]';
+export const OPENCODE_REFERENCE_IMAGES_HEADING = '## User reference images';
+/** Legacy remix UI copy; still stripped from stored prompts. */
+export const LEGACY_ZH_REFERENCE_IMAGES_MARKER = '[参考图片]';
+export const REFERENCE_IMAGE_MIME_TO_EXT = {
+    'image/jpeg': '.jpg',
+    'image/png': '.png',
+    'image/gif': '.gif',
+    'image/webp': '.webp',
+};
+/** HTML `<input accept>` for Remix / Portal attachment pickers. */
+export const REFERENCE_IMAGE_ACCEPT_ATTRIBUTE = Object.keys(REFERENCE_IMAGE_MIME_TO_EXT).join(',');
+const JPEG_MIME = 'image/jpeg';
+function normalizeMime(mimeType) {
+    const mime = mimeType.trim().toLowerCase();
+    return mime === 'image/jpg' ? JPEG_MIME : mime;
+}
+function normalizeExtension(ext) {
+    const trimmed = ext.trim().toLowerCase();
+    if (!trimmed)
+        return '';
+    return trimmed.startsWith('.') ? trimmed : `.${trimmed}`;
+}
+export function isReferenceImageMime(mimeType) {
+    return Object.prototype.hasOwnProperty.call(REFERENCE_IMAGE_MIME_TO_EXT, normalizeMime(mimeType));
+}
+/** Canonical extension for sandbox / object-storage filenames (`.jpeg` → `.jpg`). */
+export function referenceImageExtension(mimeType) {
+    const mime = normalizeMime(mimeType);
+    return REFERENCE_IMAGE_MIME_TO_EXT[mime];
+}
+export function referenceImageMimeFromExtension(ext) {
+    const normalized = normalizeExtension(ext);
+    if (normalized === '.jpeg')
+        return JPEG_MIME;
+    for (const [mime, mapped] of Object.entries(REFERENCE_IMAGE_MIME_TO_EXT)) {
+        if (mapped === normalized)
+            return mime;
+    }
+    return undefined;
+}
+export function referenceImageExtensions() {
+    return ['.jpg', '.jpeg', '.png', '.gif', '.webp'];
+}
+function joinPosix(root, ...segments) {
+    const base = root.replace(/\/+$/, '');
+    const rest = segments.map((segment) => segment.replace(/^\/+|\/+$/g, '')).filter(Boolean);
+    return [base, ...rest].join('/');
+}
+export function resolveReferenceImageDir(workDir) {
+    return joinPosix(workDir, REFERENCE_IMAGE_RELATIVE_DIR);
+}
+export function buildReferenceImageRelativePath(fileName) {
+    return `${REFERENCE_IMAGE_RELATIVE_DIR}/${fileName.replace(/^\/+/, '')}`;
+}
+export function resolveReferenceImagePath(workDir, fileName) {
+    return joinPosix(workDir, buildReferenceImageRelativePath(fileName));
+}
+export function resolveReferenceImageStagingDir(sessionId) {
+    return joinPosix(REFERENCE_IMAGE_STAGING_ROOT, sessionId);
+}
+export function resolveReferenceImageStagingPath(sessionId, fileName) {
+    return joinPosix(resolveReferenceImageStagingDir(sessionId), fileName);
+}
+export function isReferenceImageSandboxPath(value) {
+    const path = value.trim().replace(/\\/g, '/').replace(/^[-*]\s+/, '');
+    const dir = REFERENCE_IMAGE_RELATIVE_DIR;
+    return (path === dir ||
+        path === `/${dir}` ||
+        path.startsWith(`${dir}/`) ||
+        path.startsWith(`/${dir}/`) ||
+        path.includes(`/${dir}/`));
+}
+export function extractReferenceImagePathFromPromptLine(line) {
+    const trimmed = line.trim().replace(/^[-*]\s+/, '');
+    return isReferenceImageSandboxPath(trimmed) ? trimmed : null;
+}
+const PROMPT_SECTION_MARKERS = [
+    REFERENCE_IMAGES_MARKER,
+    SANDBOX_REFERENCE_IMAGES_MARKER,
+    OPENCODE_REFERENCE_IMAGES_HEADING,
+    LEGACY_ZH_REFERENCE_IMAGES_MARKER,
+];
+export function splitReferenceImagePromptSection(text) {
+    let cut = -1;
+    for (const marker of PROMPT_SECTION_MARKERS) {
+        const needle = `\n\n${marker}`;
+        const idx = text.lastIndexOf(needle);
+        if (idx > cut)
+            cut = idx;
+    }
+    if (cut < 0)
+        return { userText: text, section: null };
+    return {
+        userText: text.slice(0, cut).trimEnd(),
+        section: text.slice(cut),
+    };
+}
+export function stripReferenceImagePromptSection(text) {
+    return splitReferenceImagePromptSection(text).userText;
+}
+export function extractReferenceImagePathsFromPrompt(text) {
+    const { section } = splitReferenceImagePromptSection(text);
+    if (!section)
+        return [];
+    const paths = [];
+    for (const line of section.split('\n')) {
+        const path = extractReferenceImagePathFromPromptLine(line);
+        if (path)
+            paths.push(path);
+    }
+    return paths;
+}
+/** Content-addressed sandbox file name: `{sha256[:16]}{ext}`. */
+export function referenceImageFileName(attachment) {
+    const digest = attachment.sha256.replace(/[^a-fA-F0-9]/g, '').toLowerCase();
+    const stem = (digest || 'image').slice(0, 16);
+    const ext = referenceImageExtension(attachment.mimeType) ?? '.png';
+    return `${stem}${ext}`;
+}
+export function matchReferenceImageAttachment(sandboxPath, attachments) {
+    const fileName = sandboxPath.replace(/\\/g, '/').split('/').pop() ?? '';
+    if (!fileName)
+        return undefined;
+    return attachments.find((attachment) => referenceImageFileName(attachment) === fileName);
+}
+export function buildRemixReferenceImagesSection(sandboxPaths) {
+    if (sandboxPaths.length === 0)
+        return '';
+    const pathList = sandboxPaths.map((path) => `- ${path}`).join('\n');
+    return [
+        REFERENCE_IMAGES_MARKER,
+        `The user attached ${sandboxPaths.length} image(s) at these sandbox filesystem paths:`,
+        pathList,
+        '',
+        'These files have already been written to the sandbox filesystem.',
+        '',
+        '**IMPORTANT:** Do NOT read, open, or inspect any of these image files. Do NOT use tools like read_file, cat, or any other file reader on them. The paths themselves are all you need.',
+        '',
+        "Infer each image's purpose from the user's message (e.g. reference for style/composition, UI mockup, screenshot illustrating an issue, asset to import, etc.). For any image you judge to be a visual reference, pass its path directly to `playcraft-generate-image` — do NOT ask the user to confirm, and do NOT attempt to examine the image content first.",
+        '',
+        'When passing references to `playcraft-generate-image`:',
+        '- Put the first reference in `referenceImagePath`, remaining ones in `additionalReferenceImagePaths` as a comma-separated string.',
+        '- Preserve the original order.',
+        `- Up to ${REFERENCE_IMAGE_MAX_COUNT} references total; paths must not contain commas.`,
+        '- Save generated images under `src/theme/draft/assets/` unless the user explicitly asks for another project asset location.',
+        '- When reporting saved image paths back to the user, prefer `/project/<repo-relative-path>` such as `/project/src/theme/draft/assets/level-ref.png`, not the full `/projects/<projectId>/<branch>/...` path.',
+    ].join('\n');
+}
+export function appendRemixReferenceImagesPrompt(userText, sandboxPaths) {
+    const section = buildRemixReferenceImagesSection(sandboxPaths);
+    if (!section)
+        return userText;
+    return userText ? `${userText}\n\n${section}` : section;
+}
+//# sourceMappingURL=reference-images.js.map

package/dist/agent/reference-images.js.map

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

package/dist/agent/runtime-failure.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Classification of runtime turn failures that deserve an actionable message.
+ *
+ * A failed turn's `reason` is shown verbatim in the Portal Agent timeline, so a
+ * transport failure used to reach the user as vendor TLS (Transport Layer
+ * Security, 传输层安全) wording it cannot act on. Turning the recognized cases
+ * into stable codes lets the UI translate them and lets monitoring group them.
+ *
+ * Structural checks only — `@playcraft/common` must not depend on the AI SDK.
+ */
+/** The model gateway never answered: DNS, TCP, or the TLS handshake failed. */
+export declare const RUNTIME_FAILURE_MODEL_GATEWAY_UNREACHABLE = "model_gateway_unreachable";
+export declare const RUNTIME_FAILURE_CODES: readonly ["model_gateway_unreachable"];
+export type RuntimeFailureCode = (typeof RUNTIME_FAILURE_CODES)[number];
+export type RuntimeFailure = {
+    code: RuntimeFailureCode;
+    /** Gateway hostname when the transport reported one; aids ops triage. */
+    host?: string;
+};
+export declare function isRuntimeFailureCode(value: unknown): value is RuntimeFailureCode;
+/**
+ * Returns a code when the failure is one we can give advice about, else `null`
+ * so the caller keeps the original message rather than guessing.
+ */
+export declare function classifyRuntimeFailure(error: unknown): RuntimeFailure | null;
+/**
+ * The string to persist as a turn's failure reason: a stable code when
+ * recognized, otherwise the original message unchanged.
+ */
+export declare function runtimeFailureReason(error: unknown): string;
+//# sourceMappingURL=runtime-failure.d.ts.map

package/dist/agent/runtime-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-failure.d.ts","sourceRoot":"","sources":["../../src/agent/runtime-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,yCAAyC,8BAA8B,CAAC;AAErF,eAAO,MAAM,qBAAqB,wCAAuD,CAAC;AAE1F,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,kBAAkB,CAAC;IACzB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAwCF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAgB5E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI3D"}

package/dist/agent/runtime-failure.js

@@ -0,0 +1,83 @@
+/**
+ * Classification of runtime turn failures that deserve an actionable message.
+ *
+ * A failed turn's `reason` is shown verbatim in the Portal Agent timeline, so a
+ * transport failure used to reach the user as vendor TLS (Transport Layer
+ * Security, 传输层安全) wording it cannot act on. Turning the recognized cases
+ * into stable codes lets the UI translate them and lets monitoring group them.
+ *
+ * Structural checks only — `@playcraft/common` must not depend on the AI SDK.
+ */
+/** The model gateway never answered: DNS, TCP, or the TLS handshake failed. */
+export const RUNTIME_FAILURE_MODEL_GATEWAY_UNREACHABLE = 'model_gateway_unreachable';
+export const RUNTIME_FAILURE_CODES = [RUNTIME_FAILURE_MODEL_GATEWAY_UNREACHABLE];
+/**
+ * Node and undici codes raised before any HTTP response exists. `ECONNRESET`
+ * also covers a stream cut mid-response, which is why a classification always
+ * additionally requires the absence of a status code.
+ */
+const CONNECT_PHASE_CODES = new Set([
+    'EAI_AGAIN',
+    'ECONNABORTED',
+    'ECONNREFUSED',
+    'ECONNRESET',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'ENOTFOUND',
+    'EPIPE',
+    'ETIMEDOUT',
+    'UND_ERR_CONNECT_TIMEOUT',
+    'UND_ERR_SOCKET',
+]);
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : null;
+}
+function stringOrUndefined(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/** `RetryError` hides the real failure in `lastError`; unwrap before matching. */
+function unwrap(error) {
+    let current = asRecord(error);
+    for (let depth = 0; current && depth < 5; depth += 1) {
+        const last = asRecord(current.lastError);
+        if (!last)
+            return current;
+        current = last;
+    }
+    return current;
+}
+export function isRuntimeFailureCode(value) {
+    return RUNTIME_FAILURE_CODES.includes(value);
+}
+/**
+ * Returns a code when the failure is one we can give advice about, else `null`
+ * so the caller keeps the original message rather than guessing.
+ */
+export function classifyRuntimeFailure(error) {
+    const root = unwrap(error);
+    if (!root)
+        return null;
+    // An HTTP status means the gateway answered, so whatever went wrong is not
+    // reachability — a 429 whose socket later reset must not read as "check VPN".
+    if (root.statusCode !== undefined && root.statusCode !== null)
+        return null;
+    const cause = asRecord(root.cause);
+    const code = stringOrUndefined(cause?.code) ?? stringOrUndefined(root.code);
+    if (!code || !CONNECT_PHASE_CODES.has(code))
+        return null;
+    const host = stringOrUndefined(cause?.host) ?? stringOrUndefined(root.host);
+    return host
+        ? { code: RUNTIME_FAILURE_MODEL_GATEWAY_UNREACHABLE, host }
+        : { code: RUNTIME_FAILURE_MODEL_GATEWAY_UNREACHABLE };
+}
+/**
+ * The string to persist as a turn's failure reason: a stable code when
+ * recognized, otherwise the original message unchanged.
+ */
+export function runtimeFailureReason(error) {
+    const classified = classifyRuntimeFailure(error);
+    if (classified)
+        return classified.code;
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=runtime-failure.js.map

package/dist/agent/runtime-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-failure.js","sourceRoot":"","sources":["../../src/agent/runtime-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yCAAyC,GAAG,2BAA2B,CAAC;AAErF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,yCAAyC,CAAU,CAAC;AAU1F;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,WAAW;IACX,cAAc;IACd,cAAc;IACd,YAAY;IACZ,cAAc;IACd,aAAa;IACb,WAAW;IACX,OAAO;IACP,WAAW;IACX,yBAAyB;IACzB,gBAAgB;CACjB,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjG,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,kFAAkF;AAClF,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,OAAO,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,OAAO,CAAC;QAC1B,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,qBAAqB,CAAC,QAAQ,CAAC,KAA2B,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,2EAA2E;IAC3E,8EAA8E;IAC9E,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE3E,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,IAAI,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,OAAO,IAAI;QACT,CAAC,CAAC,EAAE,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE;QAC3D,CAAC,CAAC,EAAE,IAAI,EAAE,yCAAyC,EAAE,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC;IACvC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/agent/session-title.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Canonical default for `agent_sessions.title` (DB column default + createSession).
+ * Keep in sync with `packages/backend/src/core/database/schema.ts` agentSessions.title default.
+ */
+export declare const DEFAULT_AGENT_SESSION_TITLE = "New conversation";
+/** True when title is still a placeholder and safe to auto-replace. */
+export declare function isGenericAgentSessionTitle(title: string | null | undefined): boolean;
+//# sourceMappingURL=session-title.d.ts.map

package/dist/agent/session-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-title.d.ts","sourceRoot":"","sources":["../../src/agent/session-title.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAE9D,uEAAuE;AACvE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMpF"}

package/dist/agent/session-title.js

@@ -0,0 +1,16 @@
+/**
+ * Canonical default for `agent_sessions.title` (DB column default + createSession).
+ * Keep in sync with `packages/backend/src/core/database/schema.ts` agentSessions.title default.
+ */
+export const DEFAULT_AGENT_SESSION_TITLE = 'New conversation';
+/** True when title is still a placeholder and safe to auto-replace. */
+export function isGenericAgentSessionTitle(title) {
+    const normalized = title?.trim() ?? '';
+    if (!normalized)
+        return true;
+    if (normalized.toLowerCase() === DEFAULT_AGENT_SESSION_TITLE.toLowerCase())
+        return true;
+    // Rare leftovers from other providers / legacy clients
+    return /^new session\b/i.test(normalized) || /^untitled\b/i.test(normalized);
+}
+//# sourceMappingURL=session-title.js.map

package/dist/agent/session-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-title.js","sourceRoot":"","sources":["../../src/agent/session-title.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC;AAE9D,uEAAuE;AACvE,MAAM,UAAU,0BAA0B,CAAC,KAAgC;IACzE,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,2BAA2B,CAAC,WAAW,EAAE;QAAE,OAAO,IAAI,CAAC;IACxF,uDAAuD;IACvD,OAAO,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC/E,CAAC"}

package/dist/agent/turn.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const AgentModeSchema: z.ZodEnum<{
+    zero_to_one: "zero_to_one";
+    creative_variant_batch: "creative_variant_batch";
+    competitor_replica: "competitor_replica";
+}>;
+export type AgentModeType = z.infer<typeof AgentModeSchema>;
+//# sourceMappingURL=turn.d.ts.map

package/dist/agent/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../src/agent/turn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/agent/turn.js

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export const AgentModeSchema = z.enum([
+    "zero_to_one",
+    "creative_variant_batch",
+    "competitor_replica",
+]);
+//# sourceMappingURL=turn.js.map

package/dist/agent/turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.js","sourceRoot":"","sources":["../../src/agent/turn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,aAAa;IACb,wBAAwB;IACxB,oBAAoB;CACrB,CAAC,CAAC"}

package/dist/agent-jobs/identity.d.ts

@@ -0,0 +1,8 @@
+import type { AgentExecutionJobData, AgentManagerJobData } from './index.js';
+export declare function buildManagerJobIdentity(sessionId: string, triggeredByMessageId: string): string;
+export declare function buildExecutionJobIdentity(executionId: string): string;
+/** Stable dispatch-table key for idempotent Execution retry requests. */
+export declare function buildExecutionRetryRequestKey(previousExecutionId: string): string;
+export declare function validateManagerJobIdentity(job: AgentManagerJobData): void;
+export declare function validateExecutionJobIdentity(job: AgentExecutionJobData): void;
+//# sourceMappingURL=identity.d.ts.map

package/dist/agent-jobs/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/agent-jobs/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAM7E,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAER;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,yEAAyE;AACzE,wBAAgB,6BAA6B,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAazE;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAK7E"}

package/dist/agent-jobs/identity.js

@@ -0,0 +1,32 @@
+const MANAGER_KEY_PREFIX = 'agent-manager:';
+const EXECUTION_KEY_PREFIX = 'agent-execution:';
+const EXECUTION_RETRY_KEY_PREFIX = 'agent-execution-retry:';
+export function buildManagerJobIdentity(sessionId, triggeredByMessageId) {
+    return `${MANAGER_KEY_PREFIX}${sessionId}:${triggeredByMessageId}`;
+}
+export function buildExecutionJobIdentity(executionId) {
+    return `${EXECUTION_KEY_PREFIX}${executionId}`;
+}
+/** Stable dispatch-table key for idempotent Execution retry requests. */
+export function buildExecutionRetryRequestKey(previousExecutionId) {
+    return `${EXECUTION_RETRY_KEY_PREFIX}${previousExecutionId}`;
+}
+export function validateManagerJobIdentity(job) {
+    const suffix = job.triggeredByMessageId;
+    if (suffix == null) {
+        throw new Error('Manager job requires triggeredByMessageId for idempotency identity');
+    }
+    const expected = buildManagerJobIdentity(job.sessionId, suffix);
+    // Exact match for initial turns; `:hitl:<toolCallId>` suffix for HITL resume dispatches.
+    if (job.idempotencyKey !== expected &&
+        !job.idempotencyKey.startsWith(`${expected}:hitl:`)) {
+        throw new Error('Manager idempotencyKey does not match job identity');
+    }
+}
+export function validateExecutionJobIdentity(job) {
+    const expected = buildExecutionJobIdentity(job.executionId);
+    if (!job.idempotencyKey.startsWith(expected)) {
+        throw new Error('Execution idempotencyKey does not match job identity');
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/agent-jobs/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/agent-jobs/identity.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAC5C,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAChD,MAAM,0BAA0B,GAAG,wBAAwB,CAAC;AAE5D,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,oBAA4B;IAE5B,OAAO,GAAG,kBAAkB,GAAG,SAAS,IAAI,oBAAoB,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,GAAG,oBAAoB,GAAG,WAAW,EAAE,CAAC;AACjD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,6BAA6B,CAAC,mBAA2B;IACvE,OAAO,GAAG,0BAA0B,GAAG,mBAAmB,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAwB;IACjE,MAAM,MAAM,GAAG,GAAG,CAAC,oBAAoB,CAAC;IACxC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChE,yFAAyF;IACzF,IACE,GAAG,CAAC,cAAc,KAAK,QAAQ;QAC/B,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,QAAQ,QAAQ,CAAC,EACnD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,GAA0B;IACrE,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/agent-jobs/index.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const AGENT_JOB_SCHEMA_VERSION: 1;
+export declare const AgentManagerJobDataSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    idempotencyKey: z.ZodString;
+    workspaceId: z.ZodString;
+    sessionId: z.ZodString;
+    taskRunId: z.ZodUUID;
+    triggeredByMessageId: z.ZodOptional<z.ZodString>;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AgentManagerJobData = z.infer<typeof AgentManagerJobDataSchema>;
+export declare const AgentExecutionJobDataSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    idempotencyKey: z.ZodString;
+    workspaceId: z.ZodString;
+    sessionId: z.ZodString;
+    taskRunId: z.ZodUUID;
+    issueId: z.ZodUUID;
+    executionId: z.ZodUUID;
+}, z.core.$strict>;
+export type AgentExecutionJobData = z.infer<typeof AgentExecutionJobDataSchema>;
+export { buildExecutionJobIdentity, buildExecutionRetryRequestKey, buildManagerJobIdentity, validateExecutionJobIdentity, validateManagerJobIdentity, } from './identity.js';
+/** @deprecated Prefer buildExecutionRetryRequestKey from identity.js */
+export declare function buildExecutionRetryKeys(executionId: string): {
+    dispatchKey: string;
+};
+export { isPortalAgentLegacyRunTaskEnabled } from './legacy-run-task.js';
+export { isPortalAgentLegacyHttpGoneEnabled } from './legacy-http-gone.js';
+export { isPortalAgentRuntimeV2Enabled } from './runtime-v2.js';
+export { isPortalAgentSandboxTeamMountEnabled } from './portal-sandbox-team-mount.js';
+export { PORTAL_AGENT_DB_LEASE_MS, PORTAL_AGENT_HEARTBEAT_INTERVAL_MS, PORTAL_AGENT_REDIS_SLOT_TTL_MS, PORTAL_AGENT_SESSION_MUTEX_TTL_MS, PORTAL_AGENT_BULLMQ_LOCK_DURATION_MS, PORTAL_AGENT_BULLMQ_STALLED_INTERVAL_MS, PORTAL_AGENT_RUNTIME_TIMING, type PortalAgentRuntimeTiming, } from './runtime-timing.js';
+export { noopAgentRuntimeMetrics, createLoggingAgentRuntimeMetrics, type AgentRuntimeMetrics, type AgentRuntimeMetricsLogger, } from './runtime-metrics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-jobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAC;AAenD,eAAO,MAAM,yBAAyB;;;;;;;;kBAK3B,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;;;;;;kBAK7B,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,wEAAwE;AACxE,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG;IAC5D,WAAW,EAAE,MAAM,CAAC;CACrB,CAIA;AAED,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAC;AAEtF,OAAO,EACL,wBAAwB,EACxB,kCAAkC,EAClC,8BAA8B,EAC9B,iCAAiC,EACjC,oCAAoC,EACpC,uCAAuC,EACvC,2BAA2B,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC"}

package/dist/agent-jobs/index.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export const AGENT_JOB_SCHEMA_VERSION = 1;
+const durableReferenceSchema = z.string().trim().min(1).max(256);
+const uuidReferenceSchema = z.uuid();
+const agentJobBaseSchema = z
+    .object({
+    schemaVersion: z.literal(AGENT_JOB_SCHEMA_VERSION),
+    idempotencyKey: durableReferenceSchema,
+    workspaceId: durableReferenceSchema,
+    sessionId: durableReferenceSchema,
+    taskRunId: uuidReferenceSchema,
+})
+    .strict();
+export const AgentManagerJobDataSchema = agentJobBaseSchema
+    .safeExtend({
+    triggeredByMessageId: durableReferenceSchema.optional(),
+    clientRequestId: durableReferenceSchema.optional(),
+})
+    .strict();
+export const AgentExecutionJobDataSchema = agentJobBaseSchema
+    .safeExtend({
+    issueId: uuidReferenceSchema,
+    executionId: uuidReferenceSchema,
+})
+    .strict();
+export { buildExecutionJobIdentity, buildExecutionRetryRequestKey, buildManagerJobIdentity, validateExecutionJobIdentity, validateManagerJobIdentity, } from './identity.js';
+/** @deprecated Prefer buildExecutionRetryRequestKey from identity.js */
+export function buildExecutionRetryKeys(executionId) {
+    return {
+        dispatchKey: `agent-execution-retry:${executionId.trim()}`,
+    };
+}
+export { isPortalAgentLegacyRunTaskEnabled } from './legacy-run-task.js';
+export { isPortalAgentLegacyHttpGoneEnabled } from './legacy-http-gone.js';
+export { isPortalAgentRuntimeV2Enabled } from './runtime-v2.js';
+export { isPortalAgentSandboxTeamMountEnabled } from './portal-sandbox-team-mount.js';
+export { PORTAL_AGENT_DB_LEASE_MS, PORTAL_AGENT_HEARTBEAT_INTERVAL_MS, PORTAL_AGENT_REDIS_SLOT_TTL_MS, PORTAL_AGENT_SESSION_MUTEX_TTL_MS, PORTAL_AGENT_BULLMQ_LOCK_DURATION_MS, PORTAL_AGENT_BULLMQ_STALLED_INTERVAL_MS, PORTAL_AGENT_RUNTIME_TIMING, } from './runtime-timing.js';
+export { noopAgentRuntimeMetrics, createLoggingAgentRuntimeMetrics, } from './runtime-metrics.js';
+//# sourceMappingURL=index.js.map

package/dist/agent-jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-jobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAU,CAAC;AAEnD,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACjE,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAErC,MAAM,kBAAkB,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC;IAClD,cAAc,EAAE,sBAAsB;IACtC,WAAW,EAAE,sBAAsB;IACnC,SAAS,EAAE,sBAAsB;IACjC,SAAS,EAAE,mBAAmB;CAC/B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB;KACxD,UAAU,CAAC;IACV,oBAAoB,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IACvD,eAAe,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CACnD,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB;KAC1D,UAAU,CAAC;IACV,OAAO,EAAE,mBAAmB;IAC5B,WAAW,EAAE,mBAAmB;CACjC,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,wEAAwE;AACxE,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IAGzD,OAAO;QACL,WAAW,EAAE,yBAAyB,WAAW,CAAC,IAAI,EAAE,EAAE;KAC3D,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,oCAAoC,EAAE,MAAM,gCAAgC,CAAC;AAEtF,OAAO,EACL,wBAAwB,EACxB,kCAAkC,EAClC,8BAA8B,EAC9B,iCAAiC,EACjC,oCAAoC,EACpC,uCAAuC,EACvC,2BAA2B,GAE5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,gCAAgC,GAGjC,MAAM,sBAAsB,CAAC"}