@elizaos/autonomous 2.0.0-alpha.71 → 2.0.0-alpha.72

package/packages/autonomous/src/contracts/permissions.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared system permission contracts.
+ */
+export type SystemPermissionId = "accessibility" | "screen-recording" | "microphone" | "camera" | "shell";
+export type PermissionStatus = "granted" | "denied" | "not-determined" | "restricted" | "not-applicable";
+export type Platform = "darwin" | "win32" | "linux";
+export interface SystemPermissionDefinition {
+    id: SystemPermissionId;
+    name: string;
+    description: string;
+    icon: string;
+    platforms: Platform[];
+    requiredForFeatures: string[];
+}
+export interface PermissionState {
+    id: SystemPermissionId;
+    status: PermissionStatus;
+    lastChecked: number;
+    canRequest: boolean;
+}
+export interface PermissionCheckResult {
+    status: PermissionStatus;
+    canRequest: boolean;
+}
+export interface AllPermissionsState {
+    accessibility: PermissionState;
+    "screen-recording": PermissionState;
+    microphone: PermissionState;
+    camera: PermissionState;
+    shell: PermissionState;
+}
+export interface PermissionManagerConfig {
+    cacheTimeoutMs: number;
+}
+//# sourceMappingURL=permissions.d.ts.map

package/packages/autonomous/src/contracts/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../../../src/contracts/permissions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,kBAAkB,GAClB,YAAY,GACZ,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,QAAQ,GACR,gBAAgB,GAChB,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,kBAAkB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,kBAAkB,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,eAAe,CAAC;IAC/B,kBAAkB,EAAE,eAAe,CAAC;IACpC,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/packages/autonomous/src/contracts/permissions.js

@@ -0,0 +1,4 @@
+/**
+ * Shared system permission contracts.
+ */
+export {};

package/packages/autonomous/src/contracts/verification.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared verification API contracts.
+ */
+export interface VerificationResult {
+    verified: boolean;
+    error: string | null;
+    handle: string | null;
+}
+//# sourceMappingURL=verification.d.ts.map

package/packages/autonomous/src/contracts/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../../../src/contracts/verification.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/packages/autonomous/src/contracts/verification.js

@@ -0,0 +1,4 @@
+/**
+ * Shared verification API contracts.
+ */
+export {};

package/packages/autonomous/src/contracts/wallet.d.ts

@@ -0,0 +1,409 @@
+/**
+ * Shared wallet API contracts.
+ */
+export interface WalletKeys {
+    evmPrivateKey: string;
+    evmAddress: string;
+    solanaPrivateKey: string;
+    solanaAddress: string;
+}
+export interface WalletAddresses {
+    evmAddress: string | null;
+    solanaAddress: string | null;
+}
+export interface EvmTokenBalance {
+    symbol: string;
+    name: string;
+    contractAddress: string;
+    balance: string;
+    decimals: number;
+    valueUsd: string;
+    logoUrl: string;
+}
+export interface EvmChainBalance {
+    chain: string;
+    chainId: number;
+    nativeBalance: string;
+    nativeSymbol: string;
+    nativeValueUsd: string;
+    tokens: EvmTokenBalance[];
+    error: string | null;
+}
+export interface SolanaTokenBalance {
+    symbol: string;
+    name: string;
+    mint: string;
+    balance: string;
+    decimals: number;
+    valueUsd: string;
+    logoUrl: string;
+}
+export interface WalletBalancesResponse {
+    evm: {
+        address: string;
+        chains: EvmChainBalance[];
+    } | null;
+    solana: {
+        address: string;
+        solBalance: string;
+        solValueUsd: string;
+        tokens: SolanaTokenBalance[];
+    } | null;
+}
+export interface EvmNft {
+    contractAddress: string;
+    tokenId: string;
+    name: string;
+    description: string;
+    imageUrl: string;
+    collectionName: string;
+    tokenType: string;
+}
+export interface SolanaNft {
+    mint: string;
+    name: string;
+    description: string;
+    imageUrl: string;
+    collectionName: string;
+}
+export interface WalletNftsResponse {
+    evm: Array<{
+        chain: string;
+        nfts: EvmNft[];
+    }>;
+    solana: {
+        nfts: SolanaNft[];
+    } | null;
+}
+export declare const WALLET_RPC_PROVIDER_OPTIONS: {
+    readonly evm: readonly [{
+        readonly id: "eliza-cloud";
+        readonly label: "Eliza Cloud";
+    }, {
+        readonly id: "alchemy";
+        readonly label: "Alchemy";
+    }, {
+        readonly id: "infura";
+        readonly label: "Infura";
+    }, {
+        readonly id: "ankr";
+        readonly label: "Ankr";
+    }];
+    readonly bsc: readonly [{
+        readonly id: "eliza-cloud";
+        readonly label: "Eliza Cloud";
+    }, {
+        readonly id: "alchemy";
+        readonly label: "Alchemy";
+    }, {
+        readonly id: "ankr";
+        readonly label: "Ankr";
+    }, {
+        readonly id: "nodereal";
+        readonly label: "NodeReal";
+    }, {
+        readonly id: "quicknode";
+        readonly label: "QuickNode";
+    }];
+    readonly solana: readonly [{
+        readonly id: "eliza-cloud";
+        readonly label: "Eliza Cloud";
+    }, {
+        readonly id: "helius-birdeye";
+        readonly label: "Helius + Birdeye";
+    }];
+};
+export type WalletRpcChain = keyof typeof WALLET_RPC_PROVIDER_OPTIONS;
+export type EvmWalletRpcProvider = (typeof WALLET_RPC_PROVIDER_OPTIONS.evm)[number]["id"];
+export type BscWalletRpcProvider = (typeof WALLET_RPC_PROVIDER_OPTIONS.bsc)[number]["id"];
+export type SolanaWalletRpcProvider = (typeof WALLET_RPC_PROVIDER_OPTIONS.solana)[number]["id"];
+export interface WalletRpcSelections {
+    evm: EvmWalletRpcProvider;
+    bsc: BscWalletRpcProvider;
+    solana: SolanaWalletRpcProvider;
+}
+export declare const DEFAULT_WALLET_RPC_SELECTIONS: WalletRpcSelections;
+export declare function normalizeWalletRpcProviderId<TChain extends WalletRpcChain>(chain: TChain, value: string | null | undefined): WalletRpcSelections[TChain] | null;
+export declare function normalizeWalletRpcSelections(input: Partial<Record<WalletRpcChain, string | null | undefined>> | WalletRpcSelections | null | undefined): WalletRpcSelections;
+export type WalletRpcCredentialKey = "ALCHEMY_API_KEY" | "INFURA_API_KEY" | "ANKR_API_KEY" | "NODEREAL_BSC_RPC_URL" | "QUICKNODE_BSC_RPC_URL" | "HELIUS_API_KEY" | "BIRDEYE_API_KEY" | "ETHEREUM_RPC_URL" | "BASE_RPC_URL" | "AVALANCHE_RPC_URL" | "BSC_RPC_URL" | "SOLANA_RPC_URL";
+export interface WalletConfigUpdateRequest {
+    selections: WalletRpcSelections;
+    credentials?: Partial<Record<WalletRpcCredentialKey, string>>;
+}
+export interface WalletConfigStatus {
+    selectedRpcProviders: WalletRpcSelections;
+    legacyCustomChains: WalletRpcChain[];
+    alchemyKeySet: boolean;
+    infuraKeySet: boolean;
+    ankrKeySet: boolean;
+    nodeRealBscRpcSet?: boolean;
+    quickNodeBscRpcSet?: boolean;
+    managedBscRpcReady?: boolean;
+    cloudManagedAccess?: boolean;
+    evmBalanceReady?: boolean;
+    ethereumBalanceReady?: boolean;
+    baseBalanceReady?: boolean;
+    bscBalanceReady?: boolean;
+    avalancheBalanceReady?: boolean;
+    solanaBalanceReady?: boolean;
+    tradePermissionMode?: TradePermissionMode;
+    tradeUserCanLocalExecute?: boolean;
+    tradeAgentCanLocalExecute?: boolean;
+    heliusKeySet: boolean;
+    birdeyeKeySet: boolean;
+    evmChains: string[];
+    evmAddress: string | null;
+    solanaAddress: string | null;
+}
+export type TradePermissionMode = "user-sign-only" | "manual-local-key" | "agent-auto";
+export type BscTradeSide = "buy" | "sell";
+export interface BscTradePreflightRequest {
+    tokenAddress?: string;
+}
+export interface BscTradeReadinessChecks {
+    walletReady: boolean;
+    rpcReady: boolean;
+    chainReady: boolean;
+    gasReady: boolean;
+    tokenAddressValid: boolean;
+}
+export interface BscTradePreflightResponse {
+    ok: boolean;
+    walletAddress: string | null;
+    rpcUrlHost: string | null;
+    chainId: number | null;
+    bnbBalance: string | null;
+    minGasBnb: string;
+    checks: BscTradeReadinessChecks;
+    reasons: string[];
+}
+export interface BscTradeQuoteRequest {
+    side: BscTradeSide;
+    tokenAddress: string;
+    amount: string;
+    slippageBps?: number;
+}
+export interface BscTradeQuoteLeg {
+    symbol: string;
+    amount: string;
+    amountWei: string;
+}
+export interface BscTradeQuoteResponse {
+    ok: boolean;
+    side: BscTradeSide;
+    routerAddress: string;
+    wrappedNativeAddress: string;
+    tokenAddress: string;
+    slippageBps: number;
+    route: string[];
+    quoteIn: BscTradeQuoteLeg;
+    quoteOut: BscTradeQuoteLeg;
+    minReceive: BscTradeQuoteLeg;
+    price: string;
+    preflight: BscTradePreflightResponse;
+}
+export interface BscTradeExecuteRequest {
+    side: BscTradeSide;
+    tokenAddress: string;
+    amount: string;
+    slippageBps?: number;
+    confirm?: boolean;
+    deadlineSeconds?: number;
+}
+export interface BscUnsignedTradeTx {
+    chainId: number;
+    from: string | null;
+    to: string;
+    data: string;
+    valueWei: string;
+    deadline: number;
+    explorerUrl: string;
+}
+export interface BscUnsignedApprovalTx {
+    chainId: number;
+    from: string | null;
+    to: string;
+    data: string;
+    valueWei: string;
+    explorerUrl: string;
+    spender: string;
+    amountWei: string;
+}
+export interface BscTradeExecutionResult {
+    hash: string;
+    nonce: number;
+    gasLimit: string;
+    valueWei: string;
+    explorerUrl: string;
+    blockNumber: number | null;
+    status: "success" | "pending";
+    approvalHash?: string;
+}
+export type BscTradeTxStatus = "pending" | "success" | "reverted" | "not_found";
+export interface BscTradeTxStatusResponse {
+    ok: boolean;
+    hash: string;
+    status: BscTradeTxStatus;
+    explorerUrl: string;
+    chainId: number | null;
+    blockNumber: number | null;
+    confirmations: number;
+    nonce: number | null;
+    gasUsed: string | null;
+    effectiveGasPriceWei: string | null;
+    reason?: string;
+}
+export type WalletTradeSource = "agent" | "manual";
+export type WalletTradingProfileWindow = "7d" | "30d" | "all";
+export type WalletTradingProfileSourceFilter = "all" | WalletTradeSource;
+export interface WalletTradeLedgerQuoteLeg {
+    symbol: string;
+    amount: string;
+    amountWei: string;
+}
+export interface WalletTradeLedgerEntry {
+    hash: string;
+    createdAt: string;
+    updatedAt: string;
+    source: WalletTradeSource;
+    side: BscTradeSide;
+    tokenAddress: string;
+    slippageBps: number;
+    route: string[];
+    quoteIn: WalletTradeLedgerQuoteLeg;
+    quoteOut: WalletTradeLedgerQuoteLeg;
+    status: BscTradeTxStatus;
+    confirmations: number;
+    nonce: number | null;
+    blockNumber: number | null;
+    gasUsed: string | null;
+    effectiveGasPriceWei: string | null;
+    reason?: string;
+    explorerUrl: string;
+}
+export interface WalletTradingProfileSummary {
+    totalSwaps: number;
+    buyCount: number;
+    sellCount: number;
+    settledCount: number;
+    successCount: number;
+    revertedCount: number;
+    tradeWinRate: number | null;
+    txSuccessRate: number | null;
+    winningTrades: number;
+    evaluatedTrades: number;
+    realizedPnlBnb: string;
+    volumeBnb: string;
+}
+export interface WalletTradingProfileSeriesPoint {
+    day: string;
+    realizedPnlBnb: string;
+    volumeBnb: string;
+    swaps: number;
+}
+export interface WalletTradingProfileTokenBreakdown {
+    tokenAddress: string;
+    symbol: string;
+    buyCount: number;
+    sellCount: number;
+    realizedPnlBnb: string;
+    volumeBnb: string;
+    tradeWinRate: number | null;
+    winningTrades: number;
+    evaluatedTrades: number;
+}
+export interface WalletTradingProfileRecentSwap {
+    hash: string;
+    createdAt: string;
+    source: WalletTradeSource;
+    side: BscTradeSide;
+    status: BscTradeTxStatus;
+    tokenAddress: string;
+    tokenSymbol: string;
+    inputAmount: string;
+    inputSymbol: string;
+    outputAmount: string;
+    outputSymbol: string;
+    explorerUrl: string;
+    confirmations: number;
+    reason?: string;
+}
+export interface WalletTradingProfileResponse {
+    window: WalletTradingProfileWindow;
+    source: WalletTradingProfileSourceFilter;
+    generatedAt: string;
+    summary: WalletTradingProfileSummary;
+    pnlSeries: WalletTradingProfileSeriesPoint[];
+    tokenBreakdown: WalletTradingProfileTokenBreakdown[];
+    recentSwaps: WalletTradingProfileRecentSwap[];
+}
+export interface BscTradeExecuteResponse {
+    ok: boolean;
+    side: BscTradeSide;
+    mode: "local-key" | "user-sign";
+    quote: BscTradeQuoteResponse;
+    executed: boolean;
+    requiresUserSignature: boolean;
+    unsignedTx: BscUnsignedTradeTx;
+    unsignedApprovalTx?: BscUnsignedApprovalTx;
+    requiresApproval?: boolean;
+    execution?: BscTradeExecutionResult;
+}
+export interface BscTransferExecuteRequest {
+    toAddress: string;
+    amount: string;
+    assetSymbol: string;
+    tokenAddress?: string;
+    confirm?: boolean;
+}
+export interface BscUnsignedTransferTx {
+    chainId: number;
+    from: string | null;
+    to: string;
+    data: string;
+    valueWei: string;
+    explorerUrl: string;
+    assetSymbol: string;
+    amount: string;
+    tokenAddress?: string;
+}
+export interface BscTransferExecutionResult {
+    hash: string;
+    nonce: number;
+    gasLimit: string;
+    valueWei: string;
+    explorerUrl: string;
+    blockNumber: number | null;
+    status: "success" | "pending";
+}
+export interface BscTransferExecuteResponse {
+    ok: boolean;
+    mode: "local-key" | "user-sign";
+    executed: boolean;
+    requiresUserSignature: boolean;
+    toAddress: string;
+    amount: string;
+    assetSymbol: string;
+    tokenAddress?: string;
+    unsignedTx: BscUnsignedTransferTx;
+    execution?: BscTransferExecutionResult;
+}
+export type WalletChain = "evm" | "solana";
+export interface KeyValidationResult {
+    valid: boolean;
+    chain: WalletChain;
+    address: string | null;
+    error: string | null;
+}
+export interface WalletImportResult {
+    success: boolean;
+    chain: WalletChain;
+    address: string | null;
+    error: string | null;
+}
+export interface WalletGenerateResult {
+    chain: WalletChain;
+    address: string;
+    privateKey: string;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/packages/autonomous/src/contracts/wallet.d.ts.map

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

package/packages/autonomous/src/contracts/wallet.js

@@ -0,0 +1,60 @@
+/**
+ * Shared wallet API contracts.
+ */
+export const WALLET_RPC_PROVIDER_OPTIONS = {
+    evm: [
+        { id: "eliza-cloud", label: "Eliza Cloud" },
+        { id: "alchemy", label: "Alchemy" },
+        { id: "infura", label: "Infura" },
+        { id: "ankr", label: "Ankr" },
+    ],
+    bsc: [
+        { id: "eliza-cloud", label: "Eliza Cloud" },
+        { id: "alchemy", label: "Alchemy" },
+        { id: "ankr", label: "Ankr" },
+        { id: "nodereal", label: "NodeReal" },
+        { id: "quicknode", label: "QuickNode" },
+    ],
+    solana: [
+        { id: "eliza-cloud", label: "Eliza Cloud" },
+        { id: "helius-birdeye", label: "Helius + Birdeye" },
+    ],
+};
+export const DEFAULT_WALLET_RPC_SELECTIONS = {
+    evm: "eliza-cloud",
+    bsc: "eliza-cloud",
+    solana: "eliza-cloud",
+};
+const WALLET_RPC_PROVIDER_ALIASES = {
+    elizacloud: "eliza-cloud",
+    helius: "helius-birdeye",
+};
+const WALLET_RPC_PROVIDER_IDS = {
+    evm: new Set(WALLET_RPC_PROVIDER_OPTIONS.evm.map((option) => option.id)),
+    bsc: new Set(WALLET_RPC_PROVIDER_OPTIONS.bsc.map((option) => option.id)),
+    solana: new Set(WALLET_RPC_PROVIDER_OPTIONS.solana.map((option) => option.id)),
+};
+export function normalizeWalletRpcProviderId(chain, value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim().toLowerCase();
+    if (!trimmed)
+        return null;
+    const normalized = WALLET_RPC_PROVIDER_ALIASES[trimmed]
+        ? WALLET_RPC_PROVIDER_ALIASES[trimmed]
+        : trimmed;
+    if (WALLET_RPC_PROVIDER_IDS[chain].has(normalized)) {
+        return normalized;
+    }
+    return null;
+}
+export function normalizeWalletRpcSelections(input) {
+    return {
+        evm: normalizeWalletRpcProviderId("evm", input?.evm) ??
+            DEFAULT_WALLET_RPC_SELECTIONS.evm,
+        bsc: normalizeWalletRpcProviderId("bsc", input?.bsc) ??
+            DEFAULT_WALLET_RPC_SELECTIONS.bsc,
+        solana: normalizeWalletRpcProviderId("solana", input?.solana) ??
+            DEFAULT_WALLET_RPC_SELECTIONS.solana,
+    };
+}

package/packages/autonomous/src/diagnostics/integration-observability.d.ts

@@ -0,0 +1,40 @@
+export type IntegrationBoundary = "cloud" | "wallet" | "marketplace" | "mcp";
+export type IntegrationOutcome = "success" | "failure";
+export interface IntegrationObservabilityEvent {
+    schema: "integration_boundary_v1";
+    boundary: IntegrationBoundary;
+    operation: string;
+    outcome: IntegrationOutcome;
+    durationMs: number;
+    timeoutMs?: number;
+    statusCode?: number;
+    errorKind?: string;
+}
+interface IntegrationLogger {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+}
+interface IntegrationSpanMeta {
+    boundary: IntegrationBoundary;
+    operation: string;
+    timeoutMs?: number;
+}
+interface IntegrationSpanSuccessArgs {
+    statusCode?: number;
+}
+interface IntegrationSpanFailureArgs {
+    statusCode?: number;
+    error?: unknown;
+    errorKind?: string;
+}
+interface CreateSpanOptions {
+    now?: () => number;
+    sink?: IntegrationLogger;
+}
+export interface IntegrationTelemetrySpan {
+    success: (args?: IntegrationSpanSuccessArgs) => void;
+    failure: (args?: IntegrationSpanFailureArgs) => void;
+}
+export declare function createIntegrationTelemetrySpan(meta: IntegrationSpanMeta, options?: CreateSpanOptions): IntegrationTelemetrySpan;
+export {};
+//# sourceMappingURL=integration-observability.d.ts.map

package/packages/autonomous/src/diagnostics/integration-observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-observability.d.ts","sourceRoot":"","sources":["../../../../../src/diagnostics/integration-observability.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,KAAK,CAAC;AAC7E,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,yBAAyB,CAAC;IAClC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,0BAA0B;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,0BAA0B;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,iBAAiB;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,0BAA0B,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,0BAA0B,KAAK,IAAI,CAAC;CACtD;AAwCD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,mBAAmB,EACzB,OAAO,GAAE,iBAAsB,GAC9B,wBAAwB,CA2C1B"}

package/packages/autonomous/src/diagnostics/integration-observability.js

@@ -0,0 +1,68 @@
+import { logger } from "@elizaos/core";
+const EVENT_PREFIX = "[integration]";
+function inferErrorKind(error) {
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        if (error.name === "AbortError" ||
+            error.name === "TimeoutError" ||
+            message.includes("timeout") ||
+            message.includes("timed out")) {
+            return "timeout";
+        }
+        return sanitizeToken(error.name);
+    }
+    if (typeof error === "string")
+        return sanitizeToken(error);
+    return undefined;
+}
+function sanitizeToken(value) {
+    if (!value)
+        return undefined;
+    const token = value.toLowerCase().replace(/[^a-z0-9_-]/g, "_");
+    const normalized = token.replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+    return normalized ? normalized.slice(0, 64) : undefined;
+}
+function emitEvent(sink, event) {
+    const line = `${EVENT_PREFIX} ${JSON.stringify(event)}`;
+    if (event.outcome === "success") {
+        sink.info(line);
+        return;
+    }
+    sink.warn(line);
+}
+export function createIntegrationTelemetrySpan(meta, options = {}) {
+    const now = options.now ?? Date.now;
+    const sink = options.sink ?? logger;
+    const startedAt = now();
+    let settled = false;
+    const finalize = (outcome, args) => {
+        if (settled)
+            return;
+        settled = true;
+        const durationMs = Math.max(0, now() - startedAt);
+        const event = {
+            schema: "integration_boundary_v1",
+            boundary: meta.boundary,
+            operation: meta.operation,
+            outcome,
+            durationMs,
+        };
+        if (typeof meta.timeoutMs === "number") {
+            event.timeoutMs = meta.timeoutMs;
+        }
+        if (typeof args?.statusCode === "number") {
+            event.statusCode = args.statusCode;
+        }
+        if (outcome === "failure") {
+            const failureArgs = args;
+            event.errorKind =
+                sanitizeToken(failureArgs?.errorKind) ??
+                    inferErrorKind(failureArgs?.error);
+        }
+        emitEvent(sink, event);
+    };
+    return {
+        success: (args) => finalize("success", args),
+        failure: (args) => finalize("failure", args),
+    };
+}