agentic-flow 2.0.1-alpha → 2.0.1-alpha.2

package/packages/agentic-jujutsu/index.d.ts

@@ -1,853 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-
-/* auto-generated by NAPI-RS */
-
-/** Configuration for JJWrapper */
-export interface JjConfig {
-  /** Path to jj executable (default: "jj") */
-  jjPath: string
-  /** Repository path (default: current directory) */
-  repoPath: string
-  /** Timeout for operations in milliseconds */
-  timeoutMs: number
-  /** Enable verbose logging */
-  verbose: boolean
-  /** Maximum operation log entries to keep in memory */
-  maxLogEntries: number
-  /** Enable AgentDB sync */
-  enableAgentdbSync: boolean
-}
-/**
- * ML-DSA signing keypair
- *
- * Contains public and secret keys for quantum-resistant digital signatures.
- */
-export interface SigningKeypair {
-  /** Public key (hex-encoded) */
-  publicKey: string
-  /** Secret key (hex-encoded) - should be kept secure */
-  secretKey: string
-}
-/**
- * Digital signature for an operation
- *
- * Contains the signature and associated metadata.
- */
-export interface OperationSignature {
-  /** Signature bytes (hex-encoded) */
-  signature: string
-  /** Public key used for verification (hex-encoded) */
-  publicKey: string
-  /** Timestamp when signature was created (ISO 8601) */
-  signedAt: string
-  /** Algorithm identifier */
-  algorithm: string
-}
-/**
- * Generate a new ML-DSA signing keypair
- *
- * Creates a quantum-resistant keypair for signing operations.
- *
- * # Examples
- *
- * ```rust
- * use agentic_jujutsu::crypto::generate_signing_keypair;
- *
- * let keypair = generate_signing_keypair();
- * println!("Public key: {}", keypair.public_key);
- * ```
- */
-export declare function generateSigningKeypair(): SigningKeypair
-/**
- * Sign a message with ML-DSA
- *
- * Creates a quantum-resistant digital signature for the given message.
- *
- * # Arguments
- *
- * * `message` - The message to sign
- * * `secret_key` - The secret key in hex format
- *
- * # Returns
- *
- * The signature bytes in hex format
- */
-export declare function signMessage(message: Array<number>, secretKey: string): string
-/**
- * Verify a message signature with ML-DSA
- *
- * Verifies that a signature is valid for the given message and public key.
- *
- * # Arguments
- *
- * * `message` - The message that was signed
- * * `signature` - The signature in hex format
- * * `public_key` - The public key in hex format
- *
- * # Returns
- *
- * `true` if the signature is valid, `false` otherwise
- */
-export declare function verifySignature(message: Array<number>, signature: string, publicKey: string): boolean
-/**
- * Type of jujutsu operation
- *
- * Represents the various operations that can be performed in a jujutsu repository.
- */
-export const enum OperationType {
-  /** Create a new commit */
-  Commit = 0,
-  /** Snapshot operation (automatic) */
-  Snapshot = 1,
-  /** Describe/amend commit message */
-  Describe = 2,
-  /** New commit creation */
-  New = 3,
-  /** Edit commit */
-  Edit = 4,
-  /** Abandon a commit */
-  Abandon = 5,
-  /** Rebase commits */
-  Rebase = 6,
-  /** Squash commits */
-  Squash = 7,
-  /** Resolve conflicts */
-  Resolve = 8,
-  /** Branch operation */
-  Branch = 9,
-  /** Delete a branch */
-  BranchDelete = 10,
-  /** Bookmark operation */
-  Bookmark = 11,
-  /** Create a tag */
-  Tag = 12,
-  /** Checkout a commit */
-  Checkout = 13,
-  /** Restore files */
-  Restore = 14,
-  /** Split a commit */
-  Split = 15,
-  /** Duplicate a commit */
-  Duplicate = 16,
-  /** Undo last operation */
-  Undo = 17,
-  /** Fetch from remote */
-  Fetch = 18,
-  /** Git fetch */
-  GitFetch = 19,
-  /** Push to remote */
-  Push = 20,
-  /** Git push */
-  GitPush = 21,
-  /** Clone repository */
-  Clone = 22,
-  /** Initialize repository */
-  Init = 23,
-  /** Git import */
-  GitImport = 24,
-  /** Git export */
-  GitExport = 25,
-  /** Move changes */
-  Move = 26,
-  /** Diffedit */
-  Diffedit = 27,
-  /** Merge branches */
-  Merge = 28,
-  /** Show status */
-  Status = 29,
-  /** Show commit log */
-  Log = 30,
-  /** Show diff */
-  Diff = 31,
-  /** Unknown operation type */
-  Unknown = 32
-}
-/**
- * Single jujutsu operation
- *
- * Represents a single operation in the jujutsu operation log with metadata.
- *
- * # Examples
- *
- * ```rust
- * use agentic_jujutsu::operations::{JJOperation, OperationType};
- *
- * let op = JJOperation::builder()
- *     .operation_type(OperationType::Commit)
- *     .command("jj commit".to_string())
- *     .user("alice".to_string())
- *     .build();
- * ```
- */
-export interface JjOperation {
-  /** Unique operation ID (generated by wrapper) */
-  id: string
-  /** Operation ID from jj (e.g., "abc123@example.com") */
-  operationId: string
-  /** Operation type (as string for N-API compatibility) */
-  operationType: string
-  /** Command that created this operation */
-  command: string
-  /** User who performed the operation */
-  user: string
-  /** Hostname where operation was performed */
-  hostname: string
-  /** Operation timestamp (ISO 8601 format) */
-  timestamp: string
-  /** Tags associated with this operation */
-  tags: Array<string>
-  /** Additional metadata (JSON string for N-API compatibility) */
-  metadata: string
-  /** Parent operation ID */
-  parentId?: string
-  /** Duration in milliseconds */
-  durationMs: number
-  /** Whether this operation was successful */
-  success: boolean
-  /** Error message (if failed) */
-  error?: string
-  /** Quantum fingerprint for fast integrity verification (hex string) */
-  quantumFingerprint?: string
-  /** Digital signature (hex-encoded, optional) */
-  signature?: string
-  /** Public key used for signature verification (hex-encoded, optional) */
-  signaturePublicKey?: string
-}
-/**
- * Quantum-resistant signing keypair (ML-DSA-65)
- *
- * This structure holds both the public and secret keys for ML-DSA signing.
- * Keys are stored as base64-encoded strings for JSON serialization.
- *
- * # Security Notes
- *
- * - Secret keys should be stored securely (encrypted at rest)
- * - Use key rotation policies (recommend rotation every 90 days)
- * - Never commit secret keys to version control
- * - Consider hardware security modules (HSM) for production
- */
-export interface SigningKeypair {
-  /** Base64-encoded ML-DSA-65 public key (~1,952 bytes) */
-  publicKey: string
-  /**
-   * Base64-encoded ML-DSA-65 secret key (~4,032 bytes)
-   * SECURITY: Handle with extreme care
-   */
-  secretKey: string
-  /** Key generation timestamp (ISO 8601) */
-  createdAt: string
-  /** Key identifier (SHA-256 hash of public key, first 16 chars) */
-  keyId: string
-  /** Algorithm identifier */
-  algorithm: string
-}
-/**
- * Quantum-resistant commit signature
- *
- * This structure represents a signed commit with ML-DSA signature and metadata.
- *
- * # Verification
- *
- * To verify a signature:
- * 1. Reconstruct commit data from commit_id and metadata
- * 2. Verify signature using public key
- * 3. Check timestamp is reasonable (not too old/future)
- */
-export interface CommitSignature {
-  /** Commit ID that was signed */
-  commitId: string
-  /** Base64-encoded ML-DSA-65 signature (~3,309 bytes) */
-  signature: string
-  /** Key ID used for signing (references SigningKeypair.key_id) */
-  keyId: string
-  /** Signature timestamp (ISO 8601) */
-  signedAt: string
-  /** Algorithm identifier */
-  algorithm: string
-  /** Additional metadata signed with commit */
-  metadata: Record<string, string>
-}
-/**
- * Result wrapper for jujutsu operations
- *
- * This type extends the basic command result with metadata about execution,
- * warnings, and structured data.
- *
- * # Examples
- *
- * ```rust
- * use agentic_jujutsu::types::JJResult;
- *
- * let result = JJResult::new("output".to_string(), "".to_string(), 0, 100);
- * assert!(result.success());
- * ```
- */
-export interface JjResult {
-  /** Standard output from the command */
-  stdout: string
-  /** Standard error from the command */
-  stderr: string
-  /** Exit code */
-  exitCode: number
-  /** Command execution time in milliseconds */
-  executionTimeMs: number
-}
-/**
- * Commit metadata
- *
- * Represents a single commit in the jujutsu repository with all associated metadata.
- *
- * # Examples
- *
- * ```rust
- * use agentic_jujutsu::types::JJCommit;
- *
- * let commit = JJCommit::builder()
- *     .id("abc123".to_string())
- *     .message("Add new feature".to_string())
- *     .author("Bob".to_string())
- *     .build();
- *
- * assert_eq!(commit.message, "Add new feature");
- * ```
- */
-export interface JjCommit {
-  /** Commit ID (revision hash) */
-  id: string
-  /** Change ID (unique identifier for the change) */
-  changeId: string
-  /** Commit message */
-  message: string
-  /** Author name */
-  author: string
-  /** Author email */
-  authorEmail: string
-  /** Timestamp (ISO 8601 format) */
-  timestamp: string
-  /** Parent commit IDs */
-  parents: Array<string>
-  /** Child commit IDs */
-  children: Array<string>
-  /** Branches pointing to this commit */
-  branches: Array<string>
-  /** Tags associated with this commit */
-  tags: Array<string>
-  /** Whether this is a merge commit */
-  isMerge: boolean
-  /** Whether this commit has conflicts */
-  hasConflicts: boolean
-  /** Whether this is an empty commit */
-  isEmpty: boolean
-}
-/**
- * Branch information
- *
- * Represents a branch in the jujutsu repository.
- *
- * # Examples
- *
- * ```rust
- * use agentic_jujutsu::types::JJBranch;
- *
- * let branch = JJBranch::new("feature/new-api".to_string(), "def456".to_string(), false);
- * assert_eq!(branch.name, "feature/new-api");
- * ```
- */
-export interface JjBranch {
-  /** Branch name */
-  name: string
-  /** Commit ID this branch points to */
-  target: string
-  /** Whether this is a remote branch */
-  isRemote: boolean
-  /** Remote name (if remote branch) */
-  remote?: string
-  /** Whether this branch is tracking a remote */
-  isTracking: boolean
-  /** Whether this is the current branch */
-  isCurrent: boolean
-  /** Creation timestamp (ISO 8601 format) */
-  createdAt: string
-}
-/**
- * Conflict representation
- *
- * Represents a merge conflict with detailed information about conflicting sides.
- *
- * # Examples
- *
- * ```rust
- * use agentic_jujutsu::types::JJConflict;
- *
- * let conflict = JJConflict::builder()
- *     .path("src/main.rs".to_string())
- *     .num_conflicts(1)
- *     .conflict_type("content".to_string())
- *     .build();
- * ```
- */
-export interface JjConflict {
-  /** Unique conflict identifier */
-  id: string
-  /** Path to the conflicted file */
-  path: string
-  /** Number of conflict markers */
-  numConflicts: number
-  /** Sides involved in the conflict */
-  sides: Array<string>
-  /** Conflict type (e.g., "content", "modify/delete") */
-  conflictType: string
-  /** Whether conflict is binary (non-text) */
-  isBinary: boolean
-  /** Whether conflict is resolved */
-  isResolved: boolean
-  /** Resolution strategy used (if resolved) */
-  resolutionStrategy?: string
-}
-/** Represents a diff between two commits */
-export interface JjDiff {
-  /** Files added */
-  added: Array<string>
-  /** Files modified */
-  modified: Array<string>
-  /** Files deleted */
-  deleted: Array<string>
-  /** Files renamed (serialized as "old_path:new_path") */
-  renamed: Array<string>
-  /** Total number of additions */
-  additions: number
-  /** Total number of deletions */
-  deletions: number
-  /** Diff content (unified diff format) */
-  content: string
-}
-/**
- * Working copy change
- *
- * Represents a change in the working copy that hasn't been committed yet.
- *
- * # Examples
- *
- * ```rust
- * use agentic_jujutsu::types::{JJChange, ChangeStatus};
- *
- * let change = JJChange::new("src/main.rs".to_string());
- * ```
- */
-export interface JjChange {
-  /** File path */
-  filePath: string
-  /** Change status */
-  status: ChangeStatus
-  /** Whether file is staged */
-  isStaged: boolean
-  /** Size in bytes (if applicable) - using f64 for N-API compatibility with large numbers */
-  sizeBytes?: number
-}
-/** Status of a file change */
-export const enum ChangeStatus {
-  /** File added */
-  Added = 'Added',
-  /** File modified */
-  Modified = 'Modified',
-  /** File deleted */
-  Deleted = 'Deleted',
-  /** File renamed (old path stored separately in JJChange) */
-  Renamed = 'Renamed',
-  /** File conflicted */
-  Conflicted = 'Conflicted',
-  /** File type changed */
-  TypeChanged = 'TypeChanged'
-}
-/**
- * Main quantum signing interface
- *
- * Provides methods for generating keypairs, signing commits, and verifying signatures
- * using ML-DSA-65 post-quantum cryptography.
- */
-export declare class QuantumSigner {
-  /**
-   * Generate a new ML-DSA-65 signing keypair
-   *
-   * This uses the @qudag/napi-core library to generate quantum-resistant keys.
-   *
-   * # Performance
-   *
-   * - Average: ~2.1ms
-   * - Uses secure random number generation
-   *
-   * # Returns
-   *
-   * A new `SigningKeypair` with ML-DSA-65 keys
-   *
-   * # Examples
-   *
-   * ```javascript
-   * const { QuantumSigner } = require('agentic-jujutsu');
-   * const keypair = QuantumSigner.generateKeypair();
-   * console.log('Key ID:', keypair.keyId);
-   * ```
-   */
-  static generateKeypair(): SigningKeypair
-  /**
-   * Sign a commit with ML-DSA-65 quantum-resistant signature
-   *
-   * Creates a cryptographic signature over the commit ID and optional metadata.
-   * The signature is tamper-proof and quantum-resistant.
-   *
-   * # Parameters
-   *
-   * - `commit_id`: The Jujutsu commit ID to sign
-   * - `secret_key`: Base64-encoded ML-DSA-65 secret key
-   * - `metadata`: Optional additional data to include in signature
-   *
-   * # Returns
-   *
-   * A `CommitSignature` containing the signature and metadata
-   *
-   * # Performance
-   *
-   * - Average: ~1.3ms per signature
-   *
-   * # Security
-   *
-   * - Uses deterministic signing (same input = same signature)
-   * - Includes timestamp to prevent replay attacks
-   * - Binds metadata to signature
-   *
-   * # Examples
-   *
-   * ```javascript
-   * const signature = QuantumSigner.signCommit(
-   *   'abc123',
-   *   keypair.secretKey,
-   *   { author: 'alice', repo: 'my-project' }
-   * );
-   * ```
-   */
-  static signCommit(commitId: string, secretKey: string, metadata?: Record<string, string> | undefined | null): CommitSignature
-  /**
-   * Verify a commit signature using ML-DSA-65
-   *
-   * Verifies that a signature is valid for the given commit and public key.
-   * Returns true if the signature is cryptographically valid and the commit
-   * has not been tampered with.
-   *
-   * # Parameters
-   *
-   * - `commit_id`: The commit ID that was signed
-   * - `signature_data`: The `CommitSignature` to verify
-   * - `public_key`: Base64-encoded ML-DSA-65 public key
-   *
-   * # Returns
-   *
-   * - `true`: Signature is valid
-   * - `false`: Signature is invalid or commit was tampered
-   *
-   * # Performance
-   *
-   * - Average: ~0.85ms per verification
-   *
-   * # Examples
-   *
-   * ```javascript
-   * const isValid = QuantumSigner.verifyCommit(
-   *   'abc123',
-   *   signature,
-   *   keypair.publicKey
-   * );
-   * if (!isValid) {
-   *   throw new Error('Commit signature verification failed!');
-   * }
-   * ```
-   */
-  static verifyCommit(commitId: string, signatureData: CommitSignature, publicKey: string): boolean
-  /**
-   * Export a public key in PEM format
-   *
-   * Converts a base64-encoded public key to PEM format for compatibility
-   * with other tools and systems.
-   *
-   * # Parameters
-   *
-   * - `public_key`: Base64-encoded ML-DSA-65 public key
-   *
-   * # Returns
-   *
-   * PEM-encoded public key string
-   */
-  static exportPublicKeyPem(publicKey: string): string
-  /**
-   * Import a public key from PEM format
-   *
-   * Parses a PEM-encoded ML-DSA-65 public key into base64 format.
-   *
-   * # Parameters
-   *
-   * - `pem`: PEM-encoded public key
-   *
-   * # Returns
-   *
-   * Base64-encoded public key
-   */
-  static importPublicKeyPem(pem: string): string
-  /**
-   * Get signature statistics
-   *
-   * Returns information about ML-DSA-65 algorithm characteristics.
-   *
-   * # Returns
-   *
-   * JSON string with algorithm statistics
-   */
-  static getAlgorithmInfo(): string
-}
-export type JJWrapper = JjWrapper
-/** Main wrapper for Jujutsu operations */
-export declare class JjWrapper {
-  /** Create a new JJWrapper with default configuration */
-  constructor()
-  /** Create a new JJWrapper with custom configuration */
-  static withConfig(config: JjConfig): JjWrapper
-  /** Get the current configuration */
-  getConfig(): JjConfig
-  /** Get operation log statistics as JSON string */
-  getStats(): string
-  /** Execute a jj command and return the result */
-  execute(args: Array<string>): Promise<JjResult>
-  /** Get operations from the operation log */
-  getOperations(limit: number): Array<JjOperation>
-  /** Get user-initiated operations (exclude snapshots) */
-  getUserOperations(limit: number): Array<JjOperation>
-  /** Get conflicts in the current commit or specified commit */
-  getConflicts(commit?: string | undefined | null): Promise<Array<JjConflict>>
-  /** Describe the current commit with a message */
-  describe(message: string): Promise<JjOperation>
-  /** Get repository status */
-  status(): Promise<JjResult>
-  /** Get diff between two commits */
-  diff(from: string, to: string): Promise<JjDiff>
-  /** Create a new commit (renamed from 'new' to avoid confusion with constructor) */
-  newCommit(message?: string | undefined | null): Promise<JjResult>
-  /** Edit a commit */
-  edit(revision: string): Promise<JjResult>
-  /** Abandon a commit */
-  abandon(revision: string): Promise<JjResult>
-  /** Squash commits */
-  squash(from?: string | undefined | null, to?: string | undefined | null): Promise<JjResult>
-  /** Rebase commits */
-  rebase(source: string, destination: string): Promise<JjResult>
-  /** Resolve conflicts */
-  resolve(path?: string | undefined | null): Promise<JjResult>
-  /** Create a branch */
-  branchCreate(name: string, revision?: string | undefined | null): Promise<JjResult>
-  /** Delete a branch */
-  branchDelete(name: string): Promise<JjResult>
-  /** List branches */
-  branchList(): Promise<Array<JjBranch>>
-  /** Undo the last operation */
-  undo(): Promise<JjResult>
-  /** Restore files */
-  restore(paths: Array<string>): Promise<JjResult>
-  /** Show commit log */
-  log(limit?: number | undefined | null): Promise<Array<JjCommit>>
-  /** Clear operation log */
-  clearLog(): void
-  /** Start a learning trajectory for a task */
-  startTrajectory(task: string): string
-  /** Add current operations to the active trajectory */
-  addToTrajectory(): void
-  /** Finalize trajectory with success score and store it */
-  finalizeTrajectory(successScore: number, critique?: string | undefined | null): void
-  /** Get decision suggestion from reasoning bank */
-  getSuggestion(task: string): string
-  /** Get learning statistics from reasoning bank */
-  getLearningStats(): string
-  /** Get all discovered patterns */
-  getPatterns(): string
-  /**
-   * Enable quantum-resistant encryption for ReasoningBank trajectory storage
-   *
-   * Uses HQC-128 encryption from @qudag/napi-core for quantum-resistant security
-   *
-   * # Arguments
-   * * `encryption_key` - Base64-encoded encryption key (32 bytes)
-   * * `public_key` - Optional base64-encoded public key for HQC
-   *
-   * # Example
-   * ```javascript
-   * const crypto = require('crypto');
-   * const encryptionKey = crypto.randomBytes(32).toString('base64');
-   * await wrapper.enableEncryption(encryptionKey);
-   * ```
-   */
-  enableEncryption(encryptionKey: string, publicKey?: string | undefined | null): void
-  /** Disable encryption for ReasoningBank */
-  disableEncryption(): void
-  /** Check if encryption is enabled */
-  isEncryptionEnabled(): boolean
-  /**
-   * Decrypt a trajectory by ID
-   *
-   * # Arguments
-   * * `trajectory_id` - UUID of the trajectory to decrypt
-   * * `decrypted_payload` - Decrypted JSON payload from HQC decryption
-   *
-   * # Returns
-   * JSON string of the decrypted trajectory
-   */
-  decryptTrajectory(trajectoryId: string, decryptedPayload: string): string
-  /**
-   * Get encrypted payload for a trajectory (for HQC encryption in JavaScript)
-   *
-   * Returns the plaintext payload that should be encrypted with HQC
-   */
-  getTrajectoryPayload(trajectoryId: string): string | null
-  /** Query similar trajectories by task */
-  queryTrajectories(task: string, limit: number): string
-  /** Reset reasoning bank (clear all learning) */
-  resetLearning(): void
-  /** Enable agent coordination with QuantumDAG */
-  enableAgentCoordination(): Promise<void>
-  /** Register a new agent in the coordination system */
-  registerAgent(agentId: string, agentType: string): Promise<void>
-  /** Register an agent operation in the coordination system */
-  registerAgentOperation(agentId: string, operationId: string, affectedFiles: Array<string>): Promise<string>
-  /** Check for conflicts with proposed operation */
-  checkAgentConflicts(operationId: string, operationType: string, affectedFiles: Array<string>): Promise<string>
-  /** Get agent statistics */
-  getAgentStats(agentId: string): Promise<string>
-  /** List all registered agents */
-  listAgents(): Promise<string>
-  /** Get coordination statistics */
-  getCoordinationStats(): Promise<string>
-  /** Get coordination tips (DAG tips) */
-  getCoordinationTips(): Promise<Array<string>>
-  /**
-   * Generate a quantum fingerprint for an operation
-   *
-   * This method generates a quantum-resistant fingerprint using @qudag/napi-core
-   * for fast integrity verification of JJ operations.
-   *
-   * # Arguments
-   * * `operation_id` - The ID of the operation to fingerprint
-   *
-   * # Returns
-   * The quantum fingerprint as a hex string
-   *
-   * # Example
-   * ```javascript
-   * const wrapper = new JJWrapper();
-   * const fingerprint = await wrapper.generateOperationFingerprint(operationId);
-   * ```
-   */
-  generateOperationFingerprint(operationId: string): Promise<string>
-  /**
-   * Verify an operation's quantum fingerprint
-   *
-   * Checks if the stored quantum fingerprint matches the current operation data.
-   *
-   * # Arguments
-   * * `operation_id` - The ID of the operation to verify
-   * * `fingerprint` - The expected fingerprint to verify against
-   *
-   * # Returns
-   * `true` if the fingerprint is valid, `false` otherwise
-   *
-   * # Example
-   * ```javascript
-   * const isValid = await wrapper.verifyOperationFingerprint(operationId, fingerprint);
-   * if (isValid) {
-   *   console.log('Operation integrity verified!');
-   * }
-   * ```
-   */
-  verifyOperationFingerprint(operationId: string, fingerprint: string): Promise<boolean>
-  /**
-   * Get operation data for quantum fingerprint generation (helper method)
-   *
-   * Returns the serialized operation data that should be fingerprinted.
-   * This is used by the JavaScript wrapper to call @qudag/napi-core.
-   *
-   * # Arguments
-   * * `operation_id` - The ID of the operation
-   *
-   * # Returns
-   * The operation data as a Buffer (Uint8Array in JS)
-   */
-  getOperationData(operationId: string): Array<number>
-  /**
-   * Update operation with quantum fingerprint
-   *
-   * Stores a quantum fingerprint for an operation.
-   *
-   * # Arguments
-   * * `operation_id` - The ID of the operation
-   * * `fingerprint` - The quantum fingerprint (hex string)
-   */
-  setOperationFingerprint(operationId: string, fingerprint: string): void
-  /**
-   * Sign an operation by ID
-   *
-   * Creates a quantum-resistant digital signature for the specified operation.
-   *
-   * # Arguments
-   *
-   * * `operation_id` - The operation ID to sign
-   * * `secret_key` - The secret key in hex format
-   * * `public_key` - The corresponding public key in hex format
-   */
-  signOperation(operationId: string, secretKey: string, publicKey: string): void
-  /**
-   * Verify an operation's signature by ID
-   *
-   * # Arguments
-   *
-   * * `operation_id` - The operation ID to verify
-   *
-   * # Returns
-   *
-   * `true` if signature is valid, `false` if invalid
-   */
-  verifyOperationSignature(operationId: string): boolean
-  /**
-   * Verify all operations in the log
-   *
-   * # Arguments
-   *
-   * * `public_key` - Optional public key to verify against
-   *
-   * # Returns
-   *
-   * JSON string with verification results: { total_signed, valid_count, invalid_count }
-   */
-  verifyAllOperations(publicKey?: string | undefined | null): string
-  /**
-   * Sign all unsigned operations
-   *
-   * # Arguments
-   *
-   * * `secret_key` - The secret key in hex format
-   * * `public_key` - The corresponding public key in hex format
-   *
-   * # Returns
-   *
-   * Number of operations that were signed
-   */
-  signAllOperations(secretKey: string, publicKey: string): number
-  /** Get count of signed operations */
-  getSignedOperationsCount(): number
-  /** Get count of unsigned operations */
-  getUnsignedOperationsCount(): number
-  /**
-   * Verify signature chain integrity
-   *
-   * Verifies that all signed operations form a valid chain.
-   *
-   * # Returns
-   *
-   * `true` if chain is valid, `false` if broken
-   */
-  verifySignatureChain(): boolean
-}