@kortix/ui 0.14.8 → 0.14.10

package/README.md

@@ -22,7 +22,7 @@ the component subpaths and the stylesheets. Inside kortix-ai/suna:
 `"@kortix/ui": "workspace:*"`.
 `react` and `react-dom` 19 are peers (the PowerPoint preview needs React 19.2.7 or later).
 
-- Public docs: `apps/web/content/docs/sdk/ui.mdx` (https://kortix.com/docs/sdk/ui).
+- Public docs: the "Kortix UI" section of `apps/web/content/docs/developers.mdx` (https://kortix.com/docs/developers#kortix-ui).
 - Agent skill: `skills/kortix-ui/SKILL.md`, with `references/custom-dashboard.md`
   (a whole dashboard), `references/modules.md` (every entry, its props, an example) and
   `references/theming.md` (every theme key). Kortix sessions load the same files
@@ -186,7 +186,7 @@ The root `@kortix/ui` barrel holds only light core primitives. Toasts need one
 
 ### Routes
 
-Every URL the components link to comes from one route table, `setUiRoutes` (`@kortix/ui`), called once at module load. The defaults are Kortix's own paths: `project` `/projects/<id>`, `session` `/projects/<id>/sessions/<sessionId>`, `sessions` `/projects/<id>/sessions` (`?view=archived|deleted`), `files` `/projects/<id>/files`, `drive` `/projects/<id>/drive`, `apps` `/projects/<id>/apps`, `members` `/projects/<id>/members`, `sandboxSettings` `/projects/<id>/config?section=sandbox`, `customize` `/projects/<id>/customize/<page>` (agents, skills, connectors, triggers, reminders, models, secrets, review, settings). Return your own path for a page you serve elsewhere. Return `null` for a page you do not serve: every link to it is hidden. `project` and `session` cannot be null.
+Every URL the components link to comes from one route table, `setUiRoutes` (`@kortix/ui`), called once at module load. The defaults are Kortix's own paths: `project` `/projects/<id>`, `session` `/projects/<id>/sessions/<sessionId>`, `sessions` `/projects/<id>/sessions` (`?view=archived|deleted`), `files` `/projects/<id>/files`, `drive` `/projects/<id>/drive`, `apps` `/projects/<id>/apps`, `members` `/projects/<id>/members`, `sandboxSettings` `/projects/<id>/config?section=sandbox`, `customize` `/projects/<id>/customize/<page>` (agents, skills, connectors, triggers, reminders, models, secrets, review, settings), `channel` `/projects/<id>/c/<slug>` and `dm` `/projects/<id>/dm/<agent>` (the sidebar links them while the project's `project_channels` flag is on). Return your own path for a page you serve elsewhere. Return `null` for a page you do not serve: every link to it is hidden. `project`, `session`, `channel` and `dm` cannot be null.
 
 ## Modules
 

package/dist/_vendor/kortix-shared.js

@@ -6954,6 +6954,72 @@ function parseManifestText(raw, format) {
   return value;
 }
 
+// ../shared/src/app-config.ts
+function appAdminsOnly(app) {
+  return app.services?.find((service) => service.name === "http")?.access === "admins";
+}
+function gridApps(apps, canAdmin = true) {
+  const slugs = new Set(apps.map((app) => app.slug));
+  return apps.filter(
+    (app) => app.display?.listed === true && !(app.display?.parent && slugs.has(app.display.parent)) && (canAdmin || !appAdminsOnly(app))
+  );
+}
+
+// ../manifest-schema/src/policy-sets.ts
+var POLICY_SET_NAME_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;
+var RESERVED_POLICY_SET_NAME = "base";
+var POLICY_SETS_UNSUPPORTED_PROVIDERS = ["channel", "computer"];
+function policySetNameError(name) {
+  if (typeof name !== "string" || !POLICY_SET_NAME_RE.test(name)) {
+    return 'a policy set name is lowercase letters, digits, "_" or "-" (at most 64 characters).';
+  }
+  if (name === RESERVED_POLICY_SET_NAME) return `"base" is reserved: it names the connector's base rules.`;
+  return null;
+}
+
+// ../shared/src/channel-descriptors.ts
+var CHANNEL_PLATFORM_IDS = ["slack", "teams", "email", "telegram"];
+var CHANNELS = {
+  slack: {
+    label: "Slack",
+    envelope: "Slack",
+    catalog: {
+      domain: "slack.com",
+      description: "Message the agent in Slack: mentions, DMs and channels, through the Kortix Slack app."
+    }
+  },
+  teams: {
+    label: "Microsoft Teams",
+    envelope: "Teams",
+    catalog: {
+      domain: "teams.microsoft.com",
+      description: "Message the agent in Microsoft Teams chats and channels, through the Kortix Teams app."
+    },
+    buttons: { max: 6 }
+  },
+  email: {
+    label: "Email",
+    envelope: "Email",
+    catalog: { domain: "email.kortix", description: "Give the project an inbox: people email the agent and it replies." }
+  },
+  telegram: {
+    label: "Telegram",
+    envelope: "Telegram",
+    catalog: { domain: "telegram.org", description: "Message the agent from Telegram through a bot you own." },
+    messageChars: 4096,
+    buttons: { max: 6, dataBytes: 64 },
+    // A bot token is `<bot id>:<secret>`.
+    connect: { tokenPattern: /^\d{5,15}:[A-Za-z0-9_-]{30,64}$/, tokenPlaceholder: "123456789:\u2026" },
+    access: {
+      userId: /^\d{1,20}$/,
+      idPlaceholder: "123456789",
+      idsPlaceholder: "123456789, 987654321",
+      idInputMode: "numeric"
+    }
+  }
+};
+var isChannelPlatform = (platform) => CHANNEL_PLATFORM_IDS.includes(platform);
+
 // ../manifest-schema/src/slug.ts
 var SLUG_MAX_LENGTH = 128;
 function trimSeparators(value) {
@@ -8600,6 +8666,7 @@ function readSlackFollowUpHeader(line) {
 }
 
 // ../shared/src/channel-message.ts
+var CHANNEL_PLATFORMS = CHANNEL_PLATFORM_IDS.map((id) => CHANNELS[id].envelope);
 var TAIL_MARKERS = [
   /^How to work:/m,
   /^Attached files \(download with/m,
@@ -8678,6 +8745,29 @@ var FOLLOW_UP_HEADERS = [
   { platform: "Teams", header: /^New message from (.+?) in the same Teams conversation:$/m },
   { platform: "Slack", header: /^New message from (.+?) in the same Slack thread:$/m }
 ];
+var TELEGRAM_FIRST_HEADER = "You received a message on Telegram.";
+var TELEGRAM_FOLLOW_UP_HEADER = /^New Telegram message from (\S+) in the same chat:$/;
+var TELEGRAM_TAIL = "\n\nHow to answer:\n- Reply with the ";
+function readTelegramPrompt(text) {
+  const lineEnd3 = text.indexOf("\n");
+  if (lineEnd3 < 0) return void 0;
+  const header = text.slice(0, lineEnd3).trimEnd();
+  const followUp = TELEGRAM_FOLLOW_UP_HEADER.exec(header);
+  if (header !== TELEGRAM_FIRST_HEADER && !followUp) return void 0;
+  const idLine = /^Message id:[^\n]*\n/m.exec(text);
+  if (!idLine) return void 0;
+  const start = idLine.index + idLine[0].length;
+  const rest = text.slice(start).replace(/^\r?\n/, "");
+  if (/^Message:\r?\n/.test(rest)) return void 0;
+  const tail = text.lastIndexOf(TELEGRAM_TAIL);
+  return {
+    platform: "Telegram",
+    context: "",
+    userName: field(text.slice(lineEnd3, idLine.index), "From") || followUp?.[1] || "unknown",
+    messageText: text.slice(start, tail > start ? tail : text.length).trim(),
+    followUp: followUp !== null
+  };
+}
 function opensPrompt(text, headerIndex) {
   const before = text.slice(0, headerIndex).trim();
   return before === "" || before.startsWith("NOTE:");
@@ -8687,8 +8777,13 @@ function parseChannelMessage(rawText) {
   if (!text) return void 0;
   const legacy = readLegacyChannelHeader(text);
   if (legacy) {
-    const platform = legacy.platform === "Teams" ? "Teams" : legacy.platform === "Telegram" ? "Telegram" : "Slack";
-    const messageText = cutAtTail(text.slice(legacy.length));
+    const platform = CHANNEL_PLATFORMS.find((p2) => p2 === legacy.platform) ?? "Slack";
+    const rest = text.slice(legacy.length);
+    const end = rest.lastIndexOf(`
+
+\u2500\u2500 ${legacy.platform} instructions
+`);
+    const messageText = end >= 0 ? rest.slice(0, end).trim() : cutAtTail(rest);
     return {
       platform,
       context: legacy.context,
@@ -8697,6 +8792,8 @@ function parseChannelMessage(rawText) {
       followUp: false
     };
   }
+  const telegram = readTelegramPrompt(text);
+  if (telegram) return telegram;
   for (const shape of FIRST_MESSAGE_HEADERS) {
     const m = shape.header.exec(text);
     if (!m || !opensPrompt(text, m.index)) continue;
@@ -8728,6 +8825,16 @@ function parseChannelMessage(rawText) {
   }
   return void 0;
 }
+function channelPromptTail(text, platform) {
+  const at = text.lastIndexOf(`
+\u2500\u2500 ${platform} instructions
+`);
+  return at < 0 ? "" : text.slice(at);
+}
+function isChannelFileLabel(text) {
+  const line = text.trim();
+  return line.length > 2 && line.startsWith("(") && line.endsWith(")") && !/[()\n]/.test(line.slice(1, -1));
+}
 
 // ../shared/src/chat-mention.ts
 function stripChatMentionMarkup(value) {
@@ -8830,6 +8937,12 @@ function utf8Bytes(text) {
   return new TextEncoder().encode(text).length;
 }
 
+// ../shared/src/space-slug.ts
+var SPACE_SLUG_MAX = 40;
+function spaceSlug(name) {
+  return name.toLowerCase().trim().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-+/g, "-").slice(0, SPACE_SLUG_MAX).replace(/^-+|-+$/g, "");
+}
+
 // ../shared/src/code-language.ts
 var LANGUAGE_ALIASES = {
   // web
@@ -10943,4 +11056,4 @@ smol-toml/dist/index.js:
    *)
 */
 
-export { AVATAR_INK, CARD_TEXT_RATIO, COMMIT_CONFIRM_ATTEMPTS, COMMIT_CONFIRM_DELAY_MS, CREDITS_PER_DOLLAR, CURATED_SECTIONS, KATEX_FENCE_LANGUAGES, LANGUAGE_ALIASES, MAX_PROMPT_ATTACHMENTS_BYTES, MAX_PROMPT_ATTACHMENT_BYTES, MAX_PROMPT_ATTACHMENT_FILES, MAX_PROMPT_UPLOAD_FILENAME_BYTES, META_AGENT_DISPLAY_NAME, META_SANDBOX_SLUG, OTHER, PASTED_INLINE_MAX_BYTES, POPULAR_SECTION, PREVIEW_BUILDING_STATES, PREVIEW_STATE_MESSAGE, PROJECT_GLYPH_COLORS, PROJECT_GLYPH_NAMES, UNKNOWN_RATIO, UPLOAD_LIMITS, autoLinkUrls, avatarFill, buildWebhookSampleRequest, capitalizeWords, cardImageShape, cardListLayout, chalkColors, confirmCommitted, countInSection, dollarsToCredits, editConfigPrompt, errorCode, escapeCurrencyDollars, expandPastedContent, extractReadableHtml, fileTagBlocks, formatFileSize, formatRelative, formatUsdAsCredits, groupIntoSections, hasReferenceDefinitionOutsideFences, humanizeCategory, indexOfIgnoreCase, isAllowedWebPushHost, isAmbiguousCreateFailure, isMermaidCode, isMetaAgentName, languageLabel, looksLikeMarkdown, masonryColumns, neutralizePastedTags, newConfigPrompt, newPastedContentId, normalizeLanguage, normalizeLatexDelimiters, openMarkdownLinkAtEnd, parseBackgroundWorkers, parseBalanceUsd, parseChannelMessage, parseGrepOutput, parseManifestText, parseMemoryEntryOutput, parseMemorySearchOutput, parseReminderPrompt, parseRoomDigest, parseRoomPrompt, parseSessionGetOutput, parseSessionMessagesOutput, parseSessionMetadataOutput, parseSessionSearchHits, parseTriggerEvent, parseTriggerLines, prefersPreviewLink, prepareMarkdownForKatex, prepareMarkdownForMath, promptFileReferenceXml, ptyOutputBlock, ptySpawnedBody, pushTypeOf, referenceHeaders, removeSpans, replaceSpans, resolveRegisteredKey, safeHttpUrl, sandboxMediaPath, sanitizePromptUploadFilename, sectionKeyForCategory, sectionKeysForEntry, sectionTitle, selfClosingTags, serializePromptWithPastes, shouldTilePaste, skillDocumentBody, slackPlainText, slugifySlug, splitPastedContent, stripBashMetadata, stripChatMentionMarkup, stripMarkupForToolOutput, tagBlocks, toolRegistryCandidates, trimPastedText, truncateString, utf8Bytes, withoutEdgeQuotes, xmlBlocks };
+export { AVATAR_INK, CARD_TEXT_RATIO, CHANNELS, CHANNEL_PLATFORM_IDS, COMMIT_CONFIRM_ATTEMPTS, COMMIT_CONFIRM_DELAY_MS, CREDITS_PER_DOLLAR, CURATED_SECTIONS, KATEX_FENCE_LANGUAGES, LANGUAGE_ALIASES, MAX_PROMPT_ATTACHMENTS_BYTES, MAX_PROMPT_ATTACHMENT_BYTES, MAX_PROMPT_ATTACHMENT_FILES, MAX_PROMPT_UPLOAD_FILENAME_BYTES, META_AGENT_DISPLAY_NAME, META_SANDBOX_SLUG, OTHER, PASTED_INLINE_MAX_BYTES, POLICY_SETS_UNSUPPORTED_PROVIDERS, POPULAR_SECTION, PREVIEW_BUILDING_STATES, PREVIEW_STATE_MESSAGE, PROJECT_GLYPH_COLORS, PROJECT_GLYPH_NAMES, UNKNOWN_RATIO, UPLOAD_LIMITS, appAdminsOnly, autoLinkUrls, avatarFill, buildWebhookSampleRequest, capitalizeWords, cardImageShape, cardListLayout, chalkColors, channelPromptTail, confirmCommitted, countInSection, dollarsToCredits, editConfigPrompt, errorCode, escapeCurrencyDollars, expandPastedContent, extractReadableHtml, fileTagBlocks, formatFileSize, formatRelative, formatUsdAsCredits, gridApps, groupIntoSections, hasReferenceDefinitionOutsideFences, humanizeCategory, indexOfIgnoreCase, isAllowedWebPushHost, isAmbiguousCreateFailure, isChannelFileLabel, isChannelPlatform, isMermaidCode, isMetaAgentName, languageLabel, looksLikeMarkdown, masonryColumns, neutralizePastedTags, newConfigPrompt, newPastedContentId, normalizeLanguage, normalizeLatexDelimiters, openMarkdownLinkAtEnd, parseBackgroundWorkers, parseBalanceUsd, parseChannelMessage, parseGrepOutput, parseManifestText, parseMemoryEntryOutput, parseMemorySearchOutput, parseReminderPrompt, parseRoomDigest, parseRoomPrompt, parseSessionGetOutput, parseSessionMessagesOutput, parseSessionMetadataOutput, parseSessionSearchHits, parseTriggerEvent, parseTriggerLines, policySetNameError, prefersPreviewLink, prepareMarkdownForKatex, prepareMarkdownForMath, promptFileReferenceXml, ptyOutputBlock, ptySpawnedBody, pushTypeOf, referenceHeaders, removeSpans, replaceSpans, resolveRegisteredKey, safeHttpUrl, sandboxMediaPath, sanitizePromptUploadFilename, sectionKeyForCategory, sectionKeysForEntry, sectionTitle, selfClosingTags, serializePromptWithPastes, shouldTilePaste, skillDocumentBody, slackPlainText, slugifySlug, spaceSlug, splitPastedContent, stripBashMetadata, stripChatMentionMarkup, stripMarkupForToolOutput, tagBlocks, toolRegistryCandidates, trimPastedText, truncateString, utf8Bytes, withoutEdgeQuotes, xmlBlocks };

package/dist/_vendor/shared/app-config.d.ts

@@ -0,0 +1,175 @@
+/**
+ * The configuration of one App release: process groups,
+ * services (named ports), mounts (volumes), VM sizes, checks and the deploy
+ * strategy. `kortix.yaml` `apps.<name>` is the authored form; the
+ * CLI resolves it with `resolveAppReleaseConfig`, the API validates it again
+ * with `appReleaseConfigIssues` and stores the result on the release, and the
+ * deploy engine reads only the resolved form.
+ *
+ * Pure and dependency-free: the API, the CLI, the SDK and the manifest schema
+ * share it.
+ */
+export type AppDeployStrategy = 'rolling' | 'immediate' | 'bluegreen' | 'canary';
+export type AppAutoStop = 'off' | 'stop' | 'suspend';
+/** `public`: no gate. `app`: the App's access policy and Kortix sign-in. `admins`: project admins only. */
+export type AppServiceAccess = 'public' | 'app' | 'admins';
+export type AppServiceProtocol = 'http' | 'tcp';
+export interface AppCheck {
+    type: 'http' | 'tcp';
+    /** Defaults to the service's `internal_port`. */
+    port?: number;
+    /** http only. */
+    path?: string;
+    interval_s: number;
+    timeout_s: number;
+    grace_period_s: number;
+}
+export interface AppService {
+    /** `http` is the primary service: it answers on the App's own host. */
+    name: string;
+    internal_port: number;
+    protocol: AppServiceProtocol;
+    access: AppServiceAccess;
+    auto_stop_machines: AppAutoStop;
+    auto_start_machines: boolean;
+    min_machines_running: number;
+    /** Process groups that serve this port. */
+    processes: string[];
+    checks: AppCheck[];
+}
+export interface AppMount {
+    /** Volume name. Each machine of the group gets its own volume of this name. */
+    source: string;
+    destination: string;
+    initial_size_gb: number;
+    snapshot_retention_days: number;
+    processes: string[];
+}
+export interface AppVmSize {
+    cpu: number;
+    memory_gb: number;
+    /** Root disk; the data belongs on a mount. */
+    disk_gb: number;
+    /** Groups this size applies to; empty = every group without a more specific entry. */
+    processes: string[];
+}
+export interface AppDeployConfig {
+    strategy: AppDeployStrategy;
+    /** Runs once per release in a temporary machine (new image, secrets, no mounts) before machines update. */
+    release_command: string | null;
+}
+export interface AppReleaseConfig {
+    /** Group name → command. `""` runs the image's own command. */
+    processes: Record<string, string>;
+    services: AppService[];
+    mounts: AppMount[];
+    vm: AppVmSize[];
+    deploy: AppDeployConfig;
+}
+/** The authored form: every field optional, plus the shorthands Apps had before this model. */
+export interface AppReleaseConfigInput {
+    processes?: Record<string, string>;
+    http_service?: Partial<Omit<AppService, 'name' | 'checks'>> & {
+        checks?: Array<Partial<AppCheck>>;
+    };
+    services?: Array<Partial<Omit<AppService, 'checks'>> & {
+        checks?: Array<Partial<AppCheck>>;
+    }>;
+    mounts?: Array<Partial<AppMount>>;
+    vm?: Partial<AppVmSize> | Array<Partial<AppVmSize>>;
+    deploy?: Partial<AppDeployConfig>;
+    /** Shorthands. */
+    port?: number;
+    command?: string;
+    readiness_path?: string;
+    always_on?: boolean;
+    resources?: {
+        cpu?: number;
+        memory_gb?: number;
+        disk_gb?: number;
+    };
+}
+export interface AppConfigIssue {
+    path: string;
+    message: string;
+}
+export declare const DEFAULT_PROCESS_GROUP = "app";
+export declare const PRIMARY_SERVICE = "http";
+/** Ports the App supervisor owns inside every machine. */
+export declare const RESERVED_APP_PORTS: readonly [7331, 8080];
+export declare const APP_VM_LIMITS: {
+    readonly cpu: {
+        readonly min: 1;
+        readonly max: 32;
+    };
+    readonly memory_gb: {
+        readonly min: 1;
+        readonly max: 128;
+    };
+    readonly disk_gb: {
+        readonly min: 1;
+        readonly max: 500;
+    };
+};
+export declare const DEFAULT_APP_VM: {
+    readonly cpu: 1;
+    readonly memory_gb: 2;
+    readonly disk_gb: 10;
+};
+export declare const DEFAULT_SNAPSHOT_RETENTION_DAYS = 5;
+export declare const MAX_SNAPSHOT_RETENTION_DAYS = 60;
+/** Platinum caps a volume at 100 GiB (its largest size class). */
+export declare const MAX_VOLUME_GB = 100;
+/**
+ * The resolved release config. Shorthands map onto the full fields:
+ * `port` → `http_service.internal_port`, `command` → `processes.app`,
+ * `readiness_path` → an http check, `always_on` → `auto_stop_machines: off` and
+ * `min_machines_running: 1` (`false`: `stop` and 0), `resources` → the default VM.
+ * An explicit full field wins over its shorthand.
+ */
+export declare function resolveAppReleaseConfig(input?: AppReleaseConfigInput): AppReleaseConfig;
+/** Every rule the deploy engine relies on. Empty = valid. */
+export declare function appReleaseConfigIssues(config: AppReleaseConfig): AppConfigIssue[];
+/** The VM size of one process group: its own entry, else the default entry, else the platform default. */
+export declare function appVmFor(config: AppReleaseConfig, group: string): Omit<AppVmSize, 'processes'>;
+/** The mount a machine of this group gets, or null. */
+export declare function appMountFor(config: AppReleaseConfig, group: string): AppMount | null;
+/** The services a machine of this group serves. */
+export declare function appServicesFor(config: AppReleaseConfig, group: string): AppService[];
+/**
+ * Where Kortix shows an App (`kortix.yaml` `apps.<name>.display`). Presentation
+ * only: nothing about how the App runs or who may open it changes.
+ */
+export interface AppDisplay {
+    /** A card in the Apps grid. Default false: an App is on the Apps page only when registered with `listed: true`. A `parent` puts it in that App's tabs instead. */
+    listed?: boolean;
+    /** The card thumbnail: `live` frames the App, `none` shows an icon. Default `live`. */
+    preview?: 'live' | 'none';
+    /** The App, by slug, whose detail shows this one as a tab (a backend's admin dashboard). */
+    parent?: string;
+}
+/** What the Apps grid reads of an App: the web's `App` and the API's App JSON both fit. */
+export interface GridApp {
+    slug: string;
+    display?: AppDisplay | null;
+    services?: ReadonlyArray<{
+        name: string;
+        access?: string | null;
+    }> | null;
+}
+/**
+ * Its primary service is `access: admins` (a backend's admin dashboard): only
+ * project admins can open it, so nobody else is shown a card or tab for it.
+ */
+export declare function appAdminsOnly(app: GridApp): boolean;
+/**
+ * The Apps the grid shows as cards (`display`): registered with `listed: true`,
+ * not a tab of a parent in the same list, and not admins-only for a non-admin.
+ * A tab whose parent is gone stays reachable as a card. Background Apps (a
+ * poller, a bot, a backend) stay out of the grid unless their author registers
+ * them. The Apps page, a channel's Apps tab and the channel's Apps count all
+ * apply this one rule.
+ */
+export declare function gridApps<T extends GridApp>(apps: readonly T[], canAdmin?: boolean): T[];
+/** What is wrong with an authored `display` block of the App `slug`. Paths are relative to the block. */
+export declare function appDisplayIssues(display: unknown, slug: string): AppConfigIssue[];

package/dist/_vendor/shared/artifact-comments.d.ts

@@ -0,0 +1,235 @@
+import { z } from 'zod';
+export declare const artifactCommentAnchorSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    version: z.ZodString;
+    quote: z.ZodString;
+    prefix: z.ZodString;
+    suffix: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "text";
+    version: string;
+    quote: string;
+    prefix: string;
+    suffix: string;
+}, {
+    type: "text";
+    version: string;
+    quote: string;
+    prefix: string;
+    suffix: string;
+}>, z.ZodObject<{
+    offset: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>;
+    version: z.ZodString;
+    selector: z.ZodString;
+    snippet: z.ZodString;
+    viewport_width: z.ZodNumber;
+    scroll: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>;
+    type: z.ZodLiteral<"point">;
+}, "strict", z.ZodTypeAny, {
+    type: "point";
+    version: string;
+    offset: {
+        x: number;
+        y: number;
+    };
+    selector: string;
+    snippet: string;
+    viewport_width: number;
+    scroll: {
+        x: number;
+        y: number;
+    };
+}, {
+    type: "point";
+    version: string;
+    offset: {
+        x: number;
+        y: number;
+    };
+    selector: string;
+    snippet: string;
+    viewport_width: number;
+    scroll: {
+        x: number;
+        y: number;
+    };
+}>, z.ZodObject<{
+    offset: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    version: z.ZodString;
+    selector: z.ZodString;
+    snippet: z.ZodString;
+    viewport_width: z.ZodNumber;
+    scroll: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>;
+    type: z.ZodLiteral<"region">;
+}, "strict", z.ZodTypeAny, {
+    type: "region";
+    version: string;
+    offset: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    selector: string;
+    snippet: string;
+    viewport_width: number;
+    scroll: {
+        x: number;
+        y: number;
+    };
+}, {
+    type: "region";
+    version: string;
+    offset: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    selector: string;
+    snippet: string;
+    viewport_width: number;
+    scroll: {
+        x: number;
+        y: number;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"none">;
+    version: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "none";
+    version: string;
+}, {
+    type: "none";
+    version: string;
+}>]>, {
+    type: "text";
+    version: string;
+    quote: string;
+    prefix: string;
+    suffix: string;
+} | {
+    type: "point";
+    version: string;
+    offset: {
+        x: number;
+        y: number;
+    };
+    selector: string;
+    snippet: string;
+    viewport_width: number;
+    scroll: {
+        x: number;
+        y: number;
+    };
+} | {
+    type: "region";
+    version: string;
+    offset: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    selector: string;
+    snippet: string;
+    viewport_width: number;
+    scroll: {
+        x: number;
+        y: number;
+    };
+} | {
+    type: "none";
+    version: string;
+}, {
+    type: "text";
+    version: string;
+    quote: string;
+    prefix: string;
+    suffix: string;
+} | {
+    type: "point";
+    version: string;
+    offset: {
+        x: number;
+        y: number;
+    };
+    selector: string;
+    snippet: string;
+    viewport_width: number;
+    scroll: {
+        x: number;
+        y: number;
+    };
+} | {
+    type: "region";
+    version: string;
+    offset: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    selector: string;
+    snippet: string;
+    viewport_width: number;
+    scroll: {
+        x: number;
+        y: number;
+    };
+} | {
+    type: "none";
+    version: string;
+}>;
+export type ArtifactCommentAnchor = z.infer<typeof artifactCommentAnchorSchema>;
+export type ArtifactTextAnchor = Extract<ArtifactCommentAnchor, {
+    type: 'text';
+}>;
+export type ArtifactTextPosition = {
+    start: number | null;
+    end: number | null;
+    outdated: boolean;
+};
+export declare function reanchorArtifactText(text: string, anchor: ArtifactTextAnchor): ArtifactTextPosition;