@heyanon-arp/sdk 0.0.23 → 0.0.24

package/dist/index.js

@@ -563,6 +563,19 @@ var InboxBlockScopes = {
   DID: "did"
 };
 
+// src/types/cli-auth.ts
+var CLI_LOGIN_SESSION_STORED_STATES = ["pending", "confirmed", "consumed"];
+var CLI_LOGIN_SESSION_STATES = ["pending", "confirmed", "consumed", "expired"];
+function isCliLoginSessionWireState(v) {
+  return typeof v === "string" && CLI_LOGIN_SESSION_STATES.includes(v);
+}
+var CliLoginSessionStates = {
+  PENDING: "pending",
+  CONFIRMED: "confirmed",
+  CONSUMED: "consumed",
+  EXPIRED: "expired"
+};
+
 // src/assets.ts
 var SOLANA_CLUSTER_IDS = {
   "solana-mainnet": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
@@ -943,9 +956,12 @@ exports.ASSOCIATED_TOKEN_PROGRAM_ID_BASE58 = ASSOCIATED_TOKEN_PROGRAM_ID_BASE58;
 exports.BODY_TYPES = BODY_TYPES;
 exports.BodyTypes = BodyTypes;
 exports.CAIP19_REGEX = CAIP19_REGEX;
+exports.CLI_LOGIN_SESSION_STATES = CLI_LOGIN_SESSION_STATES;
+exports.CLI_LOGIN_SESSION_STORED_STATES = CLI_LOGIN_SESSION_STORED_STATES;
 exports.CREATE_LOCK_DISCRIMINATOR = CREATE_LOCK_DISCRIMINATOR;
 exports.CREATE_LOCK_NATIVE_DISCRIMINATOR = CREATE_LOCK_NATIVE_DISCRIMINATOR;
 exports.CURRENT_PROTOCOL_VERSION = CURRENT_PROTOCOL_VERSION;
+exports.CliLoginSessionStates = CliLoginSessionStates;
 exports.DECIMAL_AMOUNT_REGEX = DECIMAL_AMOUNT_REGEX;
 exports.DECLINE_REASONS = DECLINE_REASONS;
 exports.DELEGATION_ACTIONS = DELEGATION_ACTIONS;
@@ -1026,6 +1042,7 @@ exports.getPublicKey = getPublicKey2;
 exports.instructionDiscriminator = instructionDiscriminator;
 exports.isAssetIdentifier = isAssetIdentifier;
 exports.isBodyType = isBodyType;
+exports.isCliLoginSessionWireState = isCliLoginSessionWireState;
 exports.isDecimalAmountString = isDecimalAmountString;
 exports.isDeclineReason = isDeclineReason;
 exports.isDelegationAction = isDelegationAction;

package/dist/index.mjs

@@ -538,6 +538,19 @@ var InboxBlockScopes = {
   DID: "did"
 };
 
+// src/types/cli-auth.ts
+var CLI_LOGIN_SESSION_STORED_STATES = ["pending", "confirmed", "consumed"];
+var CLI_LOGIN_SESSION_STATES = ["pending", "confirmed", "consumed", "expired"];
+function isCliLoginSessionWireState(v) {
+  return typeof v === "string" && CLI_LOGIN_SESSION_STATES.includes(v);
+}
+var CliLoginSessionStates = {
+  PENDING: "pending",
+  CONFIRMED: "confirmed",
+  CONSUMED: "consumed",
+  EXPIRED: "expired"
+};
+
 // src/assets.ts
 var SOLANA_CLUSTER_IDS = {
   "solana-mainnet": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
@@ -909,4 +922,4 @@ function isPostCommitErrorCode(code) {
   return POST_COMMIT_SET.has(code) || POST_COMMIT_ERROR_CODE_PREFIXES.some((p) => code.startsWith(p));
 }
 
-export { ASSET_DECIMALS_MAX, ASSET_DECIMALS_MIN, ASSET_SYMBOL_MAX_LEN, ASSET_SYMBOL_MIN_LEN, ASSET_WHITELIST, ASSOCIATED_TOKEN_PROGRAM_ID_BASE58, BODY_TYPES, BodyTypes, CAIP19_REGEX, CREATE_LOCK_DISCRIMINATOR, CREATE_LOCK_NATIVE_DISCRIMINATOR, CURRENT_PROTOCOL_VERSION, DECIMAL_AMOUNT_REGEX, DECLINE_REASONS, DELEGATION_ACTIONS, DELEGATION_ACTIVE_STATES, DELEGATION_STATES, DEVNET_MINTS, DISCOVERY_SORTS, DelegationActions, DelegationStates, DiscoverySorts, ED25519_SIG_PREFIX, ESCROW_PDA_SEEDS, ESCROW_PROGRAM_ID_BASE58, ESCROW_RELEASE_METHODS, EscrowReleaseMethods, HANDSHAKE_DECISIONS, HandshakeDecisions, INBOX_BLOCK_SCOPES, InboxBlockScopes, LIVE_RELATIONSHIP_STATE_NAMES, LOCK_ACCOUNT_DISCRIMINATOR, LOCK_ACCOUNT_SIZE, LOCK_STATE_NAMES, LOCK_TERMINAL_STATES, LockStates, LockTerminalStates, MAINNET_MINTS, MAX_CLOCK_SKEW_SECONDS, MAX_ENVELOPE_TTL_SECONDS, NATIVE_SOL_MINT_BASE58, NO_ARG_LIFECYCLE_INSTRUCTIONS, OWNER_SIGNING_METHODS, POST_COMMIT_ERROR_CODES, POST_COMMIT_ERROR_CODE_PREFIXES, PROTOCOL_VERSIONS, Purpose, READ_MODEL_STATUSES, RECEIPT_VERDICTS, RELATIONSHIP_STATE_NAMES, ReadModelStatuses, ReceiptVerdicts, RelationshipStates, SCRYPT_PARAMS, SHA256_HEX_RE, SLIP44_SOLANA, SOLANA_CLUSTER_IDS, SPL_TOKEN_PROGRAM_ID_BASE58, SYSTEM_PROGRAM_ID_BASE58, TOKEN_2022_PROGRAM_ID_BASE58, WELL_KNOWN_ASSETS, WELL_KNOWN_ASSET_KEYS, WORK_LOG_STATES, WorkLogStates, base58btcDecode, base58btcEncode, buildCreateLockIxData, buildLifecycleIxData, buildResolveDisputeIxData, bytes16ToDelegationId, canonicalBytes, canonicalJson, canonicalSha256Hex, computeCreateLockDiscriminator, computeLockAccountDiscriminator, decodeLockAccount, delegationIdToBytes16, deriveDelegationConditionHash, deriveLockId, deriveScryptKey, detectTokenProgramFromOwner, detectTokenProgramFromOwnerBytes, expiresAt, findAssetByAssetId, findFirstChainDivergence, formatDid, generateKeyPair, getPublicKey2 as getPublicKey, instructionDiscriminator, isAssetIdentifier, isBodyType, isDecimalAmountString, isDeclineReason, isDelegationAction, isDelegationState, isDiscoverySort, isEscrowReleaseMethod, isHandshakeDecision, isInboxBlockScope, isPostCommitErrorCode, isReadModelStatus, isReceiptVerdict, isRelationshipState, isSha256Hex, isValidDid, isWhitelistedAssetId, isWorkLogState, listWhitelistedAssets, parseCaip19SolanaAssetId, parseDid, pollUntil, resolveAsset, rfc3339, scryptPasswordProofSign, scryptPasswordProofVerify, senderNonce, serverEventHash, sign2 as sign, signChallenge, signEnvelope, signKeyLinkAttestation, signedMessageHash, uuidV4, verify2 as verify, verifyChallenge, verifyEnvelope, verifyKeyLinkAttestation };
+export { ASSET_DECIMALS_MAX, ASSET_DECIMALS_MIN, ASSET_SYMBOL_MAX_LEN, ASSET_SYMBOL_MIN_LEN, ASSET_WHITELIST, ASSOCIATED_TOKEN_PROGRAM_ID_BASE58, BODY_TYPES, BodyTypes, CAIP19_REGEX, CLI_LOGIN_SESSION_STATES, CLI_LOGIN_SESSION_STORED_STATES, CREATE_LOCK_DISCRIMINATOR, CREATE_LOCK_NATIVE_DISCRIMINATOR, CURRENT_PROTOCOL_VERSION, CliLoginSessionStates, DECIMAL_AMOUNT_REGEX, DECLINE_REASONS, DELEGATION_ACTIONS, DELEGATION_ACTIVE_STATES, DELEGATION_STATES, DEVNET_MINTS, DISCOVERY_SORTS, DelegationActions, DelegationStates, DiscoverySorts, ED25519_SIG_PREFIX, ESCROW_PDA_SEEDS, ESCROW_PROGRAM_ID_BASE58, ESCROW_RELEASE_METHODS, EscrowReleaseMethods, HANDSHAKE_DECISIONS, HandshakeDecisions, INBOX_BLOCK_SCOPES, InboxBlockScopes, LIVE_RELATIONSHIP_STATE_NAMES, LOCK_ACCOUNT_DISCRIMINATOR, LOCK_ACCOUNT_SIZE, LOCK_STATE_NAMES, LOCK_TERMINAL_STATES, LockStates, LockTerminalStates, MAINNET_MINTS, MAX_CLOCK_SKEW_SECONDS, MAX_ENVELOPE_TTL_SECONDS, NATIVE_SOL_MINT_BASE58, NO_ARG_LIFECYCLE_INSTRUCTIONS, OWNER_SIGNING_METHODS, POST_COMMIT_ERROR_CODES, POST_COMMIT_ERROR_CODE_PREFIXES, PROTOCOL_VERSIONS, Purpose, READ_MODEL_STATUSES, RECEIPT_VERDICTS, RELATIONSHIP_STATE_NAMES, ReadModelStatuses, ReceiptVerdicts, RelationshipStates, SCRYPT_PARAMS, SHA256_HEX_RE, SLIP44_SOLANA, SOLANA_CLUSTER_IDS, SPL_TOKEN_PROGRAM_ID_BASE58, SYSTEM_PROGRAM_ID_BASE58, TOKEN_2022_PROGRAM_ID_BASE58, WELL_KNOWN_ASSETS, WELL_KNOWN_ASSET_KEYS, WORK_LOG_STATES, WorkLogStates, base58btcDecode, base58btcEncode, buildCreateLockIxData, buildLifecycleIxData, buildResolveDisputeIxData, bytes16ToDelegationId, canonicalBytes, canonicalJson, canonicalSha256Hex, computeCreateLockDiscriminator, computeLockAccountDiscriminator, decodeLockAccount, delegationIdToBytes16, deriveDelegationConditionHash, deriveLockId, deriveScryptKey, detectTokenProgramFromOwner, detectTokenProgramFromOwnerBytes, expiresAt, findAssetByAssetId, findFirstChainDivergence, formatDid, generateKeyPair, getPublicKey2 as getPublicKey, instructionDiscriminator, isAssetIdentifier, isBodyType, isCliLoginSessionWireState, isDecimalAmountString, isDeclineReason, isDelegationAction, isDelegationState, isDiscoverySort, isEscrowReleaseMethod, isHandshakeDecision, isInboxBlockScope, isPostCommitErrorCode, isReadModelStatus, isReceiptVerdict, isRelationshipState, isSha256Hex, isValidDid, isWhitelistedAssetId, isWorkLogState, listWhitelistedAssets, parseCaip19SolanaAssetId, parseDid, pollUntil, resolveAsset, rfc3339, scryptPasswordProofSign, scryptPasswordProofVerify, senderNonce, serverEventHash, sign2 as sign, signChallenge, signEnvelope, signKeyLinkAttestation, signedMessageHash, uuidV4, verify2 as verify, verifyChallenge, verifyEnvelope, verifyKeyLinkAttestation };

package/dist/types/agent.d.ts

@@ -136,3 +136,26 @@ export interface AgentReputation {
     computed: boolean;
     lastComputedAt?: string | null;
 }
+/**
+ * Request body for `POST /v1/agents` (registration). The server DTO is
+ * `RegisterAgentDto`; `ownerAttestation` mirrors the SDK
+ * `ScryptPasswordAttestation<KeyLinkPayload>` wire shape but stays a
+ * generic object here — its inner fields are verified by canonical-JSON
+ * + HMAC at the server, not structurally.
+ */
+export interface RegisterAgentRequest {
+    challengeId: string;
+    identityPublicKey: string;
+    settlementPublicKey: string;
+    ownerAttestation: {
+        payload: Record<string, unknown>;
+        sig: string;
+        scrypt_salt_id: string;
+    };
+    scryptKeyB64: string;
+    scryptSaltB64: string;
+    name?: string;
+    description?: string;
+    /** Capability tags — lowercase alphanumeric + dash/underscore, max 20. */
+    tags?: string[];
+}

package/dist/types/cli-auth.d.ts

@@ -4,12 +4,36 @@
  * CLI's response types — both are plain framework-agnostic interfaces
  * (the server declares them in a service, not a NestJS DTO class), so
  * this is a pure lift-and-share with no decorator coupling.
+ */
+/**
+ * `heyarp login` session lifecycle. TWO tiers because the wire vocab is
+ * a strict superset of what's persisted:
+ *
+ *   - {@link CLI_LOGIN_SESSION_STORED_STATES} — what the server's Mongo
+ *     row actually holds (`@Prop enum`): `pending` → `confirmed` →
+ *     `consumed`.
+ *   - {@link CLI_LOGIN_SESSION_STATES} — what the `GET …/sessions/:id`
+ *     endpoint can RETURN. Adds `expired`, which the service COMPUTES on
+ *     read for a `pending` row past its TTL (and the CLI also derives
+ *     from a 404). `expired` is never stored.
  *
- * NOT included here: the cli-auth SESSION-STATE union
- * ('pending'|'confirmed'|'consumed'|...) — the CLI and server disagree
- * on the terminal members, so it needs reconciliation before it can be
- * centralized.
+ * Same `as const` array + union + guard + const-object shape as the
+ * protocol vocabularies; the server sources its `@Prop enum` from the
+ * stored array and types the read endpoint with the full wire union,
+ * and the CLI types its wire response from the full union.
  */
+export declare const CLI_LOGIN_SESSION_STORED_STATES: readonly ["pending", "confirmed", "consumed"];
+export type CliLoginSessionStoredState = (typeof CLI_LOGIN_SESSION_STORED_STATES)[number];
+export declare const CLI_LOGIN_SESSION_STATES: readonly ["pending", "confirmed", "consumed", "expired"];
+export type CliLoginSessionWireState = (typeof CLI_LOGIN_SESSION_STATES)[number];
+export declare function isCliLoginSessionWireState(v: unknown): v is CliLoginSessionWireState;
+/** Named-member accessor for {@link CliLoginSessionWireState} (vocab-tested). */
+export declare const CliLoginSessionStates: {
+    readonly PENDING: "pending";
+    readonly CONFIRMED: "confirmed";
+    readonly CONSUMED: "consumed";
+    readonly EXPIRED: "expired";
+};
 /** `POST /v1/auth/cli/sessions` → a new login session. */
 export interface CliSessionCreated {
     sessionId: string;

package/dist/types/discovery.d.ts

@@ -17,6 +17,30 @@ export declare const DiscoverySorts: {
     readonly RECENT: "recent";
     readonly CREATED: "created";
 };
+/**
+ * Query for `GET /v1/discovery/search` (server DTO
+ * `DiscoverySearchQueryDto`). Every field optional; filters AND-compose.
+ * Reputation is a SOFT sort, never a gate.
+ */
+export interface DiscoverySearchQuery {
+    /** Full-text over name + description. */
+    q?: string;
+    /** Capability tags — AND-require all. */
+    tag?: string[];
+    /** Creator wallet (base58) — you must already know it; never echoed back. */
+    accountId?: string;
+    /** CAIP-19 payment asset; matches explicit listers AND accept-anything agents. */
+    accepts?: string;
+    /** Only agents seen within the liveness window. */
+    online?: boolean;
+    /** `reputation` (composite desc, default) | `recent` | `created` (cursor). */
+    sort?: DiscoverySort;
+    /** Zero-based page index (offset = page × limit) — reputation/recent sorts. */
+    page?: number;
+    /** Cursor for `sort=created`: the previous page's last row id. */
+    after?: string;
+    limit?: number;
+}
 /** Reputation digest carried inline on each discovery row (the soft-sort key). */
 export interface DiscoveryReputation {
     composite: number;

package/dist/types/inbox.d.ts

@@ -31,3 +31,16 @@ export interface InboxBlock {
     /** When the block was set (ISO 8601). */
     blockedAt: string;
 }
+/**
+ * Body for `POST /v1/inbox/blocks` (server DTO `CreateInboxBlockDto`).
+ * You always NAME a DID; by default the server resolves its owner and
+ * blocks every sibling agent (account scope). The target account id is
+ * never returned.
+ */
+export interface BlockInboxBody {
+    did: string;
+    /** Block only this exact DID instead of the whole owner account. */
+    didOnly?: boolean;
+    /** Optional private note (max 512 chars). Visible only to you. */
+    reason?: string;
+}

package/dist/types/index.d.ts

@@ -10,12 +10,13 @@ export type { WorkLogState } from './work-log';
 export { WORK_LOG_STATES, WorkLogStates, isWorkLogState } from './work-log';
 export type { ReadModelStatus } from './event';
 export { READ_MODEL_STATUSES, ReadModelStatuses, isReadModelStatus } from './event';
-export type { DiscoverySort, DiscoveryReputation, DiscoveryLiveness, DiscoveryResult, DiscoveryPagination, DiscoverySearchResponse, DiscoveryProfile, } from './discovery';
+export type { DiscoverySort, DiscoverySearchQuery, DiscoveryReputation, DiscoveryLiveness, DiscoveryResult, DiscoveryPagination, DiscoverySearchResponse, DiscoveryProfile, } from './discovery';
 export { DISCOVERY_SORTS, DiscoverySorts, isDiscoverySort } from './discovery';
-export type { InboxBlockScope, InboxBlock } from './inbox';
+export type { InboxBlockScope, InboxBlock, BlockInboxBody } from './inbox';
 export { INBOX_BLOCK_SCOPES, InboxBlockScopes, isInboxBlockScope } from './inbox';
-export type { CliSessionCreated, CliTokenIssued, CliWhoami, MyAgentSummary } from './cli-auth';
+export type { CliSessionCreated, CliTokenIssued, CliWhoami, MyAgentSummary, CliLoginSessionStoredState, CliLoginSessionWireState, } from './cli-auth';
+export { CLI_LOGIN_SESSION_STORED_STATES, CLI_LOGIN_SESSION_STATES, CliLoginSessionStates, isCliLoginSessionWireState } from './cli-auth';
 export type { AssetIdentifierWire, DelegationPublic, ReceiptPublic, RelationshipPublic, WorkLogPublic, EventPublic, IngestResult } from './read-model';
-export type { AcceptPrefs, AcceptCurrency, AgentRegisteredResponse, AgentPublic, UpdateAgentBody, ReputationScores, ReputationCounters, AgentReputation, } from './agent';
+export type { AcceptPrefs, AcceptCurrency, AgentRegisteredResponse, AgentPublic, UpdateAgentBody, RegisterAgentRequest, ReputationScores, ReputationCounters, AgentReputation, } from './agent';
 export type { OwnerSigningMethod, KeyLinkPayload, ScryptPasswordAttestation } from './identity';
 export { SCRYPT_PARAMS, OWNER_SIGNING_METHODS } from './identity';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyanon-arp/sdk",
-  "version": "0.0.23",
+  "version": "0.0.24",
   "description": "TypeScript SDK for the Agent Relationship Protocol — canonical JSON, Ed25519 envelope sign/verify, did:arp identity, scrypt key attestation, chain-audit helpers.",
   "license": "MIT",
   "keywords": [