@atbash/sdk 0.9.0-dev.0 → 0.9.0

package/index.d.ts

@@ -1,55 +1,305 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+
+/**
+ * Which binding artifact the generated loader actually loaded: `'native'` for
+ * a native addon, otherwise the `platformArchABI` of the WASI flavor. Every
+ * flavor napi-rs can build is listed, because `NAPI_RS_NATIVE_LIBRARY_PATH`
+ * can point the loader at a WASI artifact this package does not build itself.
+ */
+export declare const __napiBindingTarget: 'native' | 'wasm32-wasi' | 'wasm32-wasip1'
+
+export interface AddAgentMemoryArgsJs {
+  agent_pubkey: Buffer
+  content_cipher: Buffer
+  nonce: Buffer
+  score: number
+  file_path: string
+}
+
+export interface AgentAuthJs {
+  privkey: string
+  pubkey: string
+}
+
+export interface AgentPubkeyOnlyQueryJs {
+  agent_pubkey_hex: string
+  file_path?: string
+}
+
+export declare const ARG_AGENT_PUBKEY: string
+
+export declare const ARG_FILE_PATH: string
+
+export declare const ARG_ID: string
+
+export declare function buildAddAgentMemoryArgs(agentPubkeyHex: string, contentCipher: Buffer, nonce: Buffer, score: number, filePath: string): AddAgentMemoryArgsJs
+
+export declare function buildEncryptedToolcallArgs(toolCallId: string, action: string, context: string, toolName: string, toolArgsJson: string, orgEncryptionPubKeyHex: string): EncryptedToolCallArgsJs
+
+export declare function buildGetActiveAgentMemoryQuery(agentPubkeyHex: string, filePath?: string | undefined | null): AgentPubkeyOnlyQueryJs
+
+export declare function buildGetActiveMemoryIdQuery(agentPubkeyHex: string, filePath?: string | undefined | null): AgentPubkeyOnlyQueryJs
+
+export declare function buildGetAgentMemoryByIdQuery(agentPubkeyHex: string, id: number): MemoryByIdQueryJs
+
+export declare function buildGetAgentMemoryHistoryQuery(agentPubkeyHex: string, filePath?: string | undefined | null): AgentPubkeyOnlyQueryJs
+
+export declare function buildGetAgentMemoryRollbackHistoryQuery(agentPubkeyHex: string, filePath?: string | undefined | null): AgentPubkeyOnlyQueryJs
+
+export declare function buildGetRecentAgentMemoryQuery(agentPubkeyHex: string, filePath?: string | undefined | null): AgentPubkeyOnlyQueryJs
+
+export declare function buildRollbackAgentMemoryArgs(agentPubkeyHex: string, toId: number, reason: string): RollbackAgentMemoryArgsJs
+
+export declare function buildScanRequest(entry: MemoryEntryJs): ScanRequestJs
+
+/**
+ * Named `claimHashHex` on the JS side to match the pure-TS name the
+ * dashboard's ported implementation uses.
+ */
+export declare function claimHashHex(toolName: string, action: string, context: string, toolArgsJson: string): string
+
+export declare function classifyMemoryRead(event: any, ctx: any, opts?: ClassifyReadOptionsJs | undefined | null): boolean
+
+export declare function classifyMemoryWrite(event: any, ctx: any, opts?: ClassifyWriteOptionsJs | undefined | null): MemoryEntryJs | null
+
+export interface ClassifyReadOptionsJs {
+  readToolNames?: Array<string>
+  patterns?: Array<string>
+  genericReadToolNames?: Array<string>
+}
+
+export interface ClassifyWriteOptionsJs {
+  patterns?: Array<string>
+  toolNames?: Array<string>
+}
+
+export declare function computeActionHash(action: string): string
+
 export declare function containsEvasionCharacters(s: string): boolean
 
 export declare function containsSecret(s: string): boolean
 
-export declare function createMemorySnapshot(entries: any, takenAt: number): any
+export declare function createMemorySnapshot(entries: Array<MemoryEntryJs>, takenAt: number): MemorySnapshotJs
+
+export declare function decryptForOrg(payload: Buffer, orgPrivKeyHex: string, aad: string, domain?: string | undefined | null): string
 
 export declare function decryptMemoryContent(ciphertext: Buffer, nonce: Buffer, key: Buffer): string
 
-export const DEFAULT_BLOCKCHAIN_RID: string
+export declare const DEFAULT_BLOCKCHAIN_RID: string
 
-export const DEFAULT_ENDPOINT: string
+export declare const DEFAULT_ENDPOINT: string
 
-export const DEFAULT_PRIVATE_BLOCKCHAIN_RID: string
+export declare const DEFAULT_PRIVATE_BLOCKCHAIN_RID: string
 
 export declare function defaultChromiaNodeUrls(): Array<string>
 
+export declare function defaultMemoryPathPatterns(): Array<string>
+
+export declare function defaultMemoryReadToolNames(): Array<string>
+
+export declare function defaultMemoryWriteToolNames(): Array<string>
+
 export declare function defaultPrivateNodeUrls(): Array<string>
 
+export declare function defaultScoreForVerdict(verdict: string): number
+
 export declare function deriveMemoryKey(privkeyHex: string): Buffer
 
 export declare function derivePublicKey(s: string): string
 
-export declare function diffMemorySnapshots(before: any, after: any): any
+export declare function diffMemorySnapshots(before: MemorySnapshotJs, after: MemorySnapshotJs): MemoryDiffResultJs
+
+export declare const ECIES_FORMAT_VERSION: number
+
+export declare function encryptedLength(plaintextByteLength: number): number
 
-/**
- * Encrypt UTF-8 plaintext with a 32-byte AES key. Returns
- * `{ ciphertext: Buffer, nonce: Buffer }` — ciphertext has the GCM
- * auth tag appended as the trailing 16 bytes.
- */
 export interface EncryptedMemoryJs {
   ciphertext: Buffer
   nonce: Buffer
 }
 
+/** Columns of `log_tool_call` — `tool_name` stays readable for filtering. */
+export interface EncryptedToolCallArgsJs {
+  tool_call_id: string
+  action_text: string
+  action_context: string
+  tool_name: string
+  tool_args_json: string
+}
+
+export declare function encryptForOrg(plaintext: string, orgPubKeyHex: string, aad: string, domain?: string | undefined | null): Buffer
+
 export declare function encryptMemoryContent(plaintext: string, key: Buffer): EncryptedMemoryJs
 
-export declare function generateKeypair(): any
+export declare function formatEntryForScan(entry: MemoryEntryJs, hasEvasion: boolean): string
 
-export const HONEYCOMB_KEY: string
+export declare function generateKeypair(): KeyPairJs
 
 export declare function isValidPrivateKey(s: string): boolean
 
-export declare function loadAgent(privkey: string): any
+export interface JudgeSignatureCheckJs {
+  ok: boolean
+  reason?: string
+}
+
+export interface KeyPairJs {
+  priv_key: string
+  pub_key: string
+}
+
+export declare function loadAgent(privkey: string): AgentAuthJs
+
+export declare function mapVerdict(actionType: string, confidence: number, threshold: number): string
+
+export interface MemoryAnomalyJs {
+  /**
+   * Anomaly kind — see `AnomalyType` in the core. Emitted as `type` in JS
+   * to match the serde `#[serde(rename = "type")]` on the core struct.
+   */
+  type: string
+  severity: string
+  description: string
+  entries: Array<string>
+}
+
+export interface MemoryByIdQueryJs {
+  agent_pubkey_hex: string
+  id: number
+}
+
+export interface MemoryDiffResultJs {
+  safe: boolean
+  added: Array<MemoryEntryJs>
+  removed: Array<MemoryEntryJs>
+  modified: Array<ModifiedEntryJs>
+  anomalies: Array<MemoryAnomalyJs>
+}
+
+export interface MemoryEntryJs {
+  key: string
+  value: string
+  source?: string
+  timestamp?: number
+}
+
+export declare function memoryScanContext(): string
+
+export interface MemorySnapshotJs {
+  entries: Array<MemoryEntryJs>
+  takenAt: number
+}
+
+export interface ModifiedEntryJs {
+  key: string
+  before: string
+  after: string
+}
+
+export declare function normalizeActionForHash(action: string): string
 
 export declare function normalizeForMatching(s: string): string
 
-export declare function redactSecrets(s: string): any
+export declare const OP_ADD_AGENT_MEMORY: string
+
+export declare const OP_LOG_TOOL_CALL: string
+
+export declare const OP_ROLLBACK_AGENT_MEMORY: string
+
+export declare function parseActiveMemoryId(value: any): number | null
+
+export declare function parseByteArrayField(value: any): Buffer
+
+export interface ParsedScoreJs {
+  score?: number
+  clean_reason: string
+}
+
+export declare function parseMemoryRow(value: any): RawMemoryRowJs
+
+export declare function parseMemoryRows(value: any): Array<RawMemoryRowJs>
+
+export declare function parseRollbackRow(value: any): RawRollbackRowJs
+
+export declare function parseRollbackRows(value: any): Array<RawRollbackRowJs>
+
+export declare function parseScoreFromReason(reason: string): ParsedScoreJs
+
+export declare const QUERY_GET_ACTIVE_AGENT_MEMORY: string
+
+export declare const QUERY_GET_ACTIVE_MEMORY_ID: string
+
+export declare const QUERY_GET_AGENT_MEMORY_BY_ID: string
+
+export declare const QUERY_GET_AGENT_MEMORY_HISTORY: string
+
+export declare const QUERY_GET_AGENT_MEMORY_ROLLBACK_HISTORY: string
+
+export declare const QUERY_GET_RECENT_AGENT_MEMORY: string
+
+export interface RawMemoryRowJs {
+  id: number
+  file_path: string
+  content_cipher: Buffer
+  nonce: Buffer
+  score: number
+  is_active: boolean
+  created_at: number
+  updated_at: number
+}
+
+export interface RawRollbackRowJs {
+  from_id: number
+  to_id: number
+  file_path: string
+  reason: string
+  signer: Buffer
+  created_at: number
+}
+
+export interface RedactResultJs {
+  redacted: string
+  found: Array<SecretMatchJs>
+}
+
+export declare function redactSecrets(s: string): RedactResultJs
+
+export interface RollbackAgentMemoryArgsJs {
+  agent_pubkey: Buffer
+  to_id: number
+  reason: string
+}
+
+export interface ScanRequestJs {
+  prompt: string
+  context: string
+  redaction: RedactResultJs
+  has_evasion: boolean
+}
+
+export interface SecretMatchJs {
+  kind: string
+  length: number
+}
+
+export declare function signEncryptedToolCall(toolCallId: string, action: string, context: string, toolName: string, toolArgsJson: string, orgEncryptionPubKeyHex: string, privkeyHex: string, blockchainRidHex: string): string
 
 export declare function signJudgeAction(judgmentId: string, action: string, context: string, extra: string, privkey: string, blockchainRid: string): string
 
 export declare function signLogToolCall(toolCallId: string, action: string, context: string, toolName: string, toolArgsJson: string, privkey: string, blockchainRid: string): string
 
+export declare function validateAgentPubkeyHex(pubkeyHex: string): Buffer
+
+export declare function validateFilePath(filePath: string): string
+
+export declare function validateMemoryId(id: number): void
+
+export declare function validateMemoryNonce(nonce: Buffer): void
+
+export declare function validateRollbackReason(reason: string): void
+
+export declare function validateScore(score: number): void
+
+export declare function verifyJudgeResponseSignature(body: Buffer, signatureHex: string | undefined | null, pubkeyHex: string): JudgeSignatureCheckJs
+
 export declare function verifySignature(body: Buffer, signatureHex: string, pubkeyHex: string): boolean