@cats-inc/cats-platform 0.1.0

package/build/server/shared/bootstrapDiagnostics.js

@@ -0,0 +1,86 @@
+export const BOOTSTRAP_EVENT_LAYERS = [
+    'runtime',
+    'product',
+    'host',
+];
+export const BOOTSTRAP_EVENT_STATUSES = [
+    'ok',
+    'degraded',
+    'unavailable',
+    'info',
+];
+export const DEFAULT_PRODUCT_BOOTSTRAP_HISTORY_LIMIT = 100;
+export const DEFAULT_HOST_BOOTSTRAP_HISTORY_LIMIT = 100;
+export const DEFAULT_MERGED_BOOTSTRAP_HISTORY_LIMIT = 150;
+export const DEFAULT_PER_LAYER_BOOTSTRAP_HISTORY_MINIMUM = 20;
+function parseTimestamp(value) {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+export function ensureBootstrapEventTimestamp(timestamp, latestTimestamp) {
+    const candidate = parseTimestamp(timestamp);
+    const latest = latestTimestamp ? parseTimestamp(latestTimestamp) : 0;
+    if (candidate > latest) {
+        return timestamp;
+    }
+    return new Date(latest + 1).toISOString();
+}
+export function sortBootstrapEventsByTimestamp(events) {
+    return [...events].sort((left, right) => {
+        const timestampDelta = parseTimestamp(right.timestamp) - parseTimestamp(left.timestamp);
+        if (timestampDelta !== 0) {
+            return timestampDelta;
+        }
+        return left.kind.localeCompare(right.kind);
+    });
+}
+export function trimBootstrapEvents(events, limit) {
+    if (limit <= 0) {
+        return [];
+    }
+    const sorted = sortBootstrapEventsByTimestamp(events);
+    return sorted.slice(0, limit);
+}
+export function normalizeBootstrapEventStatus(value, fallback = 'info') {
+    return value === 'ok'
+        || value === 'degraded'
+        || value === 'unavailable'
+        || value === 'info'
+        ? value
+        : fallback;
+}
+export function toBootstrapEventError(error) {
+    if (!error) {
+        return undefined;
+    }
+    if (typeof error === 'string') {
+        return error.trim() ? { message: error } : undefined;
+    }
+    if (error instanceof Error) {
+        return {
+            message: error.message || error.name || 'Unknown error',
+            cause: typeof error.cause === 'string' ? error.cause : undefined,
+            stack: error.stack,
+        };
+    }
+    return {
+        message: String(error),
+    };
+}
+export function summarizeBootstrapEvents(events, fallback) {
+    const latest = sortBootstrapEventsByTimestamp(events)[0];
+    if (!latest) {
+        return {
+            status: fallback.status,
+            summary: fallback.summary,
+            latestTimestamp: null,
+        };
+    }
+    return {
+        status: latest.status,
+        summary: latest.summary,
+        latestTimestamp: latest.timestamp,
+        latestReference: latest.reference,
+    };
+}
+//# sourceMappingURL=bootstrapDiagnostics.js.map

package/build/server/shared/bootstrapDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapDiagnostics.js","sourceRoot":"","sources":["../../../src/shared/bootstrapDiagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS;IACT,SAAS;IACT,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI;IACJ,UAAU;IACV,aAAa;IACb,MAAM;CACE,CAAC;AA2DX,MAAM,CAAC,MAAM,uCAAuC,GAAG,GAAG,CAAC;AAC3D,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AACxD,MAAM,CAAC,MAAM,sCAAsC,GAAG,GAAG,CAAC;AAC1D,MAAM,CAAC,MAAM,2CAA2C,GAAG,EAAE,CAAC;AAE9D,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,SAAiB,EACjB,eAA+B;IAE/B,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAA2B,MAAW;IAClF,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACtC,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxF,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAA2B,MAAW,EAAE,KAAa;IACtF,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,WAAiC,MAAM;IAEvC,OAAO,KAAK,KAAK,IAAI;WAChB,KAAK,KAAK,UAAU;WACpB,KAAK,KAAK,aAAa;WACvB,KAAK,KAAK,MAAM;QACnB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,eAAe;YACvD,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YAChE,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAwB,EACxB,QAGC;IAED,MAAM,MAAM,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,eAAe,EAAE,MAAM,CAAC,SAAS;QACjC,eAAe,EAAE,MAAM,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC"}

package/build/server/shared/catMcpProfiles.d.ts

@@ -0,0 +1,7 @@
+export declare const CHAT_MCP_PROFILE_ID: "chat-memory";
+export declare const WORK_MCP_PROFILE_ID: "work-memory";
+export declare const CAT_MCP_PROFILE_IDS: readonly ["chat-memory", "work-memory"];
+export type CatMcpProfileId = typeof CAT_MCP_PROFILE_IDS[number];
+export declare function isCatMcpProfileId(value: string): value is CatMcpProfileId;
+export declare function normalizeCatMcpProfile(profile: string | null | undefined): CatMcpProfileId | null;
+//# sourceMappingURL=catMcpProfiles.d.ts.map

package/build/server/shared/catMcpProfiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catMcpProfiles.d.ts","sourceRoot":"","sources":["../../../src/shared/catMcpProfiles.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,EAAG,aAAsB,CAAC;AAC1D,eAAO,MAAM,mBAAmB,EAAG,aAAsB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,yCAGtB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAEjE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,eAAe,GAAG,IAAI,CASxB"}

package/build/server/shared/catMcpProfiles.js

@@ -0,0 +1,20 @@
+export const CHAT_MCP_PROFILE_ID = 'chat-memory';
+export const WORK_MCP_PROFILE_ID = 'work-memory';
+export const CAT_MCP_PROFILE_IDS = [
+    CHAT_MCP_PROFILE_ID,
+    WORK_MCP_PROFILE_ID,
+];
+export function isCatMcpProfileId(value) {
+    return CAT_MCP_PROFILE_IDS.includes(value);
+}
+export function normalizeCatMcpProfile(profile) {
+    const normalized = profile?.trim();
+    if (!normalized) {
+        return null;
+    }
+    if (!isCatMcpProfileId(normalized)) {
+        throw new Error(`Unsupported Cat MCP profile: ${normalized}`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=catMcpProfiles.js.map

package/build/server/shared/catMcpProfiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catMcpProfiles.js","sourceRoot":"","sources":["../../../src/shared/catMcpProfiles.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAsB,CAAC;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAsB,CAAC;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,mBAAmB;IACnB,mBAAmB;CACX,CAAC;AAIX,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAQ,mBAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAkC;IAElC,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/build/server/shared/catsAppManifest.d.ts

@@ -0,0 +1,127 @@
+export declare const CATS_APP_MANIFEST_SCHEMA_VERSION = 1;
+export declare const CATS_APP_CATEGORIES: readonly ["user-app", "capability-connector", "product-module"];
+export type CatsAppCategory = typeof CATS_APP_CATEGORIES[number];
+export declare const CATS_APP_TRUST_TIERS: readonly ["system", "local-user", "third-party"];
+export type CatsAppTrustTier = typeof CATS_APP_TRUST_TIERS[number];
+export declare const CATS_APP_PERMISSIONS: readonly ["ui.route", "ui.lobby", "settings.app", "storage.appData", "agent.tools.register", "agent.tools.execute", "connector.auth", "runtime.adapter", "jobs.schedule", "core.read", "core.write"];
+export type CatsAppPermission = typeof CATS_APP_PERMISSIONS[number];
+export interface CatsAppPublisher {
+    name: string;
+    homepage?: string;
+    email?: string;
+}
+export interface CatsAppCompatibility {
+    catsPlatform: string;
+    appSdk: string;
+}
+export interface CatsAppEntrypoints {
+    renderer?: string;
+    server?: string;
+    worker?: string;
+}
+export interface CatsLobbyAppContribution {
+    id: string;
+    title: string;
+    subtitle?: string;
+    routePath: `/apps/${string}`;
+    icon?: string;
+    maturity?: 'active' | 'preview';
+}
+export interface CatsProductModuleContribution {
+    productId: string;
+    productName: string;
+    subtitle: string;
+    routePrefix: `/${string}`;
+    group: 'home' | 'office';
+    installPolicy: 'required' | 'optional';
+    maturity: 'active' | 'preview';
+    settings?: CatsAppSettingsContribution[];
+}
+export interface CatsAppSettingsContribution {
+    id: string;
+    label: string;
+    path: `/settings/apps/${string}` | `/settings/${string}`;
+}
+export interface CatsAgentToolContribution {
+    name: `${string}.${string}`;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    requiresApproval?: boolean;
+    runtimeBridge?: 'platform' | 'cats-runtime';
+}
+export interface CatsConnectorAuthDeclaration {
+    kind: 'none' | 'api-key' | 'oauth' | 'local-token' | 'external-cli';
+    setupHint?: string;
+    secretRefs?: string[];
+}
+export interface CatsConnectorContribution {
+    id: string;
+    service: string;
+    auth?: CatsConnectorAuthDeclaration;
+    capabilities: string[];
+    setupPath?: `/settings/apps/${string}` | `/settings/${string}`;
+}
+export interface CatsScopedApiRouteContribution {
+    routeKey: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: `/${string}`;
+    permission: CatsAppPermission;
+}
+export interface CatsJobContribution {
+    id: string;
+    title: string;
+    schedule?: string;
+    permission: 'jobs.schedule';
+}
+export interface CatsAppContributions {
+    lobbyApps?: CatsLobbyAppContribution[];
+    products?: CatsProductModuleContribution[];
+    settings?: CatsAppSettingsContribution[];
+    tools?: CatsAgentToolContribution[];
+    connectors?: CatsConnectorContribution[];
+    apiRoutes?: CatsScopedApiRouteContribution[];
+    jobs?: CatsJobContribution[];
+}
+export interface CatsAppManifestV1 {
+    schemaVersion: typeof CATS_APP_MANIFEST_SCHEMA_VERSION;
+    id: string;
+    displayName: string;
+    version: string;
+    description?: string;
+    category: CatsAppCategory;
+    trustTier: CatsAppTrustTier;
+    publisher: CatsAppPublisher;
+    compatibility: CatsAppCompatibility;
+    entrypoints?: CatsAppEntrypoints;
+    contributions: CatsAppContributions;
+    permissions: CatsAppPermission[];
+}
+export type CatsAppInstallState = 'installed' | 'enabled' | 'disabled' | 'error' | 'upgrade-pending' | 'uninstalled';
+export interface CatsInstalledAppRecord {
+    id: string;
+    manifest: CatsAppManifestV1;
+    packagePath: string;
+    installState: CatsAppInstallState;
+    enabled: boolean;
+    installedAt: string;
+    updatedAt: string;
+    lastError?: string | null;
+}
+export interface PlatformInstalledAppDescriptor {
+    id: string;
+    displayName: string;
+    publisher: string;
+    version: string;
+    category: CatsAppCategory;
+    trustTier: CatsAppTrustTier;
+    permissions: CatsAppPermission[];
+    installState: CatsAppInstallState;
+    enabled: boolean;
+    lobbyEntries: CatsLobbyAppContribution[];
+    connectors: CatsConnectorContribution[];
+    tools: CatsAgentToolContribution[];
+    settings?: CatsAppSettingsContribution[];
+}
+//# sourceMappingURL=catsAppManifest.d.ts.map

package/build/server/shared/catsAppManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catsAppManifest.d.ts","sourceRoot":"","sources":["../../../src/shared/catsAppManifest.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,eAAO,MAAM,mBAAmB,iEAItB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAEjE,eAAO,MAAM,oBAAoB,kDAIvB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,oBAAoB,sMAYvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,IAAI,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,aAAa,EAAE,UAAU,GAAG,UAAU,CAAC;IACvC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,2BAA2B,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,kBAAkB,MAAM,EAAE,GAAG,aAAa,MAAM,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;CAC7C;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,CAAC;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,4BAA4B,CAAC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,kBAAkB,MAAM,EAAE,GAAG,aAAa,MAAM,EAAE,CAAC;CAChE;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,6BAA6B,EAAE,CAAC;IAC3C,QAAQ,CAAC,EAAE,2BAA2B,EAAE,CAAC;IACzC,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC7C,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,aAAa,EAAE,oBAAoB,CAAC;IACpC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,aAAa,EAAE,oBAAoB,CAAC;IACpC,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,SAAS,GACT,UAAU,GACV,OAAO,GACP,iBAAiB,GACjB,aAAa,CAAC;AAElB,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,wBAAwB,EAAE,CAAC;IACzC,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,2BAA2B,EAAE,CAAC;CAC1C"}

package/build/server/shared/catsAppManifest.js

@@ -0,0 +1,25 @@
+export const CATS_APP_MANIFEST_SCHEMA_VERSION = 1;
+export const CATS_APP_CATEGORIES = [
+    'user-app',
+    'capability-connector',
+    'product-module',
+];
+export const CATS_APP_TRUST_TIERS = [
+    'system',
+    'local-user',
+    'third-party',
+];
+export const CATS_APP_PERMISSIONS = [
+    'ui.route',
+    'ui.lobby',
+    'settings.app',
+    'storage.appData',
+    'agent.tools.register',
+    'agent.tools.execute',
+    'connector.auth',
+    'runtime.adapter',
+    'jobs.schedule',
+    'core.read',
+    'core.write',
+];
+//# sourceMappingURL=catsAppManifest.js.map

package/build/server/shared/catsAppManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catsAppManifest.js","sourceRoot":"","sources":["../../../src/shared/catsAppManifest.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU;IACV,sBAAsB;IACtB,gBAAgB;CACR,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,YAAY;IACZ,aAAa;CACL,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,UAAU;IACV,UAAU;IACV,cAAc;IACd,iBAAiB;IACjB,sBAAsB;IACtB,qBAAqB;IACrB,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,YAAY;CACJ,CAAC"}

package/build/server/shared/catsAppSdk.d.ts

@@ -0,0 +1,67 @@
+import type { CatsAgentToolContribution, CatsAppCategory, CatsAppPermission, CatsAppTrustTier } from './catsAppManifest.js';
+import type { PlatformSurfaceId } from './platform-contract.js';
+export interface CatsAppModule {
+    activate?: (ctx: CatsAppActivationContext) => Promise<void> | void;
+    deactivate?: (ctx: CatsAppActivationContext) => Promise<void> | void;
+}
+export interface CatsAppActivationContext {
+    app: {
+        id: string;
+        version: string;
+        category: CatsAppCategory;
+        trustTier: CatsAppTrustTier;
+    };
+    permissions: CatsAppPermissionGate;
+    storage: CatsScopedAppStorage;
+    settings: CatsScopedSettingsStore;
+    tools: CatsToolRegistrationApi;
+    runtime: CatsRuntimeBridgeApi;
+    core: CatsCoreBridgeApi;
+    log: CatsAppLogger;
+}
+export interface CatsAppPermissionGate {
+    has(permission: CatsAppPermission): boolean;
+    require(permission: CatsAppPermission): void;
+}
+export interface CatsScopedAppStorage {
+    get<TValue>(key: string): Promise<TValue | null>;
+    set<TValue>(key: string, value: TValue): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): Promise<string[]>;
+}
+export interface CatsScopedSettingsStore {
+    get<TValue>(key: string): Promise<TValue | null>;
+    set<TValue>(key: string, value: TValue): Promise<void>;
+}
+export interface CatsToolRegistrationApi {
+    register(tool: CatsAgentToolContribution): void;
+}
+export interface CatsRuntimeBridgeApi {
+    request<TInput, TOutput>(operation: string, input: TInput): Promise<TOutput>;
+}
+export interface CatsCoreBridgeApi {
+    query<TInput, TOutput>(operation: string, input: TInput): Promise<TOutput>;
+    mutate<TInput, TOutput>(operation: string, input: TInput): Promise<TOutput>;
+}
+export interface CatsAppLogger {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+export interface CatsAppRendererContext {
+    appId: string;
+    route: CatsAppRendererRouteContext;
+    locale: string;
+    theme: 'system' | 'light' | 'dark';
+    navigate(path: string): void;
+    openCatsSurface(surface: PlatformSurfaceId, path?: string): void;
+    callAction<TInput, TOutput>(key: string, input: TInput): Promise<TOutput>;
+    readState<TValue>(key: string): Promise<TValue | null>;
+    writeState<TValue>(key: string, value: TValue): Promise<void>;
+}
+export interface CatsAppRendererRouteContext {
+    pathname: string;
+    params: Record<string, string>;
+    query: URLSearchParams;
+}
+//# sourceMappingURL=catsAppSdk.d.ts.map

package/build/server/shared/catsAppSdk.d.ts.map

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

package/build/server/shared/catsAppSdk.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=catsAppSdk.js.map

package/build/server/shared/catsAppSdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catsAppSdk.js","sourceRoot":"","sources":["../../../src/shared/catsAppSdk.ts"],"names":[],"mappings":""}

package/build/server/shared/catsAppValidation.d.ts

@@ -0,0 +1,21 @@
+import { type CatsAppManifestV1 } from './catsAppManifest.js';
+export interface CatsAppManifestValidationIssue {
+    code: string;
+    message: string;
+    path?: string;
+    details?: Record<string, unknown>;
+}
+export interface CatsAppManifestValidationOptions {
+    existingAppIds?: ReadonlyArray<string>;
+    productRoutePrefixes?: ReadonlyArray<string>;
+    reservedSettingsPaths?: ReadonlyArray<string>;
+}
+export type CatsAppManifestParseResult = {
+    ok: true;
+    manifest: CatsAppManifestV1;
+} | {
+    ok: false;
+    issues: CatsAppManifestValidationIssue[];
+};
+export declare function parseCatsAppManifestV1(input: unknown, options?: CatsAppManifestValidationOptions): CatsAppManifestParseResult;
+//# sourceMappingURL=catsAppValidation.d.ts.map

package/build/server/shared/catsAppValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catsAppValidation.d.ts","sourceRoot":"","sources":["../../../src/shared/catsAppValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,iBAAiB,EAEvB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gCAAgC;IAC/C,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,oBAAoB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,qBAAqB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,8BAA8B,EAAE,CAAA;CAAE,CAAC;AA0E5D,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,gCAAqC,GAC7C,0BAA0B,CA+H5B"}