/**
 * The canonical atrib attribution record (§1.2).
 *
 * session_token is optional and MUST be omitted (not null, not undefined)
 * when absent. its presence changes the JCS canonical form and therefore
 * the signature.
 */
export type AtribRecord = {
    spec_version: 'atrib/1.0';
    content_id: string;
    creator_key: string;
    chain_root: string;
    event_type: string;
    context_id: string;
    timestamp: number;
    signature: string;
    /**
     * Optional reference to the record this annotation describes (D058 / spec
     * §1.2.8). Required when event_type is the atrib-normative annotation URI
     * and rejected on any other event_type per validators. Format
     * `sha256:<64-hex>`. JCS-canonical form sorts the field immediately after
     * `chain_root` and before `content_id` (a < c).
     */
    annotates?: string;
    /**
     * Optional commitment to the canonical args bytes per spec §8.3 (D061).
     * Format: `"sha256:" + 64 lowercase hex`. Absence indicates the §8.1
     * default posture (no args commitment surfaced; verifiers cannot
     * independently confirm what the agent claims to have sent). When present
     * without `args_salt`: plain-sha256(canonical_args_bytes). When present
     * with `args_salt`: salted-sha256(salt ‖ canonical_args_bytes). JCS-
     * canonical form sorts between `annotates` ("a-n") and `args_salt`
     * ("a-r-g-s-_-s") since "a-r-g-s-_-h" lies between them.
     */
    args_hash?: string;
    /**
     * Optional base64url-encoded random salt (≥16 bytes) revealing the salt used
     * to compute a `salted-sha256` `args_hash` per spec §8.3 (D045 salted-
     * commitment posture). Presence indicates the salted-commitment posture for
     * args; absence indicates the default plain-sha256 (or the hmac-sha256
     * variant which is indistinguishable to non-key-holders). JCS-canonical form
     * sorts the field between `args_hash` ("a-r-g-s-_-h") and `chain_root`
     * ("c") since "a-r-g-s-_-s" lies between them. Verifiers detect
     * `args_commitment_form` from this field's presence per spec §8.3.
     */
    args_salt?: string;
    /**
     * Optional commitment to the canonical result bytes per spec §8.3 (D061).
     * Same format and posture semantics as `args_hash` but for the tool's
     * response. JCS-canonical form sorts between `provenance_token` ("p") and
     * `result_salt` ("r-e-s-u-l-t-_-s") since "r-e-s-u-l-t-_-h" lies between
     * them.
     */
    result_hash?: string;
    /**
     * Optional base64url-encoded random salt (≥16 bytes) revealing the salt used
     * to compute a `salted-sha256` `result_hash` per spec §8.3 (D045 salted-
     * commitment posture). Same posture-detection semantics as `args_salt`.
     * JCS-canonical form sorts the field between `result_hash` ("r-e-s-u-l-t-
     * _-h") and `revises` ("r-e-v") since "r-e-s-u-l-t-_-s" lies between them.
     */
    result_salt?: string;
    /**
     * Optional tool-name disclosure per spec §8.2 (D061). Discloses the
     * verbatim or transformed tool name. Absence indicates the §8.1 default
     * posture (no tool-name disclosure beyond what content_id derives from
     * serverUrl + toolName). Three structural forms per §8.2: verbatim
     * (e.g. "book_flight"), opaque (matches `[a-z0-9_-]{1,64}`, indistinguishable
     * from verbatim by regex), or hashed (matches `^sha256:[0-9a-f]{64}$`,
     * unambiguous). JCS-canonical form places this field LAST in the current
     * schema: "t-o-..." sorts after "t-i-..." (timestamp_granularity) and after
     * "s-..." (signature, spec_version).
     */
    tool_name?: string;
    /**
     * Optional reference to the record this revision supersedes (D059 / spec
     * §1.2.9). Required when event_type is the atrib-normative revision URI
     * and rejected on any other event_type per validators. Format
     * `sha256:<64-hex>`. The current record asserts a position incompatible
     * with the prior one; not a content edit (records are immutable) but a
     * forward-pointing claim that future-self should weight this over the
     * referenced predecessor. JCS-canonical form sorts the field after
     * `provenance_token` and before `session_token` (p < r < s).
     */
    revises?: string;
    /**
     * Optional cross-record reference list (D041 / spec §1.2.7). Each entry
     * is the `sha256:<64-hex>` record_hash of a prior record this one was
     * informed by. JCS-canonical form sorts the field lexicographically
     * between `event_type` and `provenance_token`. Verifiers derive
     * INFORMED_BY graph edges from these (§3.2.4).
     */
    informed_by?: string[];
    /**
     * Optional cross-session causal anchor (D044 / spec §1.2.6).
     * 22-char base64url encoding of the first 16 bytes of an upstream record's
     * hash. Genesis-record-only: validators and verifiers MUST reject records
     * carrying this field when they are not the session's genesis record (the
     * record whose chain_root equals genesisChainRoot(context_id)). Middleware
     * (§5.3 / §5.4) SHOULD refuse to sign records that violate this constraint
     * per §5.8 graceful-degradation. JCS-canonical form sorts the field
     * lexicographically after `informed_by` and before `session_token` (i < p < s).
     */
    provenance_token?: string;
    /**
     * Optional timing-posture declaration (D045 / spec §8.4).
     * When present, the timestamp value MUST match the declared granularity's
     * trailing-zero pattern (e.g. `'min'` requires `timestamp % 60000 == 0`).
     * Default semantics when absent: 'ms'. JCS-canonical form sorts the field
     * lexicographically immediately after `timestamp` (`timestamp` is a prefix
     * of `timestamp_granularity`, so the shorter string sorts first).
     */
    timestamp_granularity?: 'ms' | 's' | 'min' | 'h' | 'd';
    /**
     * Cross-attestation signers for transaction records per spec §1.7.6
     * (D052). REQUIRED on `event_type = transaction` records; MUST NOT
     * appear on tool_call, observation, or extension records. Minimum 2
     * entries (typically agent + counterparty). Each signer covers the
     * SAME canonical bytes: the JCS serialization of the record with
     * `signers: []` (empty array) and the top-level `signature` field
     * omitted. JCS-canonical form sorts the field between `signature`
     * ("si-g-n-a-t-u-r-e") and `spec_version` since "si-g-n-e-r-s" >
     * "si-g-n-a-..." (position 4 'e' > 'a') and "si..." < "sp...".
     */
    signers?: SignerEntry[];
} & ({
    session_token: string;
} | {
    session_token?: never;
});
/**
 * One entry in the §1.7.6 transaction-record signers array. Each entry
 * carries a creator key (Ed25519 public, base64url) and that key's
 * signature over the cross-attestation canonical bytes.
 */
export interface SignerEntry {
    creator_key: string;
    signature: string;
}
/** An unsigned record. all fields except signature. */
export type UnsignedAtribRecord = Omit<AtribRecord, 'signature'>;
/** A decoded propagation token (spec 1.5.2). */
export interface DecodedToken {
    recordHash: Uint8Array;
    creatorKey: Uint8Array;
}
/**
 * atrib normative event_type URIs (spec 1.2.4).
 *
 * event_type is an absolute URI, not a closed enum. atrib publishes a small
 * canonical core vocabulary; consumers MAY mint extension URIs in their own
 * namespaces. See D035 for the URI-typing rationale and D036 for the bar to
 * promote an extension URI to atrib normative status.
 */
export declare const EVENT_TYPE_TOOL_CALL_URI = "https://atrib.dev/v1/types/tool_call";
export declare const EVENT_TYPE_TRANSACTION_URI = "https://atrib.dev/v1/types/transaction";
export declare const EVENT_TYPE_OBSERVATION_URI = "https://atrib.dev/v1/types/observation";
export declare const EVENT_TYPE_DIRECTORY_ANCHOR_URI = "https://atrib.dev/v1/types/directory_anchor";
export declare const EVENT_TYPE_ANNOTATION_URI = "https://atrib.dev/v1/types/annotation";
export declare const EVENT_TYPE_REVISION_URI = "https://atrib.dev/v1/types/revision";
/** Short aliases accepted by agent-facing tools for atrib normative event types. */
export declare const EVENT_TYPE_SHORT_NAMES: readonly ["tool_call", "transaction", "observation", "directory_anchor", "annotation", "revision"];
export type EventTypeShortName = (typeof EVENT_TYPE_SHORT_NAMES)[number];
/** Map from short aliases to canonical atrib normative event_type URIs. */
export declare const EVENT_TYPE_SHORT_TO_URI: Record<EventTypeShortName, string>;
/**
 * Agent-facing compatibility aliases for atrib's own normative event types.
 *
 * The spec URI is `https://atrib.dev/v1/types/{leaf}`. In live dogfood, agents
 * have also produced typo variants such as `https://atrib.dev/event/observation`
 * and `https://atrib.dev/events/observation`. Those are syntactically valid
 * extension URIs, but treating them as extensions makes observation records
 * disappear from normal event_type filters. Normalize only atrib.dev typo paths
 * whose final leaf is already in the normative vocabulary.
 */
export declare const EVENT_TYPE_ALIAS_TO_URI: Record<string, string>;
/** atrib normative event_type URI set (spec 1.2.4). */
export declare const NORMATIVE_EVENT_TYPE_URIS: Set<"https://atrib.dev/v1/types/tool_call" | "https://atrib.dev/v1/types/transaction" | "https://atrib.dev/v1/types/observation" | "https://atrib.dev/v1/types/directory_anchor" | "https://atrib.dev/v1/types/annotation" | "https://atrib.dev/v1/types/revision">;
/**
 * Normalize an atrib normative short alias to its canonical URI form.
 *
 * Unknown values are returned unchanged so callers can still pass extension
 * URIs through the spec-level `isValidEventTypeUri` validator.
 */
export declare function normalizeEventType(value: string): string;
/**
 * Validate an event_type URI per spec 1.4.5.
 *
 * Returns true iff the input is a syntactically-valid absolute URI suitable
 * for use as event_type. This does NOT check whether the URI is in atrib
 * normative set; an extension URI in a non-atrib namespace passes this check.
 */
export declare function isValidEventTypeUri(value: unknown): value is string;
/** True iff the URI is in atrib normative set. Recognition is informational only. */
export declare function isNormativeEventTypeUri(uri: string): boolean;
//# sourceMappingURL=types.d.ts.map