@hashgraphonline/standards-agent-kit 0.2.112 → 0.2.113

package/dist/es/standards-agent-kit.es32.js

@@ -1,249 +1,32 @@
-import { updateEnvFile } from "./standards-agent-kit.es35.js";
-import { Logger, ConnectionsManager } from "@hashgraphonline/standards-sdk";
-class OpenConvaiState {
-  /**
-   * Creates a new OpenConvaiState instance
-   * @param options - Options for environment variable persistence
-   */
-  constructor(options) {
-    this.currentAgent = null;
-    this.connectionMessageTimestamps = {};
-    this.connectionsManager = null;
-    this.defaultEnvFilePath = options?.defaultEnvFilePath;
-    this.defaultPrefix = options?.defaultPrefix ?? "TODD";
-    const shouldSilence = options?.disableLogging || process.env.DISABLE_LOGGING === "true";
-    this.logger = new Logger({ module: "OpenConvaiState", silent: shouldSilence });
-    if (options?.baseClient) {
-      this.initializeConnectionsManager(options.baseClient);
-    }
-  }
-  /**
-   * Initializes the ConnectionsManager
-   * @param baseClient - HCS10BaseClient instance to use
-   */
-  initializeConnectionsManager(baseClient) {
-    if (!this.connectionsManager) {
-      this.logger.debug("Initializing ConnectionsManager");
-      this.connectionsManager = new ConnectionsManager({
-        baseClient,
-        logLevel: "error"
-      });
-    } else {
-      this.logger.debug("ConnectionsManager already initialized");
-    }
-    return this.connectionsManager;
-  }
-  /**
-   * Gets the ConnectionsManager instance
-   * @returns The ConnectionsManager instance, or null if not initialized
-   */
-  getConnectionsManager() {
-    return this.connectionsManager;
-  }
-  /**
-   * Sets the current active agent and clears any previous connection data.
-   * This should be called when switching between agents.
-   */
-  setCurrentAgent(agent) {
-    this.currentAgent = agent;
-    this.connectionMessageTimestamps = {};
-    if (this.connectionsManager) {
-      this.connectionsManager.clearAll();
-    }
+import { BaseHederaTransactionTool, BaseHederaQueryTool } from "hedera-agent-kit";
+class BaseInscriberTransactionTool extends BaseHederaTransactionTool {
+  constructor(params) {
+    super(params);
+    this.namespace = "inscriber";
+    this.inscriberBuilder = params.inscriberBuilder;
   }
   /**
-   * Returns the currently active agent or null if none is set.
+   * Override to return the InscriberBuilder
    */
-  getCurrentAgent() {
-    return this.currentAgent;
+  getServiceBuilder() {
+    return this.inscriberBuilder;
   }
-  /**
-   * Adds a new connection to the active connections list.
-   * Ensures no duplicates are added based on connectionTopicId.
-   * Initializes timestamp tracking for the connection.
-   */
-  addActiveConnection(connection) {
-    if (!this.connectionsManager) {
-      this.logger.error(
-        "ConnectionsManager not initialized. Call initializeConnectionsManager before adding connections."
-      );
-      throw new Error(
-        "ConnectionsManager not initialized. Call initializeConnectionsManager before adding connections."
-      );
-    }
-    const sdkConnection = {
-      connectionTopicId: connection.connectionTopicId,
-      targetAccountId: connection.targetAccountId,
-      targetAgentName: connection.targetAgentName,
-      targetInboundTopicId: connection.targetInboundTopicId,
-      status: this.convertConnectionStatus(connection.status || "established"),
-      isPending: connection.isPending || false,
-      needsConfirmation: connection.needsConfirmation || false,
-      created: connection.created || /* @__PURE__ */ new Date(),
-      lastActivity: connection.lastActivity,
-      profileInfo: connection.profileInfo,
-      connectionRequestId: connection.connectionRequestId,
-      processed: true
-    };
-    this.connectionsManager.updateOrAddConnection(sdkConnection);
-    this.initializeTimestampIfNeeded(connection.connectionTopicId);
-  }
-  /**
-   * Updates an existing connection or adds it if not found.
-   * Preserves existing properties when updating by merging objects.
-   */
-  updateOrAddConnection(connection) {
-    this.addActiveConnection(connection);
-  }
-  /**
-   * Returns a copy of all active connections.
-   */
-  listConnections() {
-    if (!this.connectionsManager) {
-      this.logger.debug(
-        "ConnectionsManager not initialized, returning empty connections list"
-      );
-      return [];
-    }
-    return this.connectionsManager.getAllConnections().map((conn) => this.convertToActiveConnection(conn));
-  }
-  /**
-   * Finds a connection by its identifier, which can be:
-   * - A 1-based index as displayed in the connection list
-   * - A target account ID string
-   * - A connection topic ID string
-   */
-  getConnectionByIdentifier(identifier) {
-    if (!this.connectionsManager) {
-      return void 0;
-    }
-    const connections = this.listConnections();
-    const numericIndex = parseInt(identifier) - 1;
-    if (!isNaN(numericIndex) && numericIndex >= 0 && numericIndex < connections.length) {
-      return connections[numericIndex];
-    }
-    const byTopicId = this.connectionsManager.getConnectionByTopicId(identifier);
-    if (byTopicId) {
-      return this.convertToActiveConnection(byTopicId);
-    }
-    const byAccountId = this.connectionsManager.getConnectionByAccountId(identifier);
-    if (byAccountId) {
-      return this.convertToActiveConnection(byAccountId);
-    }
-    return void 0;
-  }
-  /**
-   * Gets the last processed message timestamp for a connection.
-   * Returns 0 if no timestamp has been recorded.
-   */
-  getLastTimestamp(connectionTopicId) {
-    return this.connectionMessageTimestamps[connectionTopicId] || 0;
-  }
-  /**
-   * Updates the last processed message timestamp for a connection,
-   * but only if the new timestamp is more recent than the existing one.
-   */
-  updateTimestamp(connectionTopicId, timestampNanos) {
-    if (!(connectionTopicId in this.connectionMessageTimestamps)) {
-      this.connectionMessageTimestamps[connectionTopicId] = timestampNanos;
-      return;
-    }
-    const currentTimestamp = this.connectionMessageTimestamps[connectionTopicId];
-    if (timestampNanos > currentTimestamp) {
-      this.connectionMessageTimestamps[connectionTopicId] = timestampNanos;
-    }
-  }
-  /**
-   * Helper method to initialize timestamp tracking for a connection
-   * if it doesn't already exist.
-   */
-  initializeTimestampIfNeeded(connectionTopicId) {
-    if (!(connectionTopicId in this.connectionMessageTimestamps)) {
-      this.connectionMessageTimestamps[connectionTopicId] = Date.now() * 1e6;
-    }
-  }
-  /**
-   * Converts ConnectionStatus to SDK status format
-   */
-  convertConnectionStatus(status) {
-    switch (status) {
-      case "pending":
-        return "pending";
-      case "established":
-        return "established";
-      case "needs confirmation":
-        return "needs_confirmation";
-      default:
-        return "established";
-    }
-  }
-  /**
-   * Converts SDK Connection to ActiveConnection
-   */
-  convertToActiveConnection(conn) {
-    return {
-      targetAccountId: conn.targetAccountId,
-      targetAgentName: conn.targetAgentName || `Agent ${conn.targetAccountId}`,
-      targetInboundTopicId: conn.targetInboundTopicId || "",
-      connectionTopicId: conn.connectionTopicId,
-      status: this.convertToStateStatus(conn.status),
-      created: conn.created,
-      lastActivity: conn.lastActivity,
-      isPending: conn.isPending,
-      needsConfirmation: conn.needsConfirmation,
-      profileInfo: conn.profileInfo,
-      connectionRequestId: conn.connectionRequestId
-    };
-  }
-  /**
-   * Converts SDK status to state status format
-   */
-  convertToStateStatus(status) {
-    switch (status) {
-      case "pending":
-        return "pending";
-      case "established":
-        return "established";
-      case "needs_confirmation":
-        return "needs confirmation";
-      case "closed":
-        return "established";
-      // Mapping closed to established for compatibility
-      default:
-        return "unknown";
-    }
+}
+class BaseInscriberQueryTool extends BaseHederaQueryTool {
+  constructor(params) {
+    super(params);
+    this.namespace = "inscriber";
+    this.inscriberBuilder = params.inscriberBuilder;
   }
   /**
-   * Persists agent data to environment variables
-   * @param agent - The agent data to persist
-   * @param options - Environment file persistence options
+   * Override to return the InscriberBuilder
    */
-  async persistAgentData(agent, options) {
-    if (options?.type && options.type !== "env-file") {
-      throw new Error(
-        `Unsupported persistence type: ${options.type}. Only 'env-file' is supported.`
-      );
-    }
-    const envFilePath = options?.envFilePath || this.defaultEnvFilePath || process.env.ENV_FILE_PATH || ".env";
-    const prefix = options?.prefix || this.defaultPrefix;
-    if (!agent.accountId || !agent.inboundTopicId || !agent.outboundTopicId) {
-      throw new Error("Agent data incomplete, cannot persist to environment");
-    }
-    const updates = {
-      [`${prefix}_ACCOUNT_ID`]: agent.accountId,
-      [`${prefix}_INBOUND_TOPIC_ID`]: agent.inboundTopicId,
-      [`${prefix}_OUTBOUND_TOPIC_ID`]: agent.outboundTopicId
-    };
-    if (agent.privateKey) {
-      updates[`${prefix}_PRIVATE_KEY`] = agent.privateKey;
-    }
-    if (agent.profileTopicId) {
-      updates[`${prefix}_PROFILE_TOPIC_ID`] = agent.profileTopicId;
-    }
-    await updateEnvFile(envFilePath, updates);
+  getServiceBuilder() {
+    return this.inscriberBuilder;
   }
 }
 export {
-  OpenConvaiState
+  BaseInscriberQueryTool,
+  BaseInscriberTransactionTool
 };
 //# sourceMappingURL=standards-agent-kit.es32.js.map

package/dist/es/standards-agent-kit.es32.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es32.js","sources":["../../src/state/open-convai-state.ts"],"sourcesContent":["import { updateEnvFile } from '../utils/state-tools';\nimport {\n  RegisteredAgent,\n  ActiveConnection,\n  IStateManager,\n  AgentPersistenceOptions,\n  EnvFilePersistenceOptions,\n  ConnectionStatus,\n} from './state-types';\nimport {\n  ConnectionsManager,\n  HCS10BaseClient,\n  Connection,\n  Logger,\n  IConnectionsManager,\n} from '@hashgraphonline/standards-sdk';\n\n/**\n * Implementation of the IStateManager interface for the OpenConvai system.\n * Manages agent state and connection information with thread safety and\n * proper timestamp tracking.\n */\nexport class OpenConvaiState implements IStateManager {\n  private currentAgent: RegisteredAgent | null = null;\n  private connectionMessageTimestamps: Record<string, number> = {};\n  private defaultEnvFilePath?: string;\n  private defaultPrefix: string;\n  private connectionsManager: IConnectionsManager | null = null;\n  private logger: Logger;\n\n  /**\n   * Creates a new OpenConvaiState instance\n   * @param options - Options for environment variable persistence\n   */\n  constructor(options?: {\n    defaultEnvFilePath?: string;\n    defaultPrefix?: string;\n    baseClient?: HCS10BaseClient;\n    disableLogging?: boolean;\n  }) {\n    this.defaultEnvFilePath = options?.defaultEnvFilePath;\n    this.defaultPrefix = options?.defaultPrefix ?? 'TODD';\n    const shouldSilence = options?.disableLogging || process.env.DISABLE_LOGGING === 'true';\n    this.logger = new Logger({ module: 'OpenConvaiState', silent: shouldSilence });\n\n    // Initialize ConnectionsManager immediately if baseClient is provided\n    if (options?.baseClient) {\n      this.initializeConnectionsManager(options.baseClient);\n    }\n  }\n\n  /**\n   * Initializes the ConnectionsManager\n   * @param baseClient - HCS10BaseClient instance to use\n   */\n  initializeConnectionsManager(\n    baseClient: HCS10BaseClient\n  ): IConnectionsManager {\n    if (!this.connectionsManager) {\n      this.logger.debug('Initializing ConnectionsManager');\n      this.connectionsManager = new ConnectionsManager({\n        baseClient,\n        logLevel: 'error',\n      });\n    } else {\n      this.logger.debug('ConnectionsManager already initialized');\n    }\n    return this.connectionsManager;\n  }\n\n  /**\n   * Gets the ConnectionsManager instance\n   * @returns The ConnectionsManager instance, or null if not initialized\n   */\n  getConnectionsManager(): IConnectionsManager | null {\n    return this.connectionsManager;\n  }\n\n  /**\n   * Sets the current active agent and clears any previous connection data.\n   * This should be called when switching between agents.\n   */\n  setCurrentAgent(agent: RegisteredAgent | null): void {\n    this.currentAgent = agent;\n    this.connectionMessageTimestamps = {};\n\n    // Clear connections manager when changing agents\n    if (this.connectionsManager) {\n      this.connectionsManager.clearAll();\n    }\n  }\n\n  /**\n   * Returns the currently active agent or null if none is set.\n   */\n  getCurrentAgent(): RegisteredAgent | null {\n    return this.currentAgent;\n  }\n\n  /**\n   * Adds a new connection to the active connections list.\n   * Ensures no duplicates are added based on connectionTopicId.\n   * Initializes timestamp tracking for the connection.\n   */\n  addActiveConnection(connection: ActiveConnection): void {\n    if (!this.connectionsManager) {\n      this.logger.error(\n        'ConnectionsManager not initialized. Call initializeConnectionsManager before adding connections.'\n      );\n      throw new Error(\n        'ConnectionsManager not initialized. Call initializeConnectionsManager before adding connections.'\n      );\n    }\n\n    // Convert from ActiveConnection to Connection\n    const sdkConnection: Connection = {\n      connectionTopicId: connection.connectionTopicId,\n      targetAccountId: connection.targetAccountId,\n      targetAgentName: connection.targetAgentName,\n      targetInboundTopicId: connection.targetInboundTopicId,\n      status: this.convertConnectionStatus(connection.status || 'established'),\n      isPending: connection.isPending || false,\n      needsConfirmation: connection.needsConfirmation || false,\n      created: connection.created || new Date(),\n      lastActivity: connection.lastActivity,\n      profileInfo: connection.profileInfo,\n      connectionRequestId: connection.connectionRequestId,\n      processed: true,\n    };\n\n    // Add to ConnectionsManager\n    this.connectionsManager.updateOrAddConnection(sdkConnection);\n\n    // Initialize timestamp tracking\n    this.initializeTimestampIfNeeded(connection.connectionTopicId);\n  }\n\n  /**\n   * Updates an existing connection or adds it if not found.\n   * Preserves existing properties when updating by merging objects.\n   */\n  updateOrAddConnection(connection: ActiveConnection): void {\n    this.addActiveConnection(connection);\n  }\n\n  /**\n   * Returns a copy of all active connections.\n   */\n  listConnections(): ActiveConnection[] {\n    if (!this.connectionsManager) {\n      this.logger.debug(\n        'ConnectionsManager not initialized, returning empty connections list'\n      );\n      return [];\n    }\n\n    // Convert SDK Connections to ActiveConnection\n    return this.connectionsManager\n      .getAllConnections()\n      .map((conn) => this.convertToActiveConnection(conn));\n  }\n\n  /**\n   * Finds a connection by its identifier, which can be:\n   * - A 1-based index as displayed in the connection list\n   * - A target account ID string\n   * - A connection topic ID string\n   */\n  getConnectionByIdentifier(identifier: string): ActiveConnection | undefined {\n    if (!this.connectionsManager) {\n      return undefined;\n    }\n\n    const connections = this.listConnections();\n\n    // Check if it's a 1-based index\n    const numericIndex = parseInt(identifier) - 1;\n    if (\n      !isNaN(numericIndex) &&\n      numericIndex >= 0 &&\n      numericIndex < connections.length\n    ) {\n      return connections[numericIndex];\n    }\n\n    // Check if it's a topic ID\n    const byTopicId =\n      this.connectionsManager.getConnectionByTopicId(identifier);\n    if (byTopicId) {\n      return this.convertToActiveConnection(byTopicId);\n    }\n\n    // Check if it's an account ID\n    const byAccountId =\n      this.connectionsManager.getConnectionByAccountId(identifier);\n    if (byAccountId) {\n      return this.convertToActiveConnection(byAccountId);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Gets the last processed message timestamp for a connection.\n   * Returns 0 if no timestamp has been recorded.\n   */\n  getLastTimestamp(connectionTopicId: string): number {\n    return this.connectionMessageTimestamps[connectionTopicId] || 0;\n  }\n\n  /**\n   * Updates the last processed message timestamp for a connection,\n   * but only if the new timestamp is more recent than the existing one.\n   */\n  updateTimestamp(connectionTopicId: string, timestampNanos: number): void {\n    // Initialize if this is first update and skip the comparison logic\n    if (!(connectionTopicId in this.connectionMessageTimestamps)) {\n      this.connectionMessageTimestamps[connectionTopicId] = timestampNanos;\n      return;\n    }\n\n    // Otherwise, only update if newer\n    const currentTimestamp =\n      this.connectionMessageTimestamps[connectionTopicId];\n    if (timestampNanos > currentTimestamp) {\n      this.connectionMessageTimestamps[connectionTopicId] = timestampNanos;\n    }\n  }\n\n  /**\n   * Helper method to initialize timestamp tracking for a connection\n   * if it doesn't already exist.\n   */\n  private initializeTimestampIfNeeded(connectionTopicId: string): void {\n    if (!(connectionTopicId in this.connectionMessageTimestamps)) {\n      this.connectionMessageTimestamps[connectionTopicId] =\n        Date.now() * 1_000_000;\n    }\n  }\n\n  /**\n   * Converts ConnectionStatus to SDK status format\n   */\n  private convertConnectionStatus(\n    status: string\n  ): 'pending' | 'established' | 'needs_confirmation' | 'closed' {\n    switch (status) {\n      case 'pending':\n        return 'pending';\n      case 'established':\n        return 'established';\n      case 'needs confirmation':\n        return 'needs_confirmation';\n      default:\n        return 'established';\n    }\n  }\n\n  /**\n   * Converts SDK Connection to ActiveConnection\n   */\n  private convertToActiveConnection(conn: Connection): ActiveConnection {\n    return {\n      targetAccountId: conn.targetAccountId,\n      targetAgentName: conn.targetAgentName || `Agent ${conn.targetAccountId}`,\n      targetInboundTopicId: conn.targetInboundTopicId || '',\n      connectionTopicId: conn.connectionTopicId,\n      status: this.convertToStateStatus(conn.status),\n      created: conn.created,\n      lastActivity: conn.lastActivity,\n      isPending: conn.isPending,\n      needsConfirmation: conn.needsConfirmation,\n      profileInfo: conn.profileInfo,\n      connectionRequestId: conn.connectionRequestId,\n    };\n  }\n\n  /**\n   * Converts SDK status to state status format\n   */\n  private convertToStateStatus(status: string): ConnectionStatus {\n    switch (status) {\n      case 'pending':\n        return 'pending';\n      case 'established':\n        return 'established';\n      case 'needs_confirmation':\n        return 'needs confirmation';\n      case 'closed':\n        return 'established'; // Mapping closed to established for compatibility\n      default:\n        return 'unknown';\n    }\n  }\n\n  /**\n   * Persists agent data to environment variables\n   * @param agent - The agent data to persist\n   * @param options - Environment file persistence options\n   */\n  async persistAgentData(\n    agent: RegisteredAgent,\n    options?: AgentPersistenceOptions\n  ): Promise<void> {\n    if (options?.type && options.type !== 'env-file') {\n      throw new Error(\n        `Unsupported persistence type: ${options.type}. Only 'env-file' is supported.`\n      );\n    }\n\n    const envFilePath =\n      (options as EnvFilePersistenceOptions)?.envFilePath ||\n      this.defaultEnvFilePath ||\n      process.env.ENV_FILE_PATH ||\n      '.env';\n\n    if (!envFilePath) {\n      throw new Error(\n        'Environment file path could not be determined for agent data persistence'\n      );\n    }\n\n    const prefix =\n      (options as EnvFilePersistenceOptions)?.prefix || this.defaultPrefix;\n\n    if (!agent.accountId || !agent.inboundTopicId || !agent.outboundTopicId) {\n      throw new Error('Agent data incomplete, cannot persist to environment');\n    }\n\n    const updates: Record<string, string> = {\n      [`${prefix}_ACCOUNT_ID`]: agent.accountId,\n      [`${prefix}_INBOUND_TOPIC_ID`]: agent.inboundTopicId,\n      [`${prefix}_OUTBOUND_TOPIC_ID`]: agent.outboundTopicId,\n    };\n\n    if (agent.privateKey) {\n      updates[`${prefix}_PRIVATE_KEY`] = agent.privateKey;\n    }\n\n    if (agent.profileTopicId) {\n      updates[`${prefix}_PROFILE_TOPIC_ID`] = agent.profileTopicId;\n    }\n\n    await updateEnvFile(envFilePath, updates);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-agent-kit.es32.js","sources":["../../src/tools/inscriber/base-inscriber-tools.ts"],"sourcesContent":["import {\n  BaseHederaTransactionTool,\n  BaseHederaQueryTool,\n  BaseServiceBuilder,\n} from 'hedera-agent-kit';\nimport { InscriberBuilder } from '../../builders/inscriber/inscriber-builder';\nimport {\n  InscriberTransactionToolParams,\n  InscriberQueryToolParams,\n} from './inscriber-tool-params';\nimport { z } from 'zod';\n\n/**\n * Base class for Inscriber transaction tools\n */\nexport abstract class BaseInscriberTransactionTool<\n  T extends z.ZodObject<\n    z.ZodRawShape,\n    z.UnknownKeysParam,\n    z.ZodTypeAny\n  > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaTransactionTool<T> {\n  protected inscriberBuilder: InscriberBuilder;\n  namespace = 'inscriber' as const;\n\n  constructor(params: InscriberTransactionToolParams) {\n    super(params);\n    this.inscriberBuilder = params.inscriberBuilder;\n  }\n\n  /**\n   * Override to return the InscriberBuilder\n   */\n  protected getServiceBuilder(): BaseServiceBuilder {\n    return this.inscriberBuilder;\n  }\n}\n\n/**\n * Base class for Inscriber query tools\n */\nexport abstract class BaseInscriberQueryTool<\n  T extends z.ZodObject<\n    z.ZodRawShape,\n    z.UnknownKeysParam,\n    z.ZodTypeAny\n  > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaQueryTool<T> {\n  protected inscriberBuilder: InscriberBuilder;\n  namespace = 'inscriber' as const;\n\n  constructor(params: InscriberQueryToolParams) {\n    super(params);\n    this.inscriberBuilder = params.inscriberBuilder;\n  }\n\n  /**\n   * Override to return the InscriberBuilder\n   */\n  protected getServiceBuilder(): BaseServiceBuilder {\n    return this.inscriberBuilder;\n  }\n}"],"names":[],"mappings":";AAeO,MAAe,qCAMZ,0BAA6B;AAAA,EAIrC,YAAY,QAAwC;AAClD,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,mBAAmB,OAAO;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AACF;AAKO,MAAe,+BAMZ,oBAAuB;AAAA,EAI/B,YAAY,QAAkC;AAC5C,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,mBAAmB,OAAO;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AACF;"}

package/dist/es/standards-agent-kit.es33.js

@@ -1,141 +1,160 @@
-import { ServerSigner, HederaAgentKit } from "hedera-agent-kit";
-import { HCS10Builder } from "./standards-agent-kit.es2.js";
-import { RegisterAgentTool } from "./standards-agent-kit.es7.js";
-import { FindRegistrationsTool } from "./standards-agent-kit.es12.js";
-import { InitiateConnectionTool } from "./standards-agent-kit.es9.js";
-import { ListConnectionsTool } from "./standards-agent-kit.es10.js";
-import { SendMessageToConnectionTool } from "./standards-agent-kit.es8.js";
-import { CheckMessagesTool } from "./standards-agent-kit.es11.js";
-import { ConnectionMonitorTool } from "./standards-agent-kit.es13.js";
-import { ManageConnectionRequestsTool } from "./standards-agent-kit.es14.js";
-import { AcceptConnectionRequestTool } from "./standards-agent-kit.es15.js";
-import { RetrieveProfileTool } from "./standards-agent-kit.es16.js";
-import { ListUnapprovedConnectionRequestsTool } from "./standards-agent-kit.es17.js";
-import { OpenConvaiState } from "./standards-agent-kit.es32.js";
-import { Logger } from "@hashgraphonline/standards-sdk";
-import { ENV_FILE_PATH } from "./standards-agent-kit.es35.js";
-const initializeStandardsAgentKit = async (options) => {
-  const config = options?.clientConfig || {};
-  const operatorId = config.operatorId || process.env.HEDERA_OPERATOR_ID;
-  const operatorPrivateKey = config.operatorKey || process.env.HEDERA_OPERATOR_KEY;
-  const networkEnv = config.network || process.env.HEDERA_NETWORK || "testnet";
-  let network;
-  if (networkEnv === "mainnet") {
-    network = "mainnet";
-  } else if (networkEnv === "testnet") {
-    network = "testnet";
-  } else {
-    console.warn(
-      `Unsupported network specified: '${networkEnv}'. Defaulting to 'testnet'.`
-    );
-    network = "testnet";
+import { z } from "zod";
+import { BaseInscriberQueryTool } from "./standards-agent-kit.es32.js";
+const inscribeFromUrlSchema = z.object({
+  url: z.string().url().describe("The URL of the content to inscribe"),
+  mode: z.enum(["file", "hashinal"]).optional().describe("Inscription mode: file or hashinal NFT"),
+  metadata: z.record(z.unknown()).optional().describe("Metadata to attach to the inscription"),
+  tags: z.array(z.string()).optional().describe("Tags to categorize the inscription"),
+  chunkSize: z.number().int().positive().optional().describe("Chunk size for large files"),
+  waitForConfirmation: z.boolean().optional().describe("Whether to wait for inscription confirmation"),
+  apiKey: z.string().optional().describe("API key for inscription service")
+});
+class InscribeFromUrlTool extends BaseInscriberQueryTool {
+  constructor() {
+    super(...arguments);
+    this.name = "inscribeFromUrl";
+    this.description = "Inscribe content ONLY from URLs that point directly to downloadable files (PDF, image, JSON, ZIP, etc). This tool will FAIL for web pages, news sites, or social media. Examples of VALID URLs: https://example.com/document.pdf, https://cdn.example.com/image.jpg, https://api.example.com/data.json. For web page articles or any content you retrieve via MCP tools, you MUST use inscribeFromBuffer instead after retrieving the content.";
   }
-  if (!operatorId || !operatorPrivateKey) {
-    throw new Error(
-      "Operator ID and private key must be provided either through options or environment variables."
-    );
+  get specificInputSchema() {
+    return inscribeFromUrlSchema;
   }
-  const shouldSilence = process.env.DISABLE_LOGGING === "true";
-  const logger = Logger.getInstance({
-    level: config.logLevel || "info",
-    silent: shouldSilence
-  });
-  const stateManager = options?.stateManager || new OpenConvaiState({
-    defaultEnvFilePath: ENV_FILE_PATH,
-    defaultPrefix: "TODD"
-  });
-  logger.info("State manager initialized");
-  const signer = new ServerSigner(operatorId, operatorPrivateKey, network);
-  const hederaKit = new HederaAgentKit(signer);
-  await hederaKit.initialize();
-  logger.info(`HederaAgentKit initialized for ${operatorId} on ${network}`);
-  const hcs10Builder = new HCS10Builder(hederaKit, stateManager, {
-    useEncryption: config.useEncryption,
-    registryUrl: config.registryUrl,
-    logLevel: config.logLevel
-  });
-  let monitoringHederaKit;
-  let monitoringHcs10Builder;
-  if (options?.monitoringClient) {
-    const monitoringSigner = new ServerSigner(operatorId, operatorPrivateKey, network);
-    monitoringHederaKit = new HederaAgentKit(monitoringSigner);
-    await monitoringHederaKit.initialize();
-    monitoringHcs10Builder = new HCS10Builder(monitoringHederaKit, stateManager, {
-      useEncryption: config.useEncryption,
-      registryUrl: config.registryUrl,
-      logLevel: "error"
-    });
-    logger.info("Monitoring client initialized");
+  async executeQuery(params, _runManager) {
+    console.log(`[DEBUG] InscribeFromUrlTool.executeQuery called with URL: ${params.url}`);
+    if (!params.url || params.url.trim() === "") {
+      throw new Error("URL cannot be empty. Please provide a valid URL.");
+    }
+    try {
+      const urlObj = new URL(params.url);
+      if (!urlObj.protocol || !urlObj.host) {
+        throw new Error("Invalid URL format. Please provide a complete URL with protocol (http/https).");
+      }
+      if (!["http:", "https:"].includes(urlObj.protocol)) {
+        throw new Error("Only HTTP and HTTPS URLs are supported for inscription.");
+      }
+    } catch (error) {
+      throw new Error(`Invalid URL: ${params.url}. Please provide a valid URL.`);
+    }
+    console.log(`[InscribeFromUrlTool] Validating URL content before inscription...`);
+    try {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 1e4);
+      try {
+        const headResponse = await fetch(params.url, {
+          method: "HEAD",
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!headResponse.ok) {
+          throw new Error(`URL returned error status ${headResponse.status}: ${headResponse.statusText}. Cannot inscribe content from inaccessible URLs.`);
+        }
+        const contentType = headResponse.headers.get("content-type") || "";
+        const contentLength = headResponse.headers.get("content-length");
+        const webPageContentTypes = [
+          "text/html",
+          "application/xhtml+xml",
+          "text/xml"
+        ];
+        if (webPageContentTypes.some((type) => contentType.toLowerCase().includes(type))) {
+          throw new Error(`URL returns HTML/web page content (Content-Type: ${contentType}). This tool only works with direct file URLs (PDFs, images, JSON, etc.). For web page content, first retrieve the content using the appropriate MCP tool or web scraper, then use inscribeFromBuffer to inscribe it.`);
+        }
+        if (contentLength && parseInt(contentLength) === 0) {
+          throw new Error("URL returns empty content (Content-Length: 0). Cannot inscribe empty content.");
+        }
+        if (contentLength && parseInt(contentLength) < 10) {
+          throw new Error(`URL content is too small (${contentLength} bytes). Content must be at least 10 bytes.`);
+        }
+        if (!contentType || contentType === "application/octet-stream") {
+          console.log(`[InscribeFromUrlTool] Content-Type unclear, fetching first 1KB to verify...`);
+          const getController = new AbortController();
+          const getTimeoutId = setTimeout(() => getController.abort(), 5e3);
+          try {
+            const getResponse = await fetch(params.url, {
+              signal: getController.signal,
+              headers: {
+                "Range": "bytes=0-1023"
+                // Get first 1KB
+              }
+            });
+            clearTimeout(getTimeoutId);
+            if (getResponse.ok || getResponse.status === 206) {
+              const buffer = await getResponse.arrayBuffer();
+              const bytes = new Uint8Array(buffer);
+              const text = new TextDecoder("utf-8", { fatal: false }).decode(bytes.slice(0, 512));
+              if (text.toLowerCase().includes("<!doctype html") || text.toLowerCase().includes("<html") || text.match(/<meta\s+[^>]*>/i) || text.match(/<title>/i)) {
+                throw new Error(`URL returns HTML content. This tool only works with direct file URLs. For web page content, first retrieve it using the appropriate tool, then use inscribeFromBuffer.`);
+              }
+            }
+          } catch (getError) {
+            clearTimeout(getTimeoutId);
+            if (getError instanceof Error && getError.message.includes("HTML content")) {
+              throw getError;
+            }
+            console.log(`[InscribeFromUrlTool] Could not perform partial GET validation: ${getError instanceof Error ? getError.message : "Unknown error"}`);
+          }
+        }
+        console.log(`[InscribeFromUrlTool] URL validation passed. Content-Type: ${contentType}, Content-Length: ${contentLength || "unknown"}`);
+      } catch (fetchError) {
+        clearTimeout(timeoutId);
+        throw fetchError;
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          console.log(`[InscribeFromUrlTool] Warning: URL validation timed out after 10 seconds. Proceeding with inscription attempt.`);
+        } else if (error.message.includes("URL returned error") || error.message.includes("empty content") || error.message.includes("too small") || error.message.includes("HTML")) {
+          throw error;
+        } else {
+          console.log(`[InscribeFromUrlTool] Warning: Could not validate URL with HEAD request: ${error.message}. Proceeding with inscription attempt.`);
+        }
+      }
+    }
+    const options = {
+      mode: params.mode,
+      metadata: params.metadata,
+      tags: params.tags,
+      chunkSize: params.chunkSize,
+      waitForConfirmation: params.waitForConfirmation ?? true,
+      waitMaxAttempts: 10,
+      waitIntervalMs: 3e3,
+      apiKey: params.apiKey,
+      network: this.inscriberBuilder["hederaKit"].client.network.toString().includes("mainnet") ? "mainnet" : "testnet"
+    };
+    try {
+      const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => reject(new Error("Inscription timed out after 30 seconds")), 3e4);
+      });
+      const result = await Promise.race([
+        this.inscriberBuilder.inscribe(
+          { type: "url", url: params.url },
+          options
+        ),
+        timeoutPromise
+      ]);
+      if (result.confirmed) {
+        const topicId = result.inscription?.topic_id || result.result.topicId;
+        const network = options.network || "testnet";
+        const cdnUrl = topicId ? `https://kiloscribe.com/api/inscription-cdn/${topicId}?network=${network}` : null;
+        return `Successfully inscribed and confirmed content on the Hedera network!
+
+Transaction ID: ${result.result.transactionId}
+Topic ID: ${topicId || "N/A"}${cdnUrl ? `
+View inscription: ${cdnUrl}` : ""}
+
+The inscription is now available.`;
+      } else {
+        return `Successfully submitted inscription to the Hedera network!
+
+Transaction ID: ${result.result.transactionId}
+
+The inscription is processing and will be confirmed shortly.`;
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Failed to inscribe from URL";
+      throw new Error(`Inscription failed: ${errorMessage}`);
+    }
   }
-  const tools = {};
-  tools.registerAgentTool = new RegisterAgentTool({
-    hederaKit,
-    hcs10Builder,
-    logger: void 0
-  });
-  if (options?.createAllTools) {
-    tools.findRegistrationsTool = new FindRegistrationsTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    tools.retrieveProfileTool = new RetrieveProfileTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    tools.initiateConnectionTool = new InitiateConnectionTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    tools.listConnectionsTool = new ListConnectionsTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    tools.sendMessageToConnectionTool = new SendMessageToConnectionTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    tools.checkMessagesTool = new CheckMessagesTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    tools.connectionMonitorTool = new ConnectionMonitorTool({
-      hederaKit: monitoringHederaKit || hederaKit,
-      hcs10Builder: monitoringHcs10Builder || hcs10Builder,
-      logger: void 0
-    });
-    tools.manageConnectionRequestsTool = new ManageConnectionRequestsTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    tools.acceptConnectionRequestTool = new AcceptConnectionRequestTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    tools.listUnapprovedConnectionRequestsTool = new ListUnapprovedConnectionRequestsTool({
-      hederaKit,
-      hcs10Builder,
-      logger: void 0
-    });
-    logger.info("All tools initialized");
-  }
-  return {
-    hederaKit,
-    hcs10Builder,
-    monitoringHederaKit,
-    monitoringHcs10Builder,
-    tools,
-    stateManager
-  };
-};
+}
 export {
-  initializeStandardsAgentKit
+  InscribeFromUrlTool
 };
 //# sourceMappingURL=standards-agent-kit.es33.js.map