@cats-inc/cats-platform 0.1.0

package/build/server/products/shared/artifactCanvas/contracts.js

@@ -0,0 +1,321 @@
+export const ARTIFACT_CANVAS_SURFACE_KINDS = [
+    'code_task',
+    'code_codespace',
+    'work_item',
+    'work_project',
+    'work_task',
+    'chat_conversation',
+];
+export const ARTIFACT_CANVAS_INPUT_PRESENTATIONS = [
+    'auto',
+    'iframe',
+    'image',
+    'pdf',
+    'code',
+];
+export const ARTIFACT_CANVAS_RESOLVED_PRESENTATIONS = [
+    ...ARTIFACT_CANVAS_INPUT_PRESENTATIONS,
+    'unsupported',
+];
+export const ARTIFACT_CANVAS_SHOW_TOOL_NAME = 'show_in_canvas';
+export const ARTIFACT_CANVAS_CLEAR_TOOL_NAME = 'clear_canvas';
+export const ARTIFACT_CANVAS_TOOL_SCHEMA_VERSION = '1.0';
+export const ARTIFACT_CANVAS_RENDER_INTENT_STREAM_PATH = '/api/canvas/intents/stream';
+export const ARTIFACT_CANVAS_RENDER_INTENT_ACK_PATH = '/api/canvas/intents/ack';
+export const ARTIFACT_CANVAS_SHOW_TOOL_DEFINITION = {
+    name: ARTIFACT_CANVAS_SHOW_TOOL_NAME,
+    schemaVersion: ARTIFACT_CANVAS_TOOL_SCHEMA_VERSION,
+    description: [
+        'Open a canvas-eligible artifact in the active product surface Artifact Canvas.',
+        'Pass exactly one of artifactId or declarationId.',
+        'Use presentation auto unless the user or artifact type requires iframe, image, pdf, or code.',
+    ].join(' '),
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            artifactId: { type: ['string', 'null'], minLength: 1 },
+            declarationId: { type: ['string', 'null'], minLength: 1 },
+            presentation: {
+                type: ['string', 'null'],
+                enum: ARTIFACT_CANVAS_INPUT_PRESENTATIONS,
+            },
+        },
+        oneOf: [
+            { required: ['artifactId'] },
+            { required: ['declarationId'] },
+        ],
+    },
+};
+export const ARTIFACT_CANVAS_CLEAR_TOOL_DEFINITION = {
+    name: ARTIFACT_CANVAS_CLEAR_TOOL_NAME,
+    schemaVersion: ARTIFACT_CANVAS_TOOL_SCHEMA_VERSION,
+    description: 'Clear the active product surface Artifact Canvas by navigating back to the parent surface.',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {},
+        required: [],
+    },
+};
+export const ARTIFACT_CANVAS_TOOL_DEFINITIONS = [
+    ARTIFACT_CANVAS_SHOW_TOOL_DEFINITION,
+    ARTIFACT_CANVAS_CLEAR_TOOL_DEFINITION,
+];
+const SURFACE_ROUTE_PREFIXES = {
+    code_task: '/code/tasks',
+    code_codespace: '/code/codespaces',
+    work_item: '/work/work-items',
+    work_project: '/work/projects',
+    work_task: '/work/tasks',
+    chat_conversation: '/chat/chats',
+};
+export const canvasSurfaceRouteRegistry = {
+    parentUrl(surface) {
+        return composeParentUrl(surface);
+    },
+    canvasUrl(surface, artifactId, presentation = 'auto') {
+        return composeCanvasUrl(surface, artifactId, presentation);
+    },
+    projectionApiUrl(surface, artifactId, presentation = 'auto') {
+        return composeProjectionApiUrl(surface, artifactId, presentation);
+    },
+    parse(pathname) {
+        return parseCanvasSurfacePath(pathname);
+    },
+    parseProjectionApiPath(pathname) {
+        return parseCanvasProjectionApiPath(pathname);
+    },
+};
+export function buildArtifactCanvasRenderIntentStreamUrl(surface) {
+    assertCanvasSurface(surface);
+    const params = new URLSearchParams({
+        surfaceKind: surface.kind,
+        surfaceId: surface.surfaceId,
+    });
+    return `${ARTIFACT_CANVAS_RENDER_INTENT_STREAM_PATH}?${params.toString()}`;
+}
+export function normalizeArtifactCanvasShowToolInput(input, activeSurface) {
+    const activeSurfaceError = assertActiveSurface(activeSurface);
+    if (activeSurfaceError) {
+        return activeSurfaceError;
+    }
+    if (!isRecord(input)) {
+        return rejected('artifact_canvas_required_field_empty', 'show_in_canvas input must be an object.');
+    }
+    const artifactId = normalizeNonEmptyString(input.artifactId);
+    const declarationId = normalizeNonEmptyString(input.declarationId);
+    if (artifactId && declarationId) {
+        return rejected('artifact_canvas_identity_ambiguous', 'show_in_canvas accepts exactly one of artifactId or declarationId.');
+    }
+    if (!artifactId && !declarationId) {
+        return rejected('artifact_canvas_identity_required', 'show_in_canvas requires artifactId or declarationId.');
+    }
+    const presentation = input.presentation === undefined || input.presentation === null
+        ? 'auto'
+        : normalizeNonEmptyString(input.presentation);
+    if (!isArtifactCanvasInputPresentation(presentation)) {
+        return rejected('artifact_canvas_presentation_invalid', 'show_in_canvas presentation is invalid.', { presentation });
+    }
+    return {
+        status: 'shape_ok',
+        input: {
+            identity: artifactId
+                ? { kind: 'artifact', artifactId }
+                : { kind: 'declaration', declarationId: declarationId },
+            presentation,
+        },
+    };
+}
+export function normalizeArtifactCanvasClearToolInput(input, activeSurface) {
+    const activeSurfaceError = assertActiveSurface(activeSurface);
+    if (activeSurfaceError) {
+        return activeSurfaceError;
+    }
+    if (input !== undefined && input !== null && !isRecord(input)) {
+        return rejected('artifact_canvas_required_field_empty', 'clear_canvas input must be an object when provided.');
+    }
+    return {
+        status: 'shape_ok',
+        input: { action: 'clear_canvas' },
+    };
+}
+export function composeArtifactCanvasNavigateIntent(input) {
+    const ttlMs = input.ttlMs ?? 30_000;
+    const targetUrl = input.artifactId
+        ? composeCanvasUrl(input.surface, input.artifactId, input.presentationRequested ?? 'auto')
+        : composeParentUrl(input.surface);
+    return {
+        intentId: input.intentId,
+        activityId: input.activityId,
+        surface: input.surface,
+        targetUrl,
+        artifactId: input.artifactId,
+        presentationRequested: input.presentationRequested,
+        policyVersion: input.policyVersion,
+        triggeredAt: input.triggeredAt,
+        expiresAt: new Date(new Date(input.triggeredAt).getTime() + ttlMs).toISOString(),
+    };
+}
+function composeParentUrl(surface) {
+    assertCanvasSurface(surface);
+    return `${SURFACE_ROUTE_PREFIXES[surface.kind]}/${encodeURIComponent(surface.surfaceId)}`;
+}
+function composeCanvasUrl(surface, artifactId, presentation = 'auto') {
+    assertCanvasSurface(surface);
+    const normalizedArtifactId = normalizeRequiredPathToken(artifactId, 'artifactId');
+    const parent = composeParentUrl(surface);
+    const base = `${parent}/canvas/${encodeURIComponent(normalizedArtifactId)}`;
+    return presentation === 'auto'
+        ? base
+        : `${base}/view/${presentation}`;
+}
+function composeProjectionApiUrl(surface, artifactId, presentation = 'auto') {
+    assertCanvasSurface(surface);
+    const normalizedArtifactId = normalizeRequiredPathToken(artifactId, 'artifactId');
+    const base = `/api/canvas/${encodeURIComponent(surface.kind)}/${encodeURIComponent(surface.surfaceId)}/artifacts/${encodeURIComponent(normalizedArtifactId)}`;
+    return presentation === 'auto'
+        ? base
+        : `${base}/view/${presentation}`;
+}
+function parseCanvasSurfacePath(pathname) {
+    const segments = splitPath(pathname);
+    for (const surfaceKind of ARTIFACT_CANVAS_SURFACE_KINDS) {
+        const prefixSegments = splitPath(SURFACE_ROUTE_PREFIXES[surfaceKind]);
+        if (!startsWithSegments(segments, prefixSegments)) {
+            continue;
+        }
+        const surfaceId = segments[prefixSegments.length];
+        if (!surfaceId || segments.length < prefixSegments.length + 1) {
+            continue;
+        }
+        const surface = { kind: surfaceKind, surfaceId: decodeURIComponent(surfaceId) };
+        const parentUrl = composeParentUrl(surface);
+        if (segments.length === prefixSegments.length + 1) {
+            return { kind: 'parent', surface, parentUrl };
+        }
+        if (segments[prefixSegments.length + 1] !== 'canvas') {
+            continue;
+        }
+        return parseCanvasTail({
+            surface,
+            parentUrl,
+            tail: segments.slice(prefixSegments.length + 2),
+            composeCanvas: true,
+        });
+    }
+    return null;
+}
+function parseCanvasProjectionApiPath(pathname) {
+    const segments = splitPath(pathname);
+    if (segments.length !== 6
+        && segments.length !== 8) {
+        return null;
+    }
+    if (segments[0] !== 'api' || segments[1] !== 'canvas' || segments[4] !== 'artifacts') {
+        return null;
+    }
+    const surfaceKind = decodeURIComponent(segments[2] ?? '');
+    if (!isCanvasSurfaceKind(surfaceKind)) {
+        return null;
+    }
+    const surfaceId = segments[3];
+    if (!surfaceId) {
+        return null;
+    }
+    const surface = { kind: surfaceKind, surfaceId: decodeURIComponent(surfaceId) };
+    const parentUrl = composeParentUrl(surface);
+    return parseCanvasTail({
+        surface,
+        parentUrl,
+        tail: segments.slice(5),
+        composeCanvas: false,
+    });
+}
+function parseCanvasTail(input) {
+    const artifactId = input.tail[0];
+    if (!artifactId) {
+        return null;
+    }
+    let presentationRequested = 'auto';
+    if (input.tail.length === 3) {
+        if (input.tail[1] !== 'view' || !isArtifactCanvasInputPresentation(input.tail[2])) {
+            return null;
+        }
+        presentationRequested = input.tail[2];
+    }
+    else if (input.tail.length !== 1) {
+        return null;
+    }
+    return {
+        kind: 'canvas',
+        surface: input.surface,
+        parentUrl: input.parentUrl,
+        canvasUrl: input.composeCanvas
+            ? composeCanvasUrl(input.surface, decodeURIComponent(artifactId), presentationRequested)
+            : composeProjectionApiUrl(input.surface, decodeURIComponent(artifactId), presentationRequested),
+        artifactId: decodeURIComponent(artifactId),
+        presentationRequested,
+    };
+}
+function assertActiveSurface(surface) {
+    if (!surface) {
+        return rejected('artifact_canvas_no_active_surface', 'Artifact Canvas tools require an active product surface.');
+    }
+    try {
+        assertCanvasSurface(surface);
+    }
+    catch (error) {
+        return rejected('artifact_canvas_no_active_surface', error instanceof Error ? error.message : 'Active surface is invalid.');
+    }
+    return null;
+}
+function assertCanvasSurface(surface) {
+    if (!isCanvasSurfaceKind(surface.kind)) {
+        throw new Error(`Unsupported canvas surface kind: ${surface.kind}`);
+    }
+    normalizeRequiredPathToken(surface.surfaceId, 'surfaceId');
+}
+function normalizeRequiredPathToken(value, field) {
+    const normalized = normalizeNonEmptyString(value);
+    if (!normalized) {
+        throw new Error(`${field} is required.`);
+    }
+    return normalized;
+}
+function isCanvasSurfaceKind(input) {
+    return ARTIFACT_CANVAS_SURFACE_KINDS.includes(input);
+}
+function isArtifactCanvasInputPresentation(input) {
+    return ARTIFACT_CANVAS_INPUT_PRESENTATIONS.includes(input);
+}
+function splitPath(pathname) {
+    return pathname.split('?')[0].split('/').filter(Boolean);
+}
+function startsWithSegments(segments, prefix) {
+    if (segments.length < prefix.length) {
+        return false;
+    }
+    return prefix.every((segment, index) => segments[index] === segment);
+}
+function normalizeNonEmptyString(input) {
+    if (typeof input !== 'string') {
+        return null;
+    }
+    const trimmed = input.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function rejected(code, message, details) {
+    return {
+        status: 'rejected',
+        error: {
+            code,
+            message,
+            ...(details !== undefined ? { details } : {}),
+        },
+    };
+}
+function isRecord(input) {
+    return typeof input === 'object' && input !== null && !Array.isArray(input);
+}
+//# sourceMappingURL=contracts.js.map

package/build/server/products/shared/artifactCanvas/contracts.js.map

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

package/build/server/products/shared/artifactCanvas/iframePolicy.d.ts

@@ -0,0 +1,81 @@
+import type { ArtifactCanvasError, ArtifactCanvasIframeSandboxProfile, CanvasSurfaceRef } from './contracts.js';
+import type { CoreArtifactRecord } from '../../../core/types.js';
+export type ArtifactCanvasUrlScheme = 'http' | 'https';
+export interface ArtifactCanvasRuntimePreviewOriginAllowlistEntry {
+    hostname: string;
+    schemes?: ArtifactCanvasUrlScheme[];
+    ports?: number[] | '*';
+}
+export interface ArtifactCanvasScriptedPreviewProducerAllowlistEntry {
+    producerKind: 'tool' | 'system' | 'user';
+    producerIdentity: string;
+}
+export interface ArtifactCanvasPolicyConfig {
+    runtimePreviewOriginAllowlist: ArtifactCanvasRuntimePreviewOriginAllowlistEntry[];
+    scriptedPreviewProducerAllowlist: ArtifactCanvasScriptedPreviewProducerAllowlistEntry[];
+    catsShellOrigin: string;
+}
+export interface ArtifactCanvasProducerIdentity {
+    kind: 'agent' | 'tool' | 'system' | 'user';
+    producerIdentity: string | null;
+}
+export interface ArtifactCanvasSupervisorPreviewLease {
+    previewId: string;
+    origin: string;
+    status: string;
+    surface: CanvasSurfaceRef;
+    workspaceRef: {
+        id: string;
+        rootPath: string;
+    };
+    artifactId: string | null;
+    expiresAt: string;
+}
+export interface ArtifactCanvasSupervisorPreviewLeaseStore {
+    getLease(previewId: string): ArtifactCanvasSupervisorPreviewLease | null;
+}
+export type ArtifactCanvasIframePolicyDecision = {
+    status: 'accepted';
+    safeUrl: string;
+    profile: ArtifactCanvasIframeSandboxProfile;
+    policyVersion: string;
+} | {
+    status: 'rejected';
+    error: ArtifactCanvasError;
+    policyVersion: string;
+};
+export declare const ARTIFACT_CANVAS_POLICY_VERSION_ALGORITHM: "artifact-canvas-policy-v1";
+export declare const DEFAULT_ARTIFACT_CANVAS_RUNTIME_PREVIEW_ORIGIN_ALLOWLIST: readonly ArtifactCanvasRuntimePreviewOriginAllowlistEntry[];
+export declare const DEFAULT_ARTIFACT_CANVAS_POLICY_CONFIG: ArtifactCanvasPolicyConfig;
+export declare const ARTIFACT_CANVAS_STATIC_IFRAME_SANDBOX_PROFILE: ArtifactCanvasIframeSandboxProfile;
+export declare const ARTIFACT_CANVAS_SCRIPTED_CROSS_ORIGIN_IFRAME_SANDBOX_PROFILE: ArtifactCanvasIframeSandboxProfile;
+export declare function normalizeArtifactCanvasHostname(hostname: string): string;
+export declare function validateArtifactCanvasPolicyConfig(config: ArtifactCanvasPolicyConfig): void;
+export declare function buildArtifactCanvasPolicyVersion(config?: ArtifactCanvasPolicyConfig): {
+    canonicalJson: string;
+    policyVersion: string;
+};
+export declare function isUrlAllowedArtifactCanvasScheme(value: string): boolean;
+export declare function rejectArtifactCanvasCredentialUrl(value: string): ArtifactCanvasError | null;
+export declare function matchesArtifactCanvasRuntimePreviewOrigin(value: string, config?: ArtifactCanvasPolicyConfig): boolean;
+export declare function canUseScriptedArtifactCanvasPreview(input: {
+    producer: ArtifactCanvasProducerIdentity;
+    config?: ArtifactCanvasPolicyConfig;
+}): boolean;
+export declare function isSupervisorOwnedPreviewOrigin(input: {
+    url: string;
+    artifact: CoreArtifactRecord;
+    leaseStore?: ArtifactCanvasSupervisorPreviewLeaseStore | null;
+    now?: Date;
+}): boolean;
+export declare function resolveArtifactCanvasIframePolicy(input: {
+    url: string;
+    producer: ArtifactCanvasProducerIdentity;
+    artifact?: CoreArtifactRecord | null;
+    artifactKind?: string | null;
+    config?: ArtifactCanvasPolicyConfig;
+    supervisorPreviewLeaseStore?: ArtifactCanvasSupervisorPreviewLeaseStore | null;
+    now?: Date;
+}): ArtifactCanvasIframePolicyDecision;
+export declare function stableJsonStringify(value: unknown): string;
+//# sourceMappingURL=iframePolicy.d.ts.map

package/build/server/products/shared/artifactCanvas/iframePolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframePolicy.d.ts","sourceRoot":"","sources":["../../../../../src/products/shared/artifactCanvas/iframePolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,kCAAkC,EAClC,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,gDAAgD;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;CACxB;AAED,MAAM,WAAW,mDAAmD;IAClE,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,6BAA6B,EAAE,gDAAgD,EAAE,CAAC;IAClF,gCAAgC,EAAE,mDAAmD,EAAE,CAAC;IACxF,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,oCAAoC;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;IAC1B,YAAY,EAAE;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,oCAAoC,GAAG,IAAI,CAAC;CAC1E;AAED,MAAM,MAAM,kCAAkC,GAC1C;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,kCAAkC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC;CACvB,GACD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAmBN,eAAO,MAAM,wCAAwC,EAAG,2BAAoC,CAAC;AAE7F,eAAO,MAAM,wDAAwD,EACnE,SAAS,gDAAgD,EAIxD,CAAC;AAEJ,eAAO,MAAM,qCAAqC,EAAE,0BAMnD,CAAC;AAEF,eAAO,MAAM,6CAA6C,EACxD,kCAKC,CAAC;AAEJ,eAAO,MAAM,4DAA4D,EACvE,kCAKC,CAAC;AAEJ,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMxE;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,0BAA0B,GACjC,IAAI,CAEN;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,GAAE,0BAAkE,GACzE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAclD;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOvE;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAgB3F;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,0BAAkE,GACzE,OAAO,CAgBT;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,EAAE,8BAA8B,CAAC;IACzC,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC,GAAG,OAAO,CAcV;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,UAAU,CAAC,EAAE,yCAAyC,GAAG,IAAI,CAAC;IAC9D,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAmCV;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,8BAA8B,CAAC;IACzC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,2BAA2B,CAAC,EAAE,yCAAyC,GAAG,IAAI,CAAC;IAC/E,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,kCAAkC,CA2CrC;AAWD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAY1D"}