@camstack/core 0.1.15 → 0.1.17

package/dist/builtins/mesh-orchestrator/mesh-orchestrator.addon.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-orchestrator.addon.mjs","names":[],"sources":["../../../src/builtins/mesh-orchestrator/mesh-orchestrator.addon.ts"],"sourcesContent":["/**\n * Mesh orchestrator — singleton facade over the `mesh-network`\n * collection. One row per provider (Tailscale, Headscale, ZeroTier),\n * aggregated for the admin UI's Mesh Networks page.\n */\nimport {\n  BaseAddon,\n  meshOrchestratorCapability,\n  type IMeshOrchestrator,\n  type MeshProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface MeshNetworkLike {\n  getStatus?: () => Promise<{\n    joined: boolean\n    meshIp: string\n    magicDnsHostname: string\n    peerCount: number\n    endpoints: readonly {\n      id: string\n      label: string\n      scope: 'mesh' | 'public'\n      url: string\n      hostname: string\n      port: number\n      protocol: 'http' | 'https'\n    }[]\n    error?: string\n  }>\n  join?: (input: { authKey: string; hostname?: string }) => Promise<{ joined: true }>\n  leave?: () => Promise<{ left: true }>\n}\n\ninterface MeshRegistrationMeta {\n  readonly displayName?: string\n  readonly kind?: MeshProviderInfo['kind']\n}\n\nexport class MeshOrchestratorAddon extends BaseAddon<Record<string, never>> {\n  constructor() {\n    super({})\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: IMeshOrchestrator = {\n      listProviders: async () => this.listProviders(),\n      joinProvider: async ({ addonId, authKey, hostname }) => {\n        const impl = this.resolveImpl(addonId)\n        if (!impl?.join) throw new Error(`Mesh provider \"${addonId}\" does not support join`)\n        return await impl.join({ authKey, ...(hostname ? { hostname } : {}) })\n      },\n      leaveProvider: async ({ addonId }) => {\n        const impl = this.resolveImpl(addonId)\n        if (impl?.leave) await impl.leave()\n        return { success: true as const }\n      },\n    }\n    this.ctx.logger.info('Mesh orchestrator initialized')\n    return [{ capability: meshOrchestratorCapability, provider }]\n  }\n\n  private resolveImpl(addonId: string): MeshNetworkLike | null {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike>('mesh-network') ?? []\n    const found = entries.find(([id]) => id === addonId)\n    return found?.[1] ?? null\n  }\n\n  private async listProviders(): Promise<readonly MeshProviderInfo[]> {\n    const entries = this.capabilities?.getCollectionEntries<MeshNetworkLike & MeshRegistrationMeta>(\n      'mesh-network',\n    ) ?? []\n    const out: MeshProviderInfo[] = []\n    for (const [addonId, impl] of entries) {\n      let joined = false\n      let meshIp = ''\n      let magicDnsHostname = ''\n      let peerCount = 0\n      let endpoints: MeshProviderInfo['endpoints'] = []\n      let error: string | undefined\n      if (impl.getStatus) {\n        try {\n          const s = await impl.getStatus()\n          joined = s.joined\n          meshIp = s.meshIp\n          magicDnsHostname = s.magicDnsHostname\n          peerCount = s.peerCount\n          endpoints = s.endpoints\n          error = s.error\n        } catch (err) {\n          error = err instanceof Error ? err.message : String(err)\n        }\n      }\n      out.push({\n        addonId,\n        displayName: impl.displayName ?? addonId,\n        kind: impl.kind ?? (addonId.includes('tailscale') ? 'tailscale' as const : 'other' as const),\n        joined,\n        meshIp,\n        magicDnsHostname,\n        peerCount,\n        endpoints,\n        ...(error !== undefined ? { error } : {}),\n      })\n    }\n    return out\n  }\n}\n\nexport default MeshOrchestratorAddon\n"],"mappings":";;;;;;;AAuCA,IAAa,wBAAb,cAA2C,UAAiC;CAC1E,cAAc;EACZ,MAAM,EAAE,CAAC;;CAGX,MAAgB,eAAgD;EAC9D,MAAM,WAA8B;GAClC,eAAe,YAAY,KAAK,eAAe;GAC/C,cAAc,OAAO,EAAE,SAAS,SAAS,eAAe;IACtD,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,CAAC,MAAM,MAAM,MAAM,IAAI,MAAM,kBAAkB,QAAQ,yBAAyB;IACpF,OAAO,MAAM,KAAK,KAAK;KAAE;KAAS,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;KAAG,CAAC;;GAExE,eAAe,OAAO,EAAE,cAAc;IACpC,MAAM,OAAO,KAAK,YAAY,QAAQ;IACtC,IAAI,MAAM,OAAO,MAAM,KAAK,OAAO;IACnC,OAAO,EAAE,SAAS,MAAe;;GAEpC;EACD,KAAK,IAAI,OAAO,KAAK,gCAAgC;EACrD,OAAO,CAAC;GAAE,YAAY;GAA4B;GAAU,CAAC;;CAG/D,YAAoB,SAAyC;EAG3D,QAFgB,KAAK,cAAc,qBAAsC,eAAe,IAAI,EAAE,EACxE,MAAM,CAAC,QAAQ,OAAO,QACrC,GAAQ,MAAM;;CAGvB,MAAc,gBAAsD;EAClE,MAAM,UAAU,KAAK,cAAc,qBACjC,eACD,IAAI,EAAE;EACP,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,SAAS;GACrC,IAAI,SAAS;GACb,IAAI,SAAS;GACb,IAAI,mBAAmB;GACvB,IAAI,YAAY;GAChB,IAAI,YAA2C,EAAE;GACjD,IAAI;GACJ,IAAI,KAAK,WACP,IAAI;IACF,MAAM,IAAI,MAAM,KAAK,WAAW;IAChC,SAAS,EAAE;IACX,SAAS,EAAE;IACX,mBAAmB,EAAE;IACrB,YAAY,EAAE;IACd,YAAY,EAAE;IACd,QAAQ,EAAE;YACH,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC,MAAM,KAAK,SAAS,QAAQ,SAAS,YAAY,GAAG,cAAuB;IAC3E;IACA;IACA;IACA;IACA;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACzC,CAAC;;EAEJ,OAAO"}

package/dist/builtins/native-metrics/index.d.ts

@@ -0,0 +1,3 @@
+export { default as NativeMetricsAddon } from './native-metrics.addon.js';
+export { NativeMetricsProvider } from './native-metrics-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/native-metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/native-metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/builtins/native-metrics/native-metrics-provider.d.ts

@@ -0,0 +1,49 @@
+import { SystemResourceSnapshot, MemoryInfo, DiskSpaceInfo, MetricsGpuInfo, PidResourceStats } from '@camstack/types';
+interface SamplingDiagnostics {
+    warn(message: string, meta?: Record<string, unknown>): void;
+}
+export declare class NativeMetricsProvider {
+    readonly id = "native";
+    private cachedSnapshot;
+    private samplingTimer;
+    private macMemTimer;
+    private prevCpu;
+    private diagnostics;
+    private consecutiveSampleErrors;
+    constructor();
+    /**
+     * Optional diagnostics sink for sampling errors. The first failure and
+     * every Nth failure thereafter are reported so a permanently-broken
+     * collector doesn't spam logs but is still observable.
+     */
+    setDiagnostics(diag: SamplingDiagnostics): void;
+    startSampling(intervalMs: number): void;
+    private reportSampleError;
+    stopSampling(): void;
+    collectSnapshot(): Promise<SystemResourceSnapshot>;
+    getCached(): Promise<SystemResourceSnapshot | null>;
+    getCurrent(): Promise<{
+        cpuPercent: number;
+        memoryPercent: number;
+        memoryUsedMB: number;
+        memoryTotalMB: number;
+        diskPercent?: number;
+        temperature?: number;
+        gpuPercent?: number;
+        gpuMemoryPercent?: number;
+    }>;
+    getDiskSpace(input: {
+        dirPath: string;
+    }): Promise<DiskSpaceInfo>;
+    getGpuInfo(): Promise<MetricsGpuInfo | null>;
+    getCpuTemperature(): Promise<number | null>;
+    getProcessStats(input: {
+        pids: number[];
+    }): Promise<PidResourceStats[]>;
+    private sampleCpu;
+    /** Cached macOS memory (set by sampleMacMemory timer). */
+    _cachedMacMem: MemoryInfo | null;
+    private getMemoryInfo;
+}
+export {};
+//# sourceMappingURL=native-metrics-provider.d.ts.map

package/dist/builtins/native-metrics/native-metrics-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-metrics-provider.d.ts","sourceRoot":"","sources":["../../../src/builtins/native-metrics/native-metrics-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EAEtB,UAAU,EACV,aAAa,EAGb,cAAc,EAGd,gBAAgB,EACjB,MAAM,iBAAiB,CAAA;AAsBxB,UAAU,mBAAmB;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC5D;AAED,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,EAAE,YAAW;IAEtB,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,uBAAuB,CAAI;;IAMnC;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAM/C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAqBvC,OAAO,CAAC,iBAAiB;IAYzB,YAAY,IAAI,IAAI;IAOd,eAAe,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAgClD,SAAS,IAAI,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAInD,UAAU,IAAI,OAAO,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;QACrB,YAAY,EAAE,MAAM,CAAA;QACpB,aAAa,EAAE,MAAM,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAC;IAiBI,YAAY,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAIhE,UAAU,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI5C,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI3C,eAAe,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAY7E,OAAO,CAAC,SAAS;IA2BjB,0DAA0D;IAC1D,aAAa,EAAE,UAAU,GAAG,IAAI,CAAO;IAEvC,OAAO,CAAC,aAAa;CAkCtB"}

package/dist/builtins/native-metrics/native-metrics.addon.d.ts

@@ -0,0 +1,74 @@
+import { ProviderRegistration, BaseAddon } from '@camstack/types';
+interface NativeMetricsConfig {
+    readonly samplingIntervalMs: number;
+}
+/**
+ * Native metrics — CPU, memory, disk usage sampling.
+ * Settings appear under Cluster → NodeDetail → Settings.
+ */
+export default class NativeMetricsAddon extends BaseAddon<NativeMetricsConfig> {
+    private provider;
+    private startedAtMs;
+    private snapshotTimer;
+    /**
+     * Snapshot-equality cache for the resources + processes emit.
+     * Stores the coarsened JSON and timestamp; a tick where the
+     * coarsened payload matches the cache (and the heartbeat hasn't
+     * elapsed) is skipped.
+     */
+    private lastResourcesEmit;
+    private lastProcessesEmit;
+    constructor();
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    protected onShutdown(): Promise<void>;
+    /**
+     * Emit one `metrics.node-resources-snapshot` + one
+     * `metrics.node-processes-snapshot` for this node. UI consumers
+     * subscribe and read state directly from the payload.
+     */
+    private emitMetricsSnapshots;
+    protected onConfigChanged(): Promise<void>;
+    private listWorkerInstances;
+    private listAddonInstances;
+    private getAddonStats;
+    /**
+     * Walk the OS process table and classify each camstack-shaped process.
+     *
+     * Classification (ancestry-driven, NOT pattern-driven):
+     *  - root    — the current node's own pid (`process.pid`).
+     *  - managed — pid is registered in the kernel's `$process.list`
+     *              (forked addon worker spawned by this hub).
+     *  - system  — ancestry walk crosses a SUPERVISOR_BOUNDARY_RE match
+     *              (tsx-watch launcher, agent CLI, concurrently, vite,
+     *              npm exec wrapper). The process belongs to the dev
+     *              tree even if not in `$process.list`. NEVER killable.
+     *  - ghost   — ancestry walk reaches `ppid=1` without crossing any
+     *              supervisor boundary AND the parent isn't visible in
+     *              `ps`. A truly orphaned camstack-shaped process. The
+     *              ONLY classification that's eligible for kill.
+     *
+     * Old pattern-only ghost detection produced false positives: every
+     * monorepo-path process matched CAMSTACK_CMD_RE, ancestry walk
+     * stopping at ppid=hub returned false-positive ghosts whenever a
+     * concurrently sibling sat above hub. Ancestry-driven classification
+     * fixes that.
+     */
+    private listNodeProcesses;
+    /**
+     * Send SIGTERM / SIGKILL to a pid. Refuses pids that don't appear in
+     * `listNodeProcesses()` to prevent arbitrary system kills — a dedicated
+     * admin-path for resurrected zombies, not a generic shell replacement.
+     *
+     * `root`-classified pids (the running launcher / agent CLI / hub itself)
+     * are also refused: killing them tears down the whole node and the
+     * operator's intent is almost always to nuke a leaked child, not the
+     * supervisor that keeps the rest alive. Process restart goes through
+     * the dedicated `$process.restart` action, not this kill API.
+     */
+    private killProcess;
+    /** Raw `ps` scan returning every pid + command + resource stats. */
+    private runPs;
+    protected globalSettingsSchema(): import('@camstack/types').ConfigUISchema;
+}
+export {};
+//# sourceMappingURL=native-metrics.addon.d.ts.map

package/dist/builtins/native-metrics/native-metrics.addon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-metrics.addon.d.ts","sourceRoot":"","sources":["../../../src/builtins/native-metrics/native-metrics.addon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,oBAAoB,EACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,SAAS,EAAyD,MAAM,iBAAiB,CAAA;AAqClG,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACpC;AA+FD;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,SAAS,CAAC,mBAAmB,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,aAAa,CAA8C;IACnE;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB,CAAqD;IAC9E,OAAO,CAAC,iBAAiB,CAAqD;;cAM9D,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;cAoC/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3C;;;;OAIG;YACW,oBAAoB;cAiDlB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;YAKlC,mBAAmB;YAYnB,kBAAkB;YA0BlB,aAAa;IAc3B;;;;;;;;;;;;;;;;;;;;;OAqBG;YACW,iBAAiB;IA0E/B;;;;;;;;;;OAUG;YACW,WAAW;IA0BzB,oEAAoE;YACtD,KAAK;IAgDnB,SAAS,CAAC,oBAAoB;CAqB/B"}