@framers/agentos 0.1.0

package/dist/types/rateLimitTypes.js

@@ -0,0 +1,55 @@
+/**
+ * @file Rate Limit Type Definitions
+ * @description Type definitions for rate limit information.
+ * Ensures consistent structure for public/private rate limit views.
+ */
+/**
+ * Type guard to check if rate limit info is for public tier.
+ */
+export function isPublicRateLimit(info) {
+    return info.tier === 'public';
+}
+/**
+ * Type guard to check if rate limit info is for authenticated tier.
+ */
+export function isAuthenticatedRateLimit(info) {
+    return info.tier === 'authenticated';
+}
+/**
+ * Default banner thresholds for rate limit warnings.
+ */
+export const DEFAULT_RATE_LIMIT_BANNER_THRESHOLDS = {
+    warningThreshold: 25,
+    criticalThreshold: 10,
+};
+/**
+ * Calculate remaining percentage from rate limit info.
+ * @param info Rate limit information (must be public tier)
+ * @returns Percentage of remaining requests (0-100), or null if not applicable
+ */
+export function calculateRemainingPercentage(info) {
+    if (!isPublicRateLimit(info) || info.limit === 0)
+        return null;
+    return (info.remaining / info.limit) * 100;
+}
+/**
+ * Determine banner severity based on remaining percentage and thresholds.
+ * @param info Rate limit information
+ * @param thresholds Banner threshold configuration (optional, uses defaults)
+ * @returns 'none' | 'warning' | 'critical'
+ */
+export function getRateLimitBannerSeverity(info, thresholds = DEFAULT_RATE_LIMIT_BANNER_THRESHOLDS) {
+    if (!isPublicRateLimit(info))
+        return 'none';
+    const remainingPct = calculateRemainingPercentage(info);
+    if (remainingPct === null)
+        return 'none';
+    if (remainingPct === 0 || info.remaining === 0)
+        return 'critical';
+    if (remainingPct <= thresholds.criticalThreshold)
+        return 'critical';
+    if (remainingPct <= thresholds.warningThreshold)
+        return 'warning';
+    return 'none';
+}
+//# sourceMappingURL=rateLimitTypes.js.map

package/dist/types/rateLimitTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimitTypes.js","sourceRoot":"","sources":["../../src/types/rateLimitTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6BH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAmB;IACnD,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAmB;IAC1D,OAAO,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;AACvC,CAAC;AAmBD;;GAEG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAA8B;IAC7E,gBAAgB,EAAE,EAAE;IACpB,iBAAiB,EAAE,EAAE;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAmB;IAC9D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAmB,EACnB,aAAwC,oCAAoC;IAE5E,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAE5C,MAAM,YAAY,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAEzC,IAAI,YAAY,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAClE,IAAI,YAAY,IAAI,UAAU,CAAC,iBAAiB;QAAE,OAAO,UAAU,CAAC;IACpE,IAAI,YAAY,IAAI,UAAU,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAElE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,80 @@
+export declare class AppError extends Error {
+    message: string;
+    statusCode: number;
+    isOperational: boolean;
+    constructor(message: string, statusCode?: number, isOperational?: boolean);
+}
+export declare class ValidationError extends AppError {
+    constructor(message: string);
+}
+export declare class AuthenticationError extends AppError {
+    constructor(message?: string);
+}
+export declare class NotFoundError extends AppError {
+    constructor(message?: string);
+}
+export declare enum GMIErrorCode {
+    INTERNAL_SERVER_ERROR = "SYS_INTERNAL_SERVER_ERROR",
+    INTERNAL_ERROR = "SYS_INTERNAL_ERROR",
+    SERVICE_UNAVAILABLE = "SYS_SERVICE_UNAVAILABLE",
+    NOT_INITIALIZED = "SYS_NOT_INITIALIZED",
+    INITIALIZATION_FAILED = "SYS_INITIALIZATION_FAILED",
+    CONFIGURATION_ERROR = "SYS_CONFIGURATION_ERROR",
+    CONFIG_ERROR = "SYS_CONFIG_ERROR",
+    VALIDATION_ERROR = "SYS_VALIDATION_ERROR",
+    INVALID_ARGUMENT = "SYS_INVALID_ARGUMENT",
+    INVALID_STATE = "SYS_INVALID_STATE",
+    PARSING_ERROR = "SYS_PARSING_ERROR",
+    DEPENDENCY_ERROR = "SYS_DEPENDENCY_ERROR",
+    MISSING_DEPENDENCY = "SYS_MISSING_DEPENDENCY",
+    MISSING_DATA = "SYS_MISSING_DATA",
+    NOT_IMPLEMENTED = "SYS_NOT_IMPLEMENTED",
+    NOT_SUPPORTED = "SYS_NOT_SUPPORTED",
+    METHOD_NOT_SUPPORTED = "SYS_METHOD_NOT_SUPPORTED",
+    PROCESSING_ERROR = "SYS_PROCESSING_ERROR",
+    STREAM_ERROR = "SYS_STREAM_ERROR",
+    DATABASE_ERROR = "SYS_DATABASE_ERROR",
+    RATE_LIMIT_EXCEEDED = "SYS_RATE_LIMIT_EXCEEDED",
+    TIMEOUT = "SYS_TIMEOUT",
+    NOT_FOUND = "SYS_NOT_FOUND",
+    RESOURCE_NOT_FOUND = "SYS_RESOURCE_NOT_FOUND",
+    RESOURCE_ALREADY_EXISTS = "SYS_RESOURCE_ALREADY_EXISTS",
+    ALREADY_EXISTS = "SYS_ALREADY_EXISTS",
+    AUTHENTICATION_REQUIRED = "AUTH_AUTHENTICATION_REQUIRED",
+    PERMISSION_DENIED = "AUTH_PERMISSION_DENIED",
+    ACCESS_DENIED = "AUTH_ACCESS_DENIED",
+    SUBSCRIPTION_ERROR = "AUTH_SUBSCRIPTION_ERROR",
+    PERSONA_NOT_FOUND = "GMI_PERSONA_NOT_FOUND",
+    PERSONA_LOAD_ERROR = "GMI_PERSONA_LOAD_ERROR",
+    GMI_INITIALIZATION_ERROR = "GMI_INITIALIZATION_ERROR",
+    GMI_PROCESSING_ERROR = "GMI_PROCESSING_ERROR",
+    GMI_CONTEXT_ERROR = "GMI_CONTEXT_ERROR",
+    GMI_FEEDBACK_ERROR = "GMI_FEEDBACK_ERROR",
+    GMI_SHUTDOWN_ERROR = "GMI_SHUTDOWN_ERROR",
+    TOOL_ERROR = "TOOL_ERROR",
+    TOOL_NOT_FOUND = "TOOL_NOT_FOUND",
+    TOOL_EXECUTION_FAILED = "TOOL_EXECUTION_FAILED",
+    LLM_PROVIDER_ERROR = "LLM_PROVIDER_ERROR",
+    LLM_PROVIDER_UNAVAILABLE = "LLM_PROVIDER_UNAVAILABLE",
+    PROVIDER_ERROR = "PROVIDER_ERROR",
+    PROVIDER_NOT_FOUND = "PROVIDER_NOT_FOUND",
+    RAG_INGESTION_FAILED = "RAG_INGESTION_FAILED"
+}
+export type GMIErrorDetails = Record<string, any> | undefined;
+export declare class GMIError extends Error {
+    readonly code: GMIErrorCode | string;
+    readonly details?: any;
+    readonly component?: string;
+    readonly timestamp: string;
+    readonly httpStatusCode?: number;
+    readonly cause?: unknown;
+    constructor(message: string, code: GMIErrorCode | string, details?: any, component?: string, httpStatusCode?: number, cause?: unknown);
+    getHttpStatusCode(): number;
+    getUserFriendlyMessage(): string;
+    toPlainObject(): Record<string, any>;
+    toJSON(): Record<string, any>;
+    static isGMIError(error: unknown): error is GMIError;
+    static wrap(error: unknown, code: GMIErrorCode | string, message?: string, componentOrigin?: string): GMIError;
+}
+export declare function createGMIErrorFromError(error: unknown, code: GMIErrorCode | string, contextDetails?: any, overrideMessage?: string, componentOrigin?: string): GMIError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

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

package/dist/utils/errors.js

@@ -0,0 +1,201 @@
+// Shared error helpers used across AgentOS and embedding applications.
+export class AppError extends Error {
+    constructor(message, statusCode = 500, isOperational = true) {
+        super(message);
+        this.message = message;
+        this.statusCode = statusCode;
+        this.isOperational = isOperational;
+        Object.setPrototypeOf(this, AppError.prototype);
+    }
+}
+export class ValidationError extends AppError {
+    constructor(message) {
+        super(message, 400, true);
+    }
+}
+export class AuthenticationError extends AppError {
+    constructor(message = 'Authentication failed') {
+        super(message, 401, true);
+    }
+}
+export class NotFoundError extends AppError {
+    constructor(message = 'Resource not found') {
+        super(message, 404, true);
+    }
+}
+export var GMIErrorCode;
+(function (GMIErrorCode) {
+    GMIErrorCode["INTERNAL_SERVER_ERROR"] = "SYS_INTERNAL_SERVER_ERROR";
+    GMIErrorCode["INTERNAL_ERROR"] = "SYS_INTERNAL_ERROR";
+    GMIErrorCode["SERVICE_UNAVAILABLE"] = "SYS_SERVICE_UNAVAILABLE";
+    GMIErrorCode["NOT_INITIALIZED"] = "SYS_NOT_INITIALIZED";
+    GMIErrorCode["INITIALIZATION_FAILED"] = "SYS_INITIALIZATION_FAILED";
+    GMIErrorCode["CONFIGURATION_ERROR"] = "SYS_CONFIGURATION_ERROR";
+    GMIErrorCode["CONFIG_ERROR"] = "SYS_CONFIG_ERROR";
+    GMIErrorCode["VALIDATION_ERROR"] = "SYS_VALIDATION_ERROR";
+    GMIErrorCode["INVALID_ARGUMENT"] = "SYS_INVALID_ARGUMENT";
+    GMIErrorCode["INVALID_STATE"] = "SYS_INVALID_STATE";
+    GMIErrorCode["PARSING_ERROR"] = "SYS_PARSING_ERROR";
+    GMIErrorCode["DEPENDENCY_ERROR"] = "SYS_DEPENDENCY_ERROR";
+    GMIErrorCode["MISSING_DEPENDENCY"] = "SYS_MISSING_DEPENDENCY";
+    GMIErrorCode["MISSING_DATA"] = "SYS_MISSING_DATA";
+    GMIErrorCode["NOT_IMPLEMENTED"] = "SYS_NOT_IMPLEMENTED";
+    GMIErrorCode["NOT_SUPPORTED"] = "SYS_NOT_SUPPORTED";
+    GMIErrorCode["METHOD_NOT_SUPPORTED"] = "SYS_METHOD_NOT_SUPPORTED";
+    GMIErrorCode["PROCESSING_ERROR"] = "SYS_PROCESSING_ERROR";
+    GMIErrorCode["STREAM_ERROR"] = "SYS_STREAM_ERROR";
+    GMIErrorCode["DATABASE_ERROR"] = "SYS_DATABASE_ERROR";
+    GMIErrorCode["RATE_LIMIT_EXCEEDED"] = "SYS_RATE_LIMIT_EXCEEDED";
+    GMIErrorCode["TIMEOUT"] = "SYS_TIMEOUT";
+    GMIErrorCode["NOT_FOUND"] = "SYS_NOT_FOUND";
+    GMIErrorCode["RESOURCE_NOT_FOUND"] = "SYS_RESOURCE_NOT_FOUND";
+    GMIErrorCode["RESOURCE_ALREADY_EXISTS"] = "SYS_RESOURCE_ALREADY_EXISTS";
+    GMIErrorCode["ALREADY_EXISTS"] = "SYS_ALREADY_EXISTS";
+    GMIErrorCode["AUTHENTICATION_REQUIRED"] = "AUTH_AUTHENTICATION_REQUIRED";
+    GMIErrorCode["PERMISSION_DENIED"] = "AUTH_PERMISSION_DENIED";
+    GMIErrorCode["ACCESS_DENIED"] = "AUTH_ACCESS_DENIED";
+    GMIErrorCode["SUBSCRIPTION_ERROR"] = "AUTH_SUBSCRIPTION_ERROR";
+    GMIErrorCode["PERSONA_NOT_FOUND"] = "GMI_PERSONA_NOT_FOUND";
+    GMIErrorCode["PERSONA_LOAD_ERROR"] = "GMI_PERSONA_LOAD_ERROR";
+    GMIErrorCode["GMI_INITIALIZATION_ERROR"] = "GMI_INITIALIZATION_ERROR";
+    GMIErrorCode["GMI_PROCESSING_ERROR"] = "GMI_PROCESSING_ERROR";
+    GMIErrorCode["GMI_CONTEXT_ERROR"] = "GMI_CONTEXT_ERROR";
+    GMIErrorCode["GMI_FEEDBACK_ERROR"] = "GMI_FEEDBACK_ERROR";
+    GMIErrorCode["GMI_SHUTDOWN_ERROR"] = "GMI_SHUTDOWN_ERROR";
+    GMIErrorCode["TOOL_ERROR"] = "TOOL_ERROR";
+    GMIErrorCode["TOOL_NOT_FOUND"] = "TOOL_NOT_FOUND";
+    GMIErrorCode["TOOL_EXECUTION_FAILED"] = "TOOL_EXECUTION_FAILED";
+    GMIErrorCode["LLM_PROVIDER_ERROR"] = "LLM_PROVIDER_ERROR";
+    GMIErrorCode["LLM_PROVIDER_UNAVAILABLE"] = "LLM_PROVIDER_UNAVAILABLE";
+    GMIErrorCode["PROVIDER_ERROR"] = "PROVIDER_ERROR";
+    GMIErrorCode["PROVIDER_NOT_FOUND"] = "PROVIDER_NOT_FOUND";
+    GMIErrorCode["RAG_INGESTION_FAILED"] = "RAG_INGESTION_FAILED";
+})(GMIErrorCode || (GMIErrorCode = {}));
+const DEFAULT_HTTP_STATUS = 500;
+const DEFAULT_FRIENDLY_MESSAGE = 'An unexpected error occurred.';
+const statusCodeMap = {
+    [GMIErrorCode.INTERNAL_SERVER_ERROR]: 500,
+    [GMIErrorCode.INTERNAL_ERROR]: 500,
+    [GMIErrorCode.SERVICE_UNAVAILABLE]: 503,
+    [GMIErrorCode.NOT_INITIALIZED]: 500,
+    [GMIErrorCode.INITIALIZATION_FAILED]: 500,
+    [GMIErrorCode.CONFIGURATION_ERROR]: 500,
+    [GMIErrorCode.CONFIG_ERROR]: 500,
+    [GMIErrorCode.VALIDATION_ERROR]: 400,
+    [GMIErrorCode.INVALID_ARGUMENT]: 400,
+    [GMIErrorCode.INVALID_STATE]: 409,
+    [GMIErrorCode.PARSING_ERROR]: 400,
+    [GMIErrorCode.DEPENDENCY_ERROR]: 500,
+    [GMIErrorCode.MISSING_DEPENDENCY]: 500,
+    [GMIErrorCode.MISSING_DATA]: 400,
+    [GMIErrorCode.NOT_IMPLEMENTED]: 501,
+    [GMIErrorCode.NOT_SUPPORTED]: 501,
+    [GMIErrorCode.METHOD_NOT_SUPPORTED]: 405,
+    [GMIErrorCode.PROCESSING_ERROR]: 500,
+    [GMIErrorCode.GMI_PROCESSING_ERROR]: 500,
+    [GMIErrorCode.STREAM_ERROR]: 500,
+    [GMIErrorCode.DATABASE_ERROR]: 500,
+    [GMIErrorCode.RATE_LIMIT_EXCEEDED]: 429,
+    [GMIErrorCode.TIMEOUT]: 504,
+    [GMIErrorCode.NOT_FOUND]: 404,
+    [GMIErrorCode.RESOURCE_NOT_FOUND]: 404,
+    [GMIErrorCode.PERSONA_NOT_FOUND]: 404,
+    [GMIErrorCode.TOOL_NOT_FOUND]: 404,
+    [GMIErrorCode.PROVIDER_NOT_FOUND]: 404,
+    [GMIErrorCode.RESOURCE_ALREADY_EXISTS]: 409,
+    [GMIErrorCode.ALREADY_EXISTS]: 409,
+    [GMIErrorCode.AUTHENTICATION_REQUIRED]: 401,
+    [GMIErrorCode.PERMISSION_DENIED]: 403,
+    [GMIErrorCode.ACCESS_DENIED]: 403,
+    [GMIErrorCode.SUBSCRIPTION_ERROR]: 402,
+    [GMIErrorCode.LLM_PROVIDER_UNAVAILABLE]: 503,
+};
+const userFriendlyMessageMap = {
+    [GMIErrorCode.INTERNAL_SERVER_ERROR]: DEFAULT_FRIENDLY_MESSAGE,
+    [GMIErrorCode.SERVICE_UNAVAILABLE]: 'The service is temporarily unavailable. Please try again shortly.',
+    [GMIErrorCode.AUTHENTICATION_REQUIRED]: 'Please log in to continue.',
+    [GMIErrorCode.PERMISSION_DENIED]: "You do not have permission to perform that action.",
+    [GMIErrorCode.ACCESS_DENIED]: "You don't have access to this resource.",
+    [GMIErrorCode.NOT_FOUND]: 'We could not find what you were looking for.',
+    [GMIErrorCode.RESOURCE_NOT_FOUND]: 'We could not find what you were looking for.',
+    [GMIErrorCode.PERSONA_NOT_FOUND]: 'That persona is not available.',
+    [GMIErrorCode.SUBSCRIPTION_ERROR]: 'Please upgrade your plan to access this feature.',
+    [GMIErrorCode.RATE_LIMIT_EXCEEDED]: 'You are sending requests too quickly. Please slow down.',
+};
+export class GMIError extends Error {
+    constructor(message, code, details, component, httpStatusCode, cause) {
+        super(message);
+        this.name = 'GMIError';
+        this.code = code;
+        this.details = details;
+        this.component = component;
+        this.httpStatusCode = httpStatusCode;
+        this.cause = cause;
+        this.timestamp = new Date().toISOString();
+        Object.setPrototypeOf(this, GMIError.prototype);
+    }
+    getHttpStatusCode() {
+        if (typeof this.httpStatusCode === 'number') {
+            return this.httpStatusCode;
+        }
+        const mapped = statusCodeMap[this.code];
+        return mapped ?? DEFAULT_HTTP_STATUS;
+    }
+    getUserFriendlyMessage() {
+        return userFriendlyMessageMap[this.code] ?? this.message ?? DEFAULT_FRIENDLY_MESSAGE;
+    }
+    toPlainObject() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            component: this.component,
+            httpStatusCode: this.getHttpStatusCode(),
+            details: this.details,
+            timestamp: this.timestamp,
+            stack: this.stack,
+        };
+    }
+    toJSON() {
+        return this.toPlainObject();
+    }
+    static isGMIError(error) {
+        return error instanceof GMIError;
+    }
+    static wrap(error, code, message, componentOrigin) {
+        return createGMIErrorFromError(error, code, undefined, message, componentOrigin);
+    }
+}
+export function createGMIErrorFromError(error, code, contextDetails, overrideMessage, componentOrigin) {
+    if (error instanceof GMIError) {
+        return new GMIError(overrideMessage ? `${overrideMessage}: ${error.message}` : error.message, code ?? error.code, mergeDetails(error.details, contextDetails), componentOrigin ?? error.component, error.httpStatusCode, error);
+    }
+    const baseMessage = error instanceof Error ? error.message : String(error);
+    const mergedDetails = mergeDetails(normalizeUnknownError(error), contextDetails);
+    return new GMIError(overrideMessage ? `${overrideMessage}: ${baseMessage}` : baseMessage, code, mergedDetails, componentOrigin, undefined, error);
+}
+function mergeDetails(...details) {
+    const merged = {};
+    for (const detail of details) {
+        if (detail && typeof detail === 'object') {
+            Object.assign(merged, detail);
+        }
+    }
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+function normalizeUnknownError(error) {
+    if (error instanceof Error) {
+        return {
+            underlyingError: {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            },
+        };
+    }
+    if (error && typeof error === 'object') {
+        return { underlyingError: error };
+    }
+    return error === undefined ? undefined : { underlyingError: { value: error } };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/uuid.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate a RFC4122 version 4 UUID using the best source of randomness
+ * available in the current runtime (Node, browser, workers, etc.).
+ */
+export declare function generateUUID(): string;
+/**
+ * Backwards compatible aliases.
+ */
+export declare const uuidv4: typeof generateUUID;
+export declare const generateUniqueId: typeof generateUUID;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/utils/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/utils/uuid.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CA6DrC;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,qBAAe,CAAC;AACnC,eAAO,MAAM,gBAAgB,qBAAe,CAAC"}

package/dist/utils/uuid.js

@@ -0,0 +1,64 @@
+const UUID_TEMPLATE = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx';
+/**
+ * Generate a RFC4122 version 4 UUID using the best source of randomness
+ * available in the current runtime (Node, browser, workers, etc.).
+ */
+export function generateUUID() {
+    const globalCrypto = typeof globalThis !== 'undefined' ? globalThis.crypto : undefined;
+    if (globalCrypto?.randomUUID) {
+        return globalCrypto.randomUUID();
+    }
+    if (globalCrypto?.getRandomValues) {
+        const buffer = new Uint8Array(16);
+        globalCrypto.getRandomValues(buffer);
+        buffer[6] = (buffer[6] & 0x0f) | 0x40; // version 4
+        buffer[8] = (buffer[8] & 0x3f) | 0x80; // variant RFC4122
+        const byteToHex = [];
+        for (let i = 0; i < 256; ++i) {
+            byteToHex.push((i + 0x100).toString(16).substring(1));
+        }
+        return (byteToHex[buffer[0]] +
+            byteToHex[buffer[1]] +
+            byteToHex[buffer[2]] +
+            byteToHex[buffer[3]] +
+            '-' +
+            byteToHex[buffer[4]] +
+            byteToHex[buffer[5]] +
+            '-' +
+            byteToHex[buffer[6]] +
+            byteToHex[buffer[7]] +
+            '-' +
+            byteToHex[buffer[8]] +
+            byteToHex[buffer[9]] +
+            '-' +
+            byteToHex[buffer[10]] +
+            byteToHex[buffer[11]] +
+            byteToHex[buffer[12]] +
+            byteToHex[buffer[13]] +
+            byteToHex[buffer[14]] +
+            byteToHex[buffer[15]]);
+    }
+    let timestamp = Date.now();
+    let microTime = (typeof performance !== 'undefined' && performance.now && performance.now() * 1000) || 0;
+    return UUID_TEMPLATE.replace(/[xy]/g, (char) => {
+        let random = Math.random() * 16;
+        if (timestamp > 0) {
+            random = (timestamp + random) % 16 | 0;
+            timestamp = Math.floor(timestamp / 16);
+        }
+        else {
+            random = (microTime + random) % 16 | 0;
+            microTime = Math.floor(microTime / 16);
+        }
+        if (char === 'x') {
+            return random.toString(16);
+        }
+        return ((random & 0x3) | 0x8).toString(16);
+    });
+}
+/**
+ * Backwards compatible aliases.
+ */
+export const uuidv4 = generateUUID;
+export const generateUniqueId = generateUUID;
+//# sourceMappingURL=uuid.js.map

package/dist/utils/uuid.js.map

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

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@framers/agentos",
+  "version": "0.1.0",
+  "description": "Modular AgentOS orchestration library",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json",
+    "./*": "./dist/*.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rimraf dist tsconfig.build.tsbuildinfo",
+    "build": "npm run clean && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node scripts/fix-esm-imports.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "node scripts/strip-nbsp.mjs && eslint \"src/**/*.{ts,js}\"",
+    "test": "vitest run",
+    "dev:test": "vitest",
+    "docs:clean": "rimraf docs/api ../../docs-generated/library ../../docs-generated/api",
+    "docs": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js && pnpm --dir ../../ exec node apps/agentos-landing/scripts/copy-docs.js",
+    "docs:watch": "npm run docs:clean && pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json && pnpm --dir ../../ exec typedoc --options typedoc.json && pnpm --dir ../../ exec node scripts/generate-api-docs.js && concurrently \"pnpm --dir ../../ exec typedoc --options packages/agentos/typedoc.json --watch\" \"pnpm --dir ../../ exec typedoc --options typedoc.json --watch\" \"pnpm --dir ../../ exec node apps/agentos-landing/scripts/copy-docs.js --watch\""
+  },
+  "keywords": [
+    "agentos",
+    "orchestration",
+    "typescript",
+    "llm",
+    "tools"
+  ],
+  "author": "Voice Chat Assistant Team",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^9.2.4",
+    "@semantic-release/npm": "^12.0.1",
+    "@semantic-release/release-notes-generator": "^14.0.1",
+    "conventional-changelog-conventionalcommits": "^7.0.2",
+    "@types/natural": "^5.1.5",
+    "@types/node": "^20.12.12",
+    "eslint": "^9.11.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.29.1",
+    "@eslint/js": "^9.11.0",
+    "typescript-eslint": "^8.0.0",
+    "prettier": "^3.3.2",
+    "rimraf": "^5.0.7",
+    "semantic-release": "^24.1.0",
+    "ts-node": "^10.9.2",
+    "tsc-alias": "^1.8.10",
+    "tsconfig-paths": "^4.2.0",
+    "tsx": "^4.20.0",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "axios": "^1.7.7",
+    "lru-cache": "^11.1.0",
+    "natural": "^6.12.0",
+    "pino": "^9.14.0",
+    "uuid": "^11.1.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0",
+    "@framers/sql-storage-adapter": ">=0.4.0"
+  },
+  "peerDependenciesMeta": {
+    "@framers/sql-storage-adapter": {
+      "optional": true
+    }
+  }
+}