@feltdb/core 0.6.9 → 0.6.11

package/dist/workspace/runtime-observation.js

@@ -0,0 +1,170 @@
+/**
+ * FeltDB Runtime Observation Contract
+ *
+ * The single observation model shared by every runtime that reports into a
+ * FeltDB Development Workspace. The browser runtime in `@feltdb/core` produces
+ * these records, the workspace persists them durably, investigations are
+ * created from them, and verification is evaluated against them.
+ *
+ * This module is browser-safe: it must not import Node built-ins.
+ */
+/** Workspace collection holding durable runtime observations. */
+export const RUNTIME_OBSERVATION_COLLECTION = 'runtime_observation';
+/**
+ * Query parameter names whose values are replaced before an observation is
+ * persisted. Matching is case-insensitive and substring-based so that
+ * `access_token`, `apiKey`, and `X-Session` are all covered.
+ */
+export const REDACTED_PARAMETER_PATTERNS = [
+    'token', 'key', 'secret', 'password', 'passwd', 'auth', 'session',
+    'credential', 'signature', 'sig', 'code', 'assertion', 'bearer',
+];
+/** Placeholder substituted for a redacted value. */
+export const REDACTION_PLACEHOLDER = '[redacted]';
+function isRedactedParameter(name) {
+    const lowered = name.toLowerCase();
+    return REDACTED_PARAMETER_PATTERNS.some(pattern => lowered.includes(pattern));
+}
+/**
+ * Redact sensitive values from a URL while preserving the parts verification
+ * depends on: origin, pathname, and the set of query parameter names.
+ *
+ * FeltDB never captures request or response bodies, and never captures
+ * `Authorization` or `Cookie` headers, so URL redaction is the only place
+ * where credential material can reach a persisted observation.
+ */
+export function redactUrl(url) {
+    try {
+        const parsed = new URL(url, typeof location !== 'undefined' ? location.href : 'http://localhost');
+        if (parsed.username || parsed.password) {
+            parsed.username = '';
+            parsed.password = '';
+        }
+        for (const name of [...parsed.searchParams.keys()]) {
+            if (isRedactedParameter(name))
+                parsed.searchParams.set(name, REDACTION_PLACEHOLDER);
+        }
+        if (parsed.hash)
+            parsed.hash = '';
+        return parsed.toString();
+    }
+    catch {
+        // A URL we cannot parse is a URL we cannot safely redact.
+        return REDACTION_PLACEHOLDER;
+    }
+}
+/** Redact a free-text runtime message that may embed a URL or credential. */
+export function redactMessage(message) {
+    return message.replace(/https?:\/\/[^\s"'`)]+/g, match => redactUrl(match));
+}
+/** Browser family and engine derived from a user agent string. */
+export function describeBrowser(userAgent) {
+    const ua = userAgent || '';
+    // Order matters: Brave/Edge/Opera all also claim "Chrome".
+    if (/\bBrave\//i.test(ua))
+        return { browser: 'Brave', engine: 'Blink' };
+    if (/\bEdg\//.test(ua))
+        return { browser: 'Edge', engine: 'Blink' };
+    if (/\bOPR\//.test(ua))
+        return { browser: 'Opera', engine: 'Blink' };
+    if (/\bFirefox\//.test(ua))
+        return { browser: 'Firefox', engine: 'Gecko' };
+    // `HeadlessChrome/` has no word boundary before "Chrome", so match the token
+    // directly. Headless Chrome is still Chrome, and still Blink.
+    if (/(?:Headless)?Chrome\//.test(ua))
+        return { browser: 'Chrome', engine: 'Blink' };
+    // Safari identifies itself last because Chromium also carries "Safari".
+    if (/\bSafari\//.test(ua) && /\bVersion\//.test(ua))
+        return { browser: 'Safari', engine: 'WebKit' };
+    return { browser: 'Unknown', engine: 'Unknown' };
+}
+/**
+ * Whether an observation represents an actionable runtime defect.
+ *
+ * FeltDB does not open an investigation for every request. Only these
+ * qualify:
+ *   - a server-error response (HTTP >= 500)
+ *   - a request that produced no response at all (network failure)
+ *   - a client-error response correlated with a runtime or console error
+ *
+ * Successful requests, redirects, and bare 4xx responses (which are usually
+ * intentional application behavior) do not open investigations.
+ */
+export function isActionableRuntimeDefect(observation) {
+    if (observation.networkFailure)
+        return true;
+    if (observation.status >= 500)
+        return true;
+    if (observation.status >= 400) {
+        return (observation.correlatedEvents || [])
+            .some(event => event.kind === 'runtime_error' || event.kind === 'unhandled_rejection');
+    }
+    return false;
+}
+/** Human-readable reason an observation was treated as actionable. */
+export function describeDefect(observation) {
+    if (observation.networkFailure)
+        return 'the request produced no HTTP response';
+    if (observation.status >= 500)
+        return `the endpoint responded with HTTP ${observation.status}`;
+    return `the endpoint responded with HTTP ${observation.status} alongside a runtime error`;
+}
+let observationCounter = 0;
+/** Generate a workspace-unique observation identifier. */
+export function createObservationId() {
+    observationCounter += 1;
+    return `obs_${Date.now()}_${observationCounter}_${Math.random().toString(36).slice(2, 9)}`;
+}
+/** Generate a correlation identifier for a single in-flight request. */
+export function createCorrelationId() {
+    return `corr_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+const FORBIDDEN_CHARACTERISTIC = /(authorization|cookie|headers?|body|payload|data)/i;
+/** Keep diagnostic metadata factual while excluding headers and body-shaped values. */
+function redactCharacteristics(characteristics) {
+    if (!characteristics)
+        return undefined;
+    return Object.fromEntries(Object.entries(characteristics)
+        .filter(([name]) => !FORBIDDEN_CHARACTERISTIC.test(name))
+        .map(([name, value]) => [name, typeof value === 'string' ? redactMessage(value) : value]));
+}
+/**
+ * Build a redacted runtime observation.
+ *
+ * All redaction is applied here so that no caller can persist an unredacted
+ * observation by accident.
+ */
+export function createRuntimeObservation(input) {
+    const { browser, engine } = describeBrowser(input.userAgent || '');
+    return {
+        observationId: createObservationId(),
+        workspaceId: input.workspaceId,
+        sessionId: input.sessionId,
+        runtimeInstanceId: input.runtimeInstanceId,
+        correlation: input.correlation?.source ? {
+            source: {
+                product: input.correlation.source.product,
+                clientId: input.correlation.source.clientId,
+                investigationId: input.correlation.source.investigationId,
+            },
+        } : undefined,
+        method: input.method.toUpperCase(),
+        url: redactUrl(input.url),
+        status: input.status,
+        timestamp: input.completedAt,
+        durationMs: Math.max(0, input.completedAt - input.startedAt),
+        runtime: 'browser',
+        browser,
+        engine,
+        page: input.page ? redactUrl(input.page) : undefined,
+        correlationId: input.correlationId,
+        correlatedEvents: (input.correlatedEvents || []).map(event => ({
+            ...event,
+            message: redactMessage(event.message),
+            stack: event.stack ? redactMessage(event.stack) : undefined,
+        })),
+        networkFailure: input.networkFailure || undefined,
+        requestCharacteristics: redactCharacteristics(input.requestCharacteristics),
+        responseCharacteristics: redactCharacteristics(input.responseCharacteristics),
+    };
+}

package/dist/workspace/runtime-observer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * FeltDB Browser Runtime Observation
+ *
+ * The runtime that ships inside `@feltdb/core` and runs in the developer's
+ * browser. It instruments the page's HTTP and error surfaces, correlates
+ * console/runtime errors to the request that was in flight, and publishes
+ * redacted observations into the FeltDB Development Workspace, where they are
+ * persisted durably.
+ *
+ * Browser → @feltdb/core → observation → FeltDB workspace → durable persistence
+ *
+ * This module is browser-safe: it must not import Node built-ins. It uses only
+ * `fetch`, `XMLHttpRequest`, `console`, and `window` event handlers, so the
+ * same contract is produced by Chromium, Gecko, and WebKit browsers even
+ * though their internal implementations differ.
+ */
+import type { RuntimeRequestObservation } from './workspace-types.js';
+export interface RuntimeObservationOptions {
+    /** Pairing code (FELT-XXXXXX) printed by `feltdb dev`. */
+    pairingCode?: string;
+    /** Pairing discovery endpoint, when it differs from the authority. */
+    discoveryEndpoint?: string;
+    /** Authority endpoint, when the workspace is already known. */
+    endpoint?: string;
+    /** Workspace id, when the workspace is already known. */
+    workspaceId?: string;
+    /** Canonical `feltdb dev` session identity supplied by the session handshake. */
+    sessionId?: string;
+    /** Canonical runtime initialization identity supplied by the runtime bridge. */
+    runtimeInstanceId?: string;
+    /**
+     * How long a failing request is held so that console and runtime errors
+     * emitted immediately afterwards can be correlated to it.
+     */
+    correlationWindowMs?: number;
+    /** Expose the handle as `globalThis.__feltdbRuntime`. Defaults to true. */
+    exposeGlobal?: boolean;
+}
+export interface RuntimeObservationHandle {
+    workspaceId: string;
+    sessionId?: string;
+    runtimeInstanceId?: string;
+    /** Observations produced by this page, in order. */
+    observations(): RuntimeRequestObservation[];
+    /** Resolve once every pending observation has been persisted. */
+    flush(): Promise<void>;
+    /** Restore the original browser APIs and disconnect from the workspace. */
+    stop(): Promise<void>;
+}
+/**
+ * Start observing the current page and reporting into the workspace.
+ *
+ * Returns once the workspace connection is established, so a caller can await
+ * it before exercising the application.
+ */
+export declare function startRuntimeObservation(options: RuntimeObservationOptions): Promise<RuntimeObservationHandle>;
+//# sourceMappingURL=runtime-observer.d.ts.map

package/dist/workspace/runtime-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-observer.d.ts","sourceRoot":"","sources":["../../src/workspace/runtime-observer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAA0B,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAS9F,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,YAAY,IAAI,yBAAyB,EAAE,CAAC;IAC5C,iEAAiE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,2EAA2E;IAC3E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAID;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA8PnC"}

package/dist/workspace/runtime-observer.js

@@ -0,0 +1,272 @@
+/**
+ * FeltDB Browser Runtime Observation
+ *
+ * The runtime that ships inside `@feltdb/core` and runs in the developer's
+ * browser. It instruments the page's HTTP and error surfaces, correlates
+ * console/runtime errors to the request that was in flight, and publishes
+ * redacted observations into the FeltDB Development Workspace, where they are
+ * persisted durably.
+ *
+ * Browser → @feltdb/core → observation → FeltDB workspace → durable persistence
+ *
+ * This module is browser-safe: it must not import Node built-ins. It uses only
+ * `fetch`, `XMLHttpRequest`, `console`, and `window` event handlers, so the
+ * same contract is produced by Chromium, Gecko, and WebKit browsers even
+ * though their internal implementations differ.
+ */
+import { RUNTIME_OBSERVATION_COLLECTION, createCorrelationId, createRuntimeObservation, redactMessage, } from './runtime-observation.js';
+import { connectDevelopmentWorkspace } from './workspace-connection.js';
+const RUNTIME_EVENT_BUFFER = 50;
+/**
+ * Start observing the current page and reporting into the workspace.
+ *
+ * Returns once the workspace connection is established, so a caller can await
+ * it before exercising the application.
+ */
+export async function startRuntimeObservation(options) {
+    const scope = globalThis;
+    const correlationWindowMs = options.correlationWindowMs ?? 250;
+    const connection = await connectDevelopmentWorkspace({
+        pairingCode: options.pairingCode,
+        workspaceId: options.workspaceId,
+        endpoint: options.endpoint,
+        discoveryEndpoint: options.discoveryEndpoint,
+        clientType: 'browser',
+    });
+    // Requests FeltDB itself makes must never be observed, or reporting an
+    // observation would produce another observation.
+    const selfOrigins = [options.endpoint, options.discoveryEndpoint]
+        .filter((value) => Boolean(value))
+        .map(value => value.replace(/\/$/, ''));
+    const isSelfRequest = (url) => {
+        try {
+            const absolute = new URL(url, scope.location ? scope.location.href : 'http://localhost').toString();
+            return selfOrigins.some(origin => absolute.startsWith(origin));
+        }
+        catch {
+            return false;
+        }
+    };
+    const emitted = [];
+    const pending = new Set();
+    const recentEvents = [];
+    const recordEvent = (event) => {
+        recentEvents.push(event);
+        if (recentEvents.length > RUNTIME_EVENT_BUFFER)
+            recentEvents.shift();
+    };
+    const eventsNear = (startedAt, until) => recentEvents.filter(event => event.timestamp >= startedAt && event.timestamp <= until);
+    const publish = (observation) => {
+        const record = { ...observation, workspaceId: connection.workspaceId };
+        emitted.push(record);
+        // The observation id is the entity id so the record is idempotent and
+        // directly addressable after a restart.
+        const task = connection
+            .publish(RUNTIME_OBSERVATION_COLLECTION, record)
+            .catch(() => undefined)
+            .finally(() => pending.delete(task));
+        pending.add(task);
+    };
+    const report = (input) => {
+        const completedAt = Date.now();
+        const build = (correlatedEvents) => createRuntimeObservation({
+            method: input.method,
+            url: input.url,
+            status: input.status,
+            startedAt: input.startedAt,
+            completedAt,
+            workspaceId: connection.workspaceId,
+            sessionId: options.sessionId,
+            runtimeInstanceId: options.runtimeInstanceId,
+            page: scope.location ? String(scope.location.href) : undefined,
+            userAgent: scope.navigator ? String(scope.navigator.userAgent) : undefined,
+            correlationId: input.correlationId,
+            correlatedEvents,
+            networkFailure: input.networkFailure,
+            responseCharacteristics: input.responseCharacteristics,
+        });
+        const failed = input.networkFailure || input.status >= 400;
+        if (!failed) {
+            publish(build(eventsNear(input.startedAt, completedAt)));
+            return;
+        }
+        // Hold a failing request briefly so the console error it triggers lands in
+        // the same durable observation instead of a separate, uncorrelated record.
+        const held = new Promise(resolve => {
+            const finish = () => {
+                publish(build(eventsNear(input.startedAt, Date.now())));
+                resolve();
+            };
+            if (typeof scope.setTimeout === 'function')
+                scope.setTimeout(finish, correlationWindowMs);
+            else
+                finish();
+        }).finally(() => pending.delete(held));
+        pending.add(held);
+    };
+    // --- console instrumentation -------------------------------------------
+    const originalConsoleError = console.error?.bind(console);
+    const originalConsoleWarn = console.warn?.bind(console);
+    const describeArguments = (args) => args
+        .map(value => {
+        if (value instanceof Error)
+            return `${value.name}: ${value.message}`;
+        if (typeof value === 'string')
+            return value;
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return String(value);
+        }
+    })
+        .join(' ');
+    if (originalConsoleError) {
+        console.error = (...args) => {
+            recordEvent({
+                kind: 'console_error',
+                message: redactMessage(describeArguments(args)),
+                timestamp: Date.now(),
+                stack: args.find(value => value instanceof Error) instanceof Error
+                    ? redactMessage(String(args.find(value => value instanceof Error).stack || ''))
+                    : undefined,
+            });
+            originalConsoleError(...args);
+        };
+    }
+    if (originalConsoleWarn) {
+        console.warn = (...args) => {
+            recordEvent({ kind: 'console_warn', message: redactMessage(describeArguments(args)), timestamp: Date.now() });
+            originalConsoleWarn(...args);
+        };
+    }
+    // --- uncaught error instrumentation ------------------------------------
+    const onError = (event) => {
+        recordEvent({
+            kind: 'runtime_error',
+            message: redactMessage(String(event?.message || event?.error?.message || 'Uncaught error')),
+            timestamp: Date.now(),
+            stack: event?.error?.stack ? redactMessage(String(event.error.stack)) : undefined,
+            source: event?.filename ? { file: String(event.filename), line: event.lineno, column: event.colno } : undefined,
+        });
+    };
+    const onRejection = (event) => {
+        const reason = event?.reason;
+        recordEvent({
+            kind: 'unhandled_rejection',
+            message: redactMessage(reason instanceof Error ? `${reason.name}: ${reason.message}` : String(reason)),
+            timestamp: Date.now(),
+            stack: reason instanceof Error && reason.stack ? redactMessage(String(reason.stack)) : undefined,
+        });
+    };
+    scope.addEventListener?.('error', onError);
+    scope.addEventListener?.('unhandledrejection', onRejection);
+    // --- fetch instrumentation ---------------------------------------------
+    const originalFetch = scope.fetch?.bind(scope);
+    if (originalFetch) {
+        scope.fetch = async (input, init) => {
+            const url = typeof input === 'string' ? input : input?.url ? String(input.url) : String(input);
+            const method = String(init?.method || (typeof input === 'object' && input?.method) || 'GET');
+            if (isSelfRequest(url))
+                return originalFetch(input, init);
+            const startedAt = Date.now();
+            const correlationId = createCorrelationId();
+            try {
+                const response = await originalFetch(input, init);
+                report({
+                    method,
+                    url,
+                    status: response.status,
+                    startedAt,
+                    correlationId,
+                    responseCharacteristics: {
+                        ok: response.ok,
+                        statusText: response.statusText,
+                        contentType: response.headers?.get?.('content-type') || undefined,
+                    },
+                });
+                return response;
+            }
+            catch (error) {
+                report({
+                    method,
+                    url,
+                    status: 0,
+                    startedAt,
+                    correlationId,
+                    networkFailure: true,
+                    responseCharacteristics: { error: redactMessage(String(error)) },
+                });
+                throw error;
+            }
+        };
+    }
+    // --- XMLHttpRequest instrumentation ------------------------------------
+    const OriginalXhr = scope.XMLHttpRequest;
+    if (OriginalXhr) {
+        const originalOpen = OriginalXhr.prototype.open;
+        const originalSend = OriginalXhr.prototype.send;
+        OriginalXhr.prototype.open = function (method, url, ...rest) {
+            this.__feltdb = { method, url };
+            return originalOpen.call(this, method, url, ...rest);
+        };
+        OriginalXhr.prototype.send = function (...args) {
+            const context = this.__feltdb;
+            if (context && !isSelfRequest(context.url)) {
+                const startedAt = Date.now();
+                const correlationId = createCorrelationId();
+                let settled = false;
+                this.addEventListener('loadend', () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    const networkFailure = this.status === 0;
+                    report({
+                        method: context.method,
+                        url: context.url,
+                        status: this.status,
+                        startedAt,
+                        correlationId,
+                        networkFailure,
+                        responseCharacteristics: { statusText: this.statusText || undefined },
+                    });
+                });
+            }
+            return originalSend.apply(this, args);
+        };
+        OriginalXhr.__feltdbOriginalOpen = originalOpen;
+        OriginalXhr.__feltdbOriginalSend = originalSend;
+    }
+    const flush = async () => {
+        // Held observations register new promises as they settle, so drain until
+        // the set is genuinely empty rather than snapshotting once.
+        while (pending.size > 0)
+            await Promise.all([...pending]);
+    };
+    const handle = {
+        workspaceId: connection.workspaceId,
+        sessionId: options.sessionId,
+        runtimeInstanceId: options.runtimeInstanceId,
+        observations: () => [...emitted],
+        flush,
+        stop: async () => {
+            if (originalFetch)
+                scope.fetch = originalFetch;
+            if (originalConsoleError)
+                console.error = originalConsoleError;
+            if (originalConsoleWarn)
+                console.warn = originalConsoleWarn;
+            if (OriginalXhr) {
+                OriginalXhr.prototype.open = OriginalXhr.__feltdbOriginalOpen;
+                OriginalXhr.prototype.send = OriginalXhr.__feltdbOriginalSend;
+            }
+            scope.removeEventListener?.('error', onError);
+            scope.removeEventListener?.('unhandledrejection', onRejection);
+            await flush();
+            await connection.disconnect();
+        },
+    };
+    if (options.exposeGlobal !== false)
+        scope.__feltdbRuntime = handle;
+    return handle;
+}

package/dist/workspace/workspace-connection.d.ts.map

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

package/dist/workspace/workspace-connection.js

@@ -196,12 +196,21 @@ export class DevelopmentWorkspaceConnection {
     async disconnect() {
         this.unsubscribeEvents?.();
         this.unsubscribeEvents = null;
-        if (this.transport) {
-            await this.transport.unregisterClient(this.workspaceId, this.clientId);
+        try {
+            if (this.transport) {
+                await this.transport.unregisterClient(this.workspaceId, this.clientId);
+            }
+        }
+        catch {
+            // Disconnecting after the workspace authority has already stopped is
+            // normal, not an error: the client registration is gone with it. The
+            // local connection must still be torn down.
+        }
+        finally {
+            this.subscriptions.clear();
+            this.transport = null;
+            this.connectedAt = 0;
         }
-        this.subscriptions.clear();
-        this.transport = null;
-        this.connectedAt = 0;
     }
     /**
      * Get capabilities for this client type

package/dist/workspace/workspace-identity.d.ts

@@ -4,7 +4,7 @@
  * Manages durable workspace identities and discovery.
  */
 import type { DevelopmentWorkspace, WorkspaceDiscovery } from './workspace-types.js';
-export declare function createWorkspaceId(projectId: string): string;
+export declare function createWorkspaceId(_projectId: string): string;
 export declare function isValidWorkspaceId(id: string): boolean;
 export declare function createDevelopmentWorkspace(projectId: string, name: string): DevelopmentWorkspace;
 export declare function updateWorkspaceTimestamp(workspace: DevelopmentWorkspace): DevelopmentWorkspace;

package/dist/workspace/workspace-identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-identity.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace-identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAIrF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,oBAAoB,CAStB;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,oBAAoB,GAC9B,oBAAoB,CAKtB;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA0BpC;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,kBAAkB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAiBf"}
+{"version":3,"file":"workspace-identity.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace-identity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAIrF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,oBAAoB,CAStB;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,oBAAoB,GAC9B,oBAAoB,CAKtB;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA0BpC;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,kBAAkB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/workspace/workspace-identity.js

@@ -4,10 +4,10 @@
  * Manages durable workspace identities and discovery.
  */
 const WORKSPACE_ID_PREFIX = 'ws_';
-export function createWorkspaceId(projectId) {
-    const timestamp = Date.now();
-    const random = Math.random().toString(36).substring(2, 8);
-    return `${WORKSPACE_ID_PREFIX}${projectId}_${timestamp}_${random}`;
+export function createWorkspaceId(_projectId) {
+    const random = globalThis.crypto?.randomUUID?.().replace(/-/g, '')
+        ?? `${Date.now().toString(36)}${Math.random().toString(36).slice(2)}${Math.random().toString(36).slice(2)}`;
+    return `${WORKSPACE_ID_PREFIX}${random}`;
 }
 export function isValidWorkspaceId(id) {
     return id.startsWith(WORKSPACE_ID_PREFIX);