@kortix/sdk 0.9.98

package/dist/platform/platform-client/ssh.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Platform API client — SSH setup API.
+ */
+export interface SSHConnectionInfo {
+    host: string;
+    port: number;
+    username: string;
+    provider: string;
+    key_name: string;
+    host_alias: string;
+    reconnect_command: string;
+    ssh_command: string;
+    ssh_config_entry: string;
+    ssh_config_command: string;
+}
+export interface SSHSetupResult extends SSHConnectionInfo {
+    private_key: string;
+    public_key: string;
+    setup_command: string;
+    agent_prompt: string;
+    key_comment: string;
+}
+/**
+ * Generate an SSH keypair and inject it into the active sandbox.
+ * Returns the private key and connection details for VS Code Remote SSH.
+ */
+export declare function setupSSH(sandboxId?: string): Promise<SSHSetupResult>;
+export declare function getSSHConnection(sandboxId?: string): Promise<SSHConnectionInfo>;
+//# sourceMappingURL=ssh.d.ts.map

package/dist/platform/platform-client/ssh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.d.ts","sourceRoot":"","sources":["../../../src/platform/platform-client/ssh.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAE1E;AAED,wBAAsB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAErF"}

package/dist/platform/platform-client/ssh.js

@@ -0,0 +1,14 @@
+/**
+ * Platform API client — SSH setup API.
+ */
+/**
+ * Generate an SSH keypair and inject it into the active sandbox.
+ * Returns the private key and connection details for VS Code Remote SSH.
+ */
+export async function setupSSH(sandboxId) {
+    throw new Error('SSH setup is not exposed for project-session sandboxes');
+}
+export async function getSSHConnection(sandboxId) {
+    throw new Error('SSH connection details are not exposed for project-session sandboxes');
+}
+//# sourceMappingURL=ssh.js.map

package/dist/platform/platform-client/ssh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.js","sourceRoot":"","sources":["../../../src/platform/platform-client/ssh.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAkB;IAC/C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAkB;IACvD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;AAC1F,CAAC"}

package/dist/platform/platform-client/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Platform API client — shared sandbox types and port constants.
+ */
+/**
+ * Well-known container ports exposed by the sandbox image.
+ * These are the ports INSIDE the container — Docker maps them to random host ports.
+ */
+export declare const SANDBOX_PORTS: {
+    readonly DESKTOP: "6080";
+    readonly DESKTOP_HTTPS: "6081";
+    readonly PRESENTATION_VIEWER: "3210";
+    readonly STATIC_FILE_SERVER: "3211";
+    readonly KORTIX_MASTER: "8000";
+    readonly BROWSER_STREAM: "9223";
+    readonly BROWSER_VIEWER: "9224";
+    readonly SSH: "22";
+};
+export type SandboxProviderName = 'managed' | 'daytona' | 'justavps';
+export type ServerTypeOption = string;
+export interface SandboxCreateProgress {
+    status: 'pulling';
+    progress: number;
+    message: string;
+}
+export interface SandboxInfo {
+    sandbox_id: string;
+    external_id: string;
+    name: string;
+    provider: SandboxProviderName;
+    base_url: string;
+    status: string;
+    lifecycle_status?: string;
+    init_status?: 'pending' | 'provisioning' | 'retrying' | 'ready' | 'failed';
+    health_status?: 'healthy' | 'degraded' | 'offline' | 'unknown';
+    init_attempts?: number;
+    last_init_error?: string | null;
+    version?: string | null;
+    metadata?: Record<string, unknown>;
+    is_included?: boolean;
+    stripe_subscription_id?: string | null;
+    stripe_subscription_item_id?: string | null;
+    cancel_at_period_end?: boolean;
+    cancel_at?: string | null;
+    auto_update_enabled?: boolean;
+    auto_update_channel?: 'stable' | 'dev';
+    auto_update?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    /** True when the current viewer is the account owner (or a platform admin) — gates rename/manage UI. */
+    can_manage?: boolean;
+}
+export interface ProvidersInfo {
+    providers: SandboxProviderName[];
+    default: SandboxProviderName;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/platform/platform-client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/platform/platform-client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CAShB,CAAC;AAIX,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3E,aAAa,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mBAAmB,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,wGAAwG;IACxG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,OAAO,EAAE,mBAAmB,CAAC;CAC9B"}

package/dist/platform/platform-client/types.js

@@ -0,0 +1,19 @@
+/**
+ * Platform API client — shared sandbox types and port constants.
+ */
+// ─── Sandbox Port Constants ──────────────────────────────────────────────────
+/**
+ * Well-known container ports exposed by the sandbox image.
+ * These are the ports INSIDE the container — Docker maps them to random host ports.
+ */
+export const SANDBOX_PORTS = {
+    DESKTOP: '6080',
+    DESKTOP_HTTPS: '6081',
+    PRESENTATION_VIEWER: '3210',
+    STATIC_FILE_SERVER: '3211',
+    KORTIX_MASTER: '8000',
+    BROWSER_STREAM: '9223',
+    BROWSER_VIEWER: '9224',
+    SSH: '22',
+};
+//# sourceMappingURL=types.js.map

package/dist/platform/platform-client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/platform/platform-client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,MAAM;IACrB,mBAAmB,EAAE,MAAM;IAC3B,kBAAkB,EAAE,MAAM;IAC1B,aAAa,EAAE,MAAM;IACrB,cAAc,EAAE,MAAM;IACtB,cAAc,EAAE,MAAM;IACtB,GAAG,EAAE,IAAI;CACD,CAAC"}

package/dist/platform/platform-client/updates.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Platform API client — sandbox update + version/changelog API.
+ */
+import type { SandboxInfo } from './types.js';
+export interface ChangelogChange {
+    type: 'feature' | 'fix' | 'improvement' | 'breaking' | 'upstream' | 'security' | 'deprecation';
+    text: string;
+}
+export interface ChangelogArtifact {
+    name: string;
+    target: 'npm' | 'docker-hub' | 'github-release' | 'daytona';
+}
+export interface ChangelogEntry {
+    version: string;
+    date: string;
+    title: string;
+    description: string;
+    changes: ChangelogChange[];
+    artifacts?: ChangelogArtifact[];
+    /** Present on dev changelog entries */
+    channel?: 'stable' | 'dev';
+    sha?: string;
+    author?: string;
+}
+export type VersionChannel = 'stable' | 'dev';
+export interface VersionEntry {
+    version: string;
+    channel: VersionChannel;
+    date: string;
+    title: string;
+    body?: string;
+    sha?: string;
+    current: boolean;
+}
+export interface AllVersionsResponse {
+    versions: VersionEntry[];
+    current: {
+        version: string;
+        channel: VersionChannel;
+    };
+}
+export interface SandboxVersionInfo {
+    version: string;
+    channel?: string;
+    date?: string;
+    sha?: string;
+    changelog: ChangelogEntry | null;
+}
+export interface SandboxUpdateResult {
+    success?: boolean;
+    upToDate?: boolean;
+    previousVersion?: string;
+    currentVersion: string;
+    changelog?: ChangelogEntry | null;
+    output?: string;
+    error?: string;
+}
+/**
+ * Update phases — Docker image-based flow.
+ *
+ * JustAVPS: backing_up → pulling → patching → stopping → restarting → verifying → complete
+ * Local Docker is manual-only and is not updated through the API.
+ */
+export type UpdatePhase = 'idle' | 'backing_up' | 'pulling' | 'patching' | 'stopping' | 'removing' | 'recreating' | 'restarting' | 'verifying' | 'starting' | 'health_check' | 'complete' | 'failed';
+export interface SandboxUpdateStatus {
+    phase: UpdatePhase;
+    progress: number;
+    message: string;
+    targetVersion: string | null;
+    previousVersion: string | null;
+    currentVersion: string | null;
+    error: string | null;
+    startedAt: string | null;
+    updatedAt: string | null;
+    /** Provider-side backup ID while phase === 'backing_up'. Null otherwise. */
+    backupId?: string | null;
+    cancelRequested?: boolean;
+    diagnostics?: Record<string, string | number | boolean | null>;
+}
+/** Phases where the sandbox is being modified and must not be used. */
+export declare const DESTRUCTIVE_PHASES: UpdatePhase[];
+export declare function isDestructivePhase(phase: UpdatePhase): boolean;
+/**
+ * Get the current update status from kortix-api.
+ * The API tracks the Docker pull + recreate progress.
+ */
+export declare function getSandboxUpdateStatus(sandbox?: SandboxInfo): Promise<SandboxUpdateStatus>;
+/**
+ * Get the latest available sandbox version — proxied through the platform API.
+ * Uses GitHub Releases API for stable, GitHub Commits API for dev.
+ *
+ * @param channel — 'stable' (default) or 'dev'
+ */
+export declare function getLatestSandboxVersion(channel?: VersionChannel): Promise<SandboxVersionInfo>;
+/**
+ * Get the full changelog from the platform.
+ * Supports channel filtering: 'stable', 'dev', or 'all' (default).
+ */
+export declare function getFullChangelog(channel?: 'stable' | 'dev' | 'all'): Promise<ChangelogEntry[]>;
+/**
+ * Get all available versions (both stable and dev).
+ */
+export declare function getAllVersions(): Promise<AllVersionsResponse>;
+/**
+ * Trigger a Docker image-based sandbox update via kortix-api.
+ *
+ * The API pulls the new image, stops the container, removes it (preserving
+ * the /workspace volume), and recreates with the new image. The frontend
+ * should poll getSandboxUpdateStatus() for progress.
+ */
+export declare function triggerSandboxUpdate(sandbox: SandboxInfo, version: string): Promise<SandboxUpdateResult>;
+/**
+ * Reset the update status on kortix-api (e.g. after a failed update to allow retry).
+ */
+export declare function resetSandboxUpdateStatus(sandbox?: SandboxInfo): Promise<void>;
+export declare function cancelSandboxUpdate(sandbox?: SandboxInfo): Promise<void>;
+//# sourceMappingURL=updates.d.ts.map

package/dist/platform/platform-client/updates.d.ts.map

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

package/dist/platform/platform-client/updates.js

@@ -0,0 +1,97 @@
+/**
+ * Platform API client — sandbox update + version/changelog API.
+ */
+import { getPlatformUrl } from './shared.js';
+/** Phases where the sandbox is being modified and must not be used. */
+export const DESTRUCTIVE_PHASES = [
+    'pulling', 'patching', 'stopping', 'removing', 'recreating',
+    'restarting', 'verifying', 'starting', 'health_check',
+];
+export function isDestructivePhase(phase) {
+    return DESTRUCTIVE_PHASES.includes(phase);
+}
+/**
+ * Get the current update status from kortix-api.
+ * The API tracks the Docker pull + recreate progress.
+ */
+export async function getSandboxUpdateStatus(sandbox) {
+    return {
+        phase: 'idle',
+        progress: 0,
+        message: 'Sandbox image updates are managed by project-session provisioning.',
+        targetVersion: null,
+        previousVersion: null,
+        currentVersion: sandbox?.version ?? null,
+        error: null,
+        startedAt: null,
+        updatedAt: null,
+    };
+}
+/**
+ * Get the latest available sandbox version — proxied through the platform API.
+ * Uses GitHub Releases API for stable, GitHub Commits API for dev.
+ *
+ * @param channel — 'stable' (default) or 'dev'
+ */
+export async function getLatestSandboxVersion(channel) {
+    const params = channel ? `?channel=${channel}` : '';
+    const res = await fetch(`${getPlatformUrl()}/platform/sandbox/version/latest${params}`, {
+        headers: { 'Accept': 'application/json' },
+    });
+    if (!res.ok)
+        throw new Error(`Version check failed: ${res.status}`);
+    const latest = await res.json();
+    try {
+        const changelogEntries = await getFullChangelog(channel || 'stable');
+        latest.changelog = changelogEntries.find((entry) => entry.version === latest.version) ?? changelogEntries[0] ?? null;
+    }
+    catch {
+        latest.changelog = null;
+    }
+    return latest;
+}
+/**
+ * Get the full changelog from the platform.
+ * Supports channel filtering: 'stable', 'dev', or 'all' (default).
+ */
+export async function getFullChangelog(channel) {
+    const params = channel ? `?channel=${channel}` : '';
+    const res = await fetch(`${getPlatformUrl()}/platform/sandbox/version/changelog${params}`, {
+        headers: { 'Accept': 'application/json' },
+    });
+    if (!res.ok)
+        throw new Error(`Changelog fetch failed: ${res.status}`);
+    const data = await res.json();
+    return data.changelog;
+}
+/**
+ * Get all available versions (both stable and dev).
+ */
+export async function getAllVersions() {
+    const res = await fetch(`${getPlatformUrl()}/platform/sandbox/version/all`, {
+        headers: { 'Accept': 'application/json' },
+    });
+    if (!res.ok)
+        throw new Error(`All versions fetch failed: ${res.status}`);
+    return res.json();
+}
+/**
+ * Trigger a Docker image-based sandbox update via kortix-api.
+ *
+ * The API pulls the new image, stops the container, removes it (preserving
+ * the /workspace volume), and recreates with the new image. The frontend
+ * should poll getSandboxUpdateStatus() for progress.
+ */
+export async function triggerSandboxUpdate(sandbox, version) {
+    throw new Error('Sandbox image updates are managed by project-session provisioning');
+}
+/**
+ * Reset the update status on kortix-api (e.g. after a failed update to allow retry).
+ */
+export async function resetSandboxUpdateStatus(sandbox) {
+    return;
+}
+export async function cancelSandboxUpdate(sandbox) {
+    return;
+}
+//# sourceMappingURL=updates.js.map

package/dist/platform/platform-client/updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../../../src/platform/platform-client/updates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAoG1C,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAkB;IAC/C,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY;IAC3D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc;CACtD,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACnD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAqB;IAErB,OAAO;QACL,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,oEAAoE;QAC7E,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;QACxC,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAwB;IACpE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,EAAE,mCAAmC,MAAM,EAAE,EAAE;QACtF,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;KAC1C,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAA6C,CAAC;IAE3E,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAAC,OAAO,IAAI,QAAQ,CAAC,CAAC;QACrE,MAAM,CAAC,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACvH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAkC;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,EAAE,sCAAsC,MAAM,EAAE,EAAE;QACzF,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;KAC1C,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,EAAE,+BAA+B,EAAE;QAC1E,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;KAC1C,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoB,EACpB,OAAe;IAEf,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;AACvF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAqB;IAClE,OAAO;AACT,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAqB;IAC7D,OAAO;AACT,CAAC"}

package/dist/platform/platform-client/urls.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Platform API client — sandbox URL and port helpers.
+ */
+import { type SandboxInfo } from './types.js';
+/**
+ * Build the OpenCode server URL for a sandbox.
+ * Provider-agnostic: {BACKEND_URL}/p/{externalId}/8000
+ *
+ * The external_id is the sandbox's Daytona ID, used for proxy routing.
+ * Guards against missing external_id to prevent broken URLs.
+ */
+export declare function getSandboxUrl(sandbox: SandboxInfo): string;
+/**
+ * Build a URL to access a specific container port on a sandbox.
+ * Provider-agnostic: {BACKEND_URL}/p/{externalId}/{containerPort}
+ */
+export declare function getSandboxPortUrl(sandbox: SandboxInfo, containerPort: string): string | null;
+//# sourceMappingURL=urls.d.ts.map

package/dist/platform/platform-client/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../../src/platform/platform-client/urls.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAG1D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAS1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAKf"}

package/dist/platform/platform-client/urls.js

@@ -0,0 +1,31 @@
+/**
+ * Platform API client — sandbox URL and port helpers.
+ */
+import { SANDBOX_PORTS } from './types.js';
+import { getPlatformUrl } from './shared.js';
+/**
+ * Build the OpenCode server URL for a sandbox.
+ * Provider-agnostic: {BACKEND_URL}/p/{externalId}/8000
+ *
+ * The external_id is the sandbox's Daytona ID, used for proxy routing.
+ * Guards against missing external_id to prevent broken URLs.
+ */
+export function getSandboxUrl(sandbox) {
+    if (!sandbox.external_id) {
+        if (sandbox.base_url)
+            return sandbox.base_url;
+        throw new Error(`Cannot build sandbox URL: missing external_id for ${sandbox.provider} sandbox "${sandbox.sandbox_id}"`);
+    }
+    return `${getPlatformUrl()}/p/${sandbox.external_id}/${SANDBOX_PORTS.KORTIX_MASTER}`;
+}
+/**
+ * Build a URL to access a specific container port on a sandbox.
+ * Provider-agnostic: {BACKEND_URL}/p/{externalId}/{containerPort}
+ */
+export function getSandboxPortUrl(sandbox, containerPort) {
+    if (sandbox.external_id) {
+        return `${getPlatformUrl()}/p/${sandbox.external_id}/${containerPort}`;
+    }
+    return null;
+}
+//# sourceMappingURL=urls.js.map

package/dist/platform/platform-client/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../../../src/platform/platform-client/urls.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAoB,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAoB;IAChD,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,qDAAqD,OAAO,CAAC,QAAQ,aAAa,OAAO,CAAC,UAAU,GAAG,CACxG,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,cAAc,EAAE,MAAM,OAAO,CAAC,WAAW,IAAI,aAAa,CAAC,aAAa,EAAE,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAoB,EACpB,aAAqB;IAErB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,GAAG,cAAc,EAAE,MAAM,OAAO,CAAC,WAAW,IAAI,aAAa,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}