agent-protocols 0.1.0

package/README.md

@@ -0,0 +1,24 @@
+# agent-protocols TypeScript SDK
+
+TypeScript SDK for the draft Agent Identity, Agent Profile, and Agent Discourse protocols.
+
+## Modules
+
+- `identity`: `did:agent:` encoding, JCS canonicalization, event IDs, Ed25519 signing and verification, live-write nonce checks, request JWT helpers.
+- `profile`: `profile.update` payloads, Profile documents, validation, materialization.
+- `discourse`: ADP room payloads, roles, room states, protocol discovery, archive manifests, room-path checks, permission and state helpers.
+- `http-client`: fetch-based Profile and Discourse clients.
+
+## Example
+
+```ts
+import { AgentSigner, materializeProfile, profileUpdateEvent } from "agent-protocols";
+
+const signer = AgentSigner.generate();
+const event = profileUpdateEvent(signer.agentId(), Date.now(), "n_01J8Z6", {
+  agent_id: signer.agentId(),
+  name: "ResearchAgent-v3",
+});
+const envelope = signer.signEvent(event);
+const profile = materializeProfile(envelope);
+```

package/dist/discourse.d.ts

@@ -0,0 +1,236 @@
+import { AgentId, Envelope, Event } from "./identity.js";
+export declare const DISCOURSE_PROTOCOL = "agent-discourse/1.0";
+export declare const LEGACY_DISCOURSE_PROTOCOL = "adp/1.0";
+export declare const eventType: {
+    readonly ROOM_CREATE: "room.create";
+    readonly ROOM_JOIN: "room.join";
+    readonly ROOM_LEAVE: "room.leave";
+    readonly ROOM_MEMBER_ROLE_UPDATE: "room.member.role.update";
+    readonly ROOM_INVITE: "room.invite";
+    readonly ROOM_INVITE_REVOKE: "room.invite.revoke";
+    readonly ROOM_CLOSE: "room.close";
+    readonly ROOM_CANCEL: "room.cancel";
+    readonly MESSAGE_TEXT: "message.text";
+    readonly MESSAGE_MARKDOWN: "message.markdown";
+    readonly MESSAGE_DATA: "message.data";
+    readonly REACTION_CREATE: "reaction.create";
+    readonly PROPOSAL_CREATE: "proposal.create";
+    readonly POLL_CREATE: "poll.create";
+    readonly POLL_VOTE: "poll.vote";
+    readonly RESOLUTION_CREATE: "resolution.create";
+    readonly SOURCE_ADD: "source.add";
+    readonly TURN_UPDATE: "turn.update";
+    readonly QUESTION_GENERATE: "question.generate";
+    readonly DISCOURSE_STEER: "discourse.steer";
+    readonly MINDMAP_UPDATE: "mindmap.update";
+    readonly REPORT_GENERATE: "report.generate";
+    readonly SESSION_AUTH: "session.auth";
+};
+export type EventType = (typeof eventType)[keyof typeof eventType];
+export type RoomState = "scheduled" | "active" | "ended" | "cancelled";
+export type Visibility = "public" | "private" | "unlisted";
+export type DiscourseMode = "plain" | "collaborative" | "moderated";
+export type TurnPolicy = "free" | "round_robin" | "moderator_led";
+export type Role = "moderator" | "expert" | "participant" | "observer";
+export type MessageIntent = "question" | "answer" | "clarification" | "critique" | "synthesis" | "follow_up" | "other";
+export type MindmapOperation = "upsert_node" | "move_node" | "delete_node" | "merge_nodes" | "replace_snapshot" | "mark_resolved";
+export type MindmapNodeStatus = "open" | "resolved" | "closed";
+export interface RoomCreatePayload {
+    topic: string;
+    agenda?: string;
+    visibility: Visibility;
+    start_time: number;
+    end_time: number;
+    tags?: string[];
+    language?: string;
+    discourse_mode?: DiscourseMode;
+    turn_policy?: TurnPolicy;
+    mindmap_enabled?: boolean;
+    source_curation_enabled?: boolean;
+    reporting_enabled?: boolean;
+    moderator_agent_ids?: AgentId[];
+    max_participants?: number;
+    observer_allowed?: boolean;
+    observer_steering_allowed?: boolean;
+    participant_approval_required?: boolean;
+    observer_approval_required?: boolean;
+    profile_service?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RoomCreateResponse {
+    room_id: string;
+    status: RoomState;
+    created_event_id: string;
+    room_uri: string;
+}
+export interface RoomJoinPayload {
+    role: Role;
+    perspective?: string;
+    invite?: unknown;
+    webhook_url?: string;
+}
+export interface RoomLeavePayload {
+    reason?: string;
+}
+export interface RoleUpdatePayload {
+    member: AgentId;
+    role: Role;
+    reason?: string;
+}
+export interface RoomInvitePayload {
+    invitee?: AgentId;
+    role: Role;
+    expires_at: number;
+    max_uses?: number;
+    approval_required?: boolean;
+}
+export interface InviteRevokePayload {
+    invite_event_id: string;
+    reason?: string;
+}
+export interface MessagePayloadBase {
+    references?: string[];
+    intent?: MessageIntent;
+    turn_id?: string;
+    source_event_ids?: string[];
+}
+export interface MessageTextPayload extends MessagePayloadBase {
+    text: string;
+}
+export interface MessageMarkdownPayload extends MessagePayloadBase {
+    markdown: string;
+}
+export interface MessageDataPayload extends MessagePayloadBase {
+    content_type: string;
+    body: unknown;
+}
+export interface ReactionCreatePayload {
+    target_event_id: string;
+    reaction: string;
+    score?: number;
+}
+export interface SourceAddPayload {
+    source_type: string;
+    uri: string;
+    title?: string;
+    retrieved_at?: number;
+    content_digest?: string;
+    excerpt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TurnUpdatePayload {
+    turn_id: string;
+    speaker: AgentId;
+    intent?: MessageIntent;
+    topic?: string;
+    expires_at?: number;
+    reason?: string;
+}
+export interface QuestionGeneratePayload {
+    question: string;
+    target_perspectives?: string[];
+    basis?: string;
+    source_event_ids?: string[];
+    references?: string[];
+    priority?: number;
+}
+export interface DiscourseSteerPayload {
+    instruction: string;
+    target: string;
+    priority?: number;
+    references?: string[];
+}
+export interface MindmapNode {
+    id: string;
+    parent_id?: string;
+    title: string;
+    summary?: string;
+    status?: MindmapNodeStatus;
+    source_event_ids?: string[];
+    discussion_event_ids?: string[];
+    children?: MindmapNode[];
+    metadata?: Record<string, unknown>;
+}
+export interface MindmapUpdatePayload {
+    operation: MindmapOperation;
+    node?: MindmapNode;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface ReportGeneratePayload {
+    artifact_id: string;
+    format: string;
+    title: string;
+    uri: string;
+    content_digest?: string;
+    source_event_ids?: string[];
+    discussion_event_ids?: string[];
+    mindmap_event_id?: string;
+}
+export interface ServerRecord<P = unknown> {
+    room_id: string;
+    seq: number;
+    received_at: number;
+    envelope: Envelope<P>;
+}
+export interface ProfileResolverMetadata {
+    mode: string;
+    service?: string;
+    protocol?: string;
+}
+export interface DiscourseProtocolDiscovery {
+    protocol: string;
+    host: string;
+    features?: string[];
+    profile?: ProfileResolverMetadata;
+    endpoints?: Record<string, string>;
+}
+export interface ArtifactManifest {
+    artifact_id: string;
+    type: string;
+    format: string;
+    uri: string;
+    content_digest?: string;
+}
+export interface ArchiveManifest {
+    protocol: string;
+    type: "room.archive";
+    host: string;
+    room_id: string;
+    room_uri: string;
+    generated_at: number;
+    event_count: number;
+    first_seq: number;
+    last_seq: number;
+    events_sha256: string;
+    archive_root: string;
+    mindmap_snapshot?: {
+        event_id: string;
+        digest: string;
+    };
+    artifacts?: ArtifactManifest[];
+    discourse_trace_quality_score?: number;
+    formats?: Record<string, string>;
+}
+export interface PermissionContext {
+    role?: Role;
+    isCreator?: boolean;
+    moderatorAuthorized?: boolean;
+    expertPolicyAllowed?: boolean;
+    participantPolicyAllowed?: boolean;
+    observerSteeringAllowed?: boolean;
+    observerPollVoteAllowed?: boolean;
+}
+export interface StateWriteOptions {
+    postEndReactionAllowed?: boolean;
+}
+export declare function roomCreateEvent(actor: AgentId, createdAt: number, nonce: string, payload: RoomCreatePayload): Event<RoomCreatePayload>;
+export declare function discourseEvent<P>(type: string, actor: AgentId, createdAt: number, nonce: string, roomId: string, payload: P): Event<P>;
+export declare function validateDiscourseEnvelope(envelope: Envelope<unknown>, acceptLegacyProtocol?: boolean): void;
+export declare function validateRoomPath(envelope: Envelope<unknown>, pathRoomId: string): void;
+export declare function eventRequiresRoomId(type: string): boolean;
+export declare function canSubmitEvent(type: string, context: PermissionContext): boolean;
+export declare function canWriteInState(type: string, state: RoomState, options?: StateWriteOptions): boolean;
+export declare function canAcceptRoomWrite(type: string, state: RoomState, permission: PermissionContext, options?: StateWriteOptions): boolean;
+export declare function validateRoomWrite(type: string, state: RoomState, permission: PermissionContext, options?: StateWriteOptions): void;
+//# sourceMappingURL=discourse.d.ts.map

package/dist/discourse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discourse.d.ts","sourceRoot":"","sources":["../src/discourse.ts"],"names":[],"mappings":"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"}

package/dist/discourse.js

@@ -0,0 +1,163 @@
+import { protocolError } from "./errors.js";
+import { createEvent, verifyEnvelope, withRoomId, } from "./identity.js";
+export const DISCOURSE_PROTOCOL = "agent-discourse/1.0";
+export const LEGACY_DISCOURSE_PROTOCOL = "adp/1.0";
+export const eventType = {
+    ROOM_CREATE: "room.create",
+    ROOM_JOIN: "room.join",
+    ROOM_LEAVE: "room.leave",
+    ROOM_MEMBER_ROLE_UPDATE: "room.member.role.update",
+    ROOM_INVITE: "room.invite",
+    ROOM_INVITE_REVOKE: "room.invite.revoke",
+    ROOM_CLOSE: "room.close",
+    ROOM_CANCEL: "room.cancel",
+    MESSAGE_TEXT: "message.text",
+    MESSAGE_MARKDOWN: "message.markdown",
+    MESSAGE_DATA: "message.data",
+    REACTION_CREATE: "reaction.create",
+    PROPOSAL_CREATE: "proposal.create",
+    POLL_CREATE: "poll.create",
+    POLL_VOTE: "poll.vote",
+    RESOLUTION_CREATE: "resolution.create",
+    SOURCE_ADD: "source.add",
+    TURN_UPDATE: "turn.update",
+    QUESTION_GENERATE: "question.generate",
+    DISCOURSE_STEER: "discourse.steer",
+    MINDMAP_UPDATE: "mindmap.update",
+    REPORT_GENERATE: "report.generate",
+    SESSION_AUTH: "session.auth",
+};
+export function roomCreateEvent(actor, createdAt, nonce, payload) {
+    return createEvent(DISCOURSE_PROTOCOL, eventType.ROOM_CREATE, actor, createdAt, nonce, payload);
+}
+export function discourseEvent(type, actor, createdAt, nonce, roomId, payload) {
+    return withRoomId(createEvent(DISCOURSE_PROTOCOL, type, actor, createdAt, nonce, payload), roomId);
+}
+export function validateDiscourseEnvelope(envelope, acceptLegacyProtocol = false) {
+    verifyEnvelope(envelope);
+    const protocol = envelope.event.protocol;
+    const ok = protocol === DISCOURSE_PROTOCOL ||
+        (acceptLegacyProtocol && protocol === LEGACY_DISCOURSE_PROTOCOL);
+    if (!ok) {
+        throw protocolError("invalid_event_protocol", `expected ${DISCOURSE_PROTOCOL}, got ${protocol}`);
+    }
+    if (eventRequiresRoomId(envelope.event.type) &&
+        envelope.event.room_id === undefined) {
+        throw protocolError("missing_room_id", "event requires a room_id");
+    }
+}
+export function validateRoomPath(envelope, pathRoomId) {
+    const actual = envelope.event.room_id;
+    if (actual === undefined)
+        throw protocolError("missing_room_id", "event requires a room_id");
+    if (actual !== pathRoomId)
+        throw protocolError("room_id_mismatch", `expected ${pathRoomId}, got ${actual}`);
+}
+export function eventRequiresRoomId(type) {
+    return type !== eventType.ROOM_CREATE;
+}
+export function canSubmitEvent(type, context) {
+    if (type === eventType.ROOM_CREATE || type === eventType.ROOM_JOIN)
+        return true;
+    if (context.isCreator)
+        return isKnownEventType(type);
+    switch (context.role) {
+        case "moderator":
+            return moderatorCanSubmit(type, context.moderatorAuthorized ?? false);
+        case "expert":
+            return speakerCanSubmit(type, context.expertPolicyAllowed ?? false);
+        case "participant":
+            return speakerCanSubmit(type, context.participantPolicyAllowed ?? false);
+        case "observer":
+            return observerCanSubmit(type, context);
+        default:
+            return false;
+    }
+}
+export function canWriteInState(type, state, options = {}) {
+    switch (state) {
+        case "scheduled":
+            return eventTypeIn(type, [
+                eventType.ROOM_JOIN,
+                eventType.ROOM_INVITE,
+                eventType.ROOM_INVITE_REVOKE,
+                eventType.ROOM_CANCEL,
+            ]);
+        case "active":
+            return type !== eventType.ROOM_CREATE && type !== eventType.ROOM_CANCEL;
+        case "ended":
+            return (Boolean(options.postEndReactionAllowed) &&
+                type === eventType.REACTION_CREATE);
+        case "cancelled":
+            return false;
+    }
+}
+export function canAcceptRoomWrite(type, state, permission, options = {}) {
+    return (canSubmitEvent(type, permission) && canWriteInState(type, state, options));
+}
+export function validateRoomWrite(type, state, permission, options = {}) {
+    if (!canAcceptRoomWrite(type, state, permission, options)) {
+        throw protocolError("permission_denied", "actor lacks permission or state is not writable");
+    }
+}
+function moderatorCanSubmit(type, moderatorAuthorized) {
+    return (eventTypeIn(type, [
+        eventType.ROOM_INVITE,
+        eventType.ROOM_INVITE_REVOKE,
+        eventType.ROOM_CLOSE,
+        eventType.MESSAGE_TEXT,
+        eventType.MESSAGE_MARKDOWN,
+        eventType.MESSAGE_DATA,
+        eventType.SOURCE_ADD,
+        eventType.TURN_UPDATE,
+        eventType.QUESTION_GENERATE,
+        eventType.DISCOURSE_STEER,
+        eventType.MINDMAP_UPDATE,
+        eventType.REPORT_GENERATE,
+        eventType.PROPOSAL_CREATE,
+        eventType.POLL_CREATE,
+        eventType.POLL_VOTE,
+        eventType.RESOLUTION_CREATE,
+        eventType.REACTION_CREATE,
+        eventType.ROOM_LEAVE,
+    ]) ||
+        (moderatorAuthorized &&
+            eventTypeIn(type, [
+                eventType.ROOM_MEMBER_ROLE_UPDATE,
+                eventType.ROOM_CANCEL,
+            ])));
+}
+function speakerCanSubmit(type, policyAllowed) {
+    return (eventTypeIn(type, [
+        eventType.MESSAGE_TEXT,
+        eventType.MESSAGE_MARKDOWN,
+        eventType.MESSAGE_DATA,
+        eventType.SOURCE_ADD,
+        eventType.DISCOURSE_STEER,
+        eventType.PROPOSAL_CREATE,
+        eventType.POLL_CREATE,
+        eventType.POLL_VOTE,
+        eventType.REACTION_CREATE,
+        eventType.ROOM_LEAVE,
+    ]) ||
+        (policyAllowed &&
+            eventTypeIn(type, [
+                eventType.QUESTION_GENERATE,
+                eventType.MINDMAP_UPDATE,
+                eventType.REPORT_GENERATE,
+                eventType.RESOLUTION_CREATE,
+            ])));
+}
+function observerCanSubmit(type, context) {
+    return (eventTypeIn(type, [eventType.REACTION_CREATE, eventType.ROOM_LEAVE]) ||
+        (Boolean(context.observerSteeringAllowed) &&
+            type === eventType.DISCOURSE_STEER) ||
+        (Boolean(context.observerPollVoteAllowed) && type === eventType.POLL_VOTE));
+}
+function isKnownEventType(type) {
+    return eventTypeIn(type, Object.values(eventType));
+}
+function eventTypeIn(type, values) {
+    return values.includes(type);
+}
+//# sourceMappingURL=discourse.js.map

package/dist/discourse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discourse.js","sourceRoot":"","sources":["../src/discourse.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class AgentProtocolError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function protocolError(code: string, message: string): AgentProtocolError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,kBAAkB,CAEpB"}

package/dist/errors.js

@@ -0,0 +1,12 @@
+export class AgentProtocolError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "AgentProtocolError";
+    }
+}
+export function protocolError(code, message) {
+    return new AgentProtocolError(code, message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEzB;IADlB,YACkB,IAAY,EAC5B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QAI5B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,OAAe;IAEf,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/http-client.d.ts

@@ -0,0 +1,30 @@
+import { DiscourseProtocolDiscovery, RoomCreatePayload, RoomCreateResponse, RoomJoinPayload, RoomLeavePayload, ServerRecord } from "./discourse.js";
+import { AgentId, Envelope } from "./identity.js";
+import { AgentProfile, ProfileReadResponse, ProfileUpdatePayload } from "./profile.js";
+export type FetchLike = typeof fetch;
+export declare class ProfileClient {
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(baseUrl: string, fetchImpl?: FetchLike);
+    getProfile(agentId: AgentId): Promise<ProfileReadResponse>;
+    submitProfileUpdate(envelope: Envelope<ProfileUpdatePayload>): Promise<AgentProfile>;
+    private getJson;
+    private postJson;
+    private url;
+}
+export declare class DiscourseClient {
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(baseUrl: string, fetchImpl?: FetchLike);
+    protocol(): Promise<DiscourseProtocolDiscovery>;
+    createRoom(envelope: Envelope<RoomCreatePayload>): Promise<RoomCreateResponse>;
+    joinRoom(roomId: string, envelope: Envelope<RoomJoinPayload>): Promise<unknown>;
+    leaveRoom(roomId: string, envelope: Envelope<RoomLeavePayload>): Promise<unknown>;
+    submitEvent<P>(roomId: string, envelope: Envelope<P>): Promise<ServerRecord>;
+    events(roomId: string): Promise<ServerRecord[]>;
+    archive(roomId: string): Promise<unknown>;
+    private getJson;
+    private postJson;
+    private url;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,SAAiB;IAGzC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI1D,mBAAmB,CACvB,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACvC,OAAO,CAAC,YAAY,CAAC;YAIV,OAAO;YAKP,QAAQ;IAStB,OAAO,CAAC,GAAG;CAGZ;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,SAAiB;IAGzC,QAAQ,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAI/C,UAAU,CACd,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GACpC,OAAO,CAAC,kBAAkB,CAAC;IAIxB,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC;IAIb,SAAS,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACnC,OAAO,CAAC,OAAO,CAAC;IAIb,WAAW,CAAC,CAAC,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,YAAY,CAAC;IAIlB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI/C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAIjC,OAAO;YAKP,QAAQ;IAStB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/http-client.js

@@ -0,0 +1,81 @@
+export class ProfileClient {
+    baseUrl;
+    fetchImpl;
+    constructor(baseUrl, fetchImpl = fetch) {
+        this.baseUrl = baseUrl;
+        this.fetchImpl = fetchImpl;
+    }
+    async getProfile(agentId) {
+        return this.getJson(`/v1/profiles/${agentId}`);
+    }
+    async submitProfileUpdate(envelope) {
+        return this.postJson("/v1/profiles", envelope);
+    }
+    async getJson(path) {
+        const response = await this.fetchImpl(this.url(path));
+        return readJson(response);
+    }
+    async postJson(path, body) {
+        const response = await this.fetchImpl(this.url(path), {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        return readJson(response);
+    }
+    url(path) {
+        return `${this.baseUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+    }
+}
+export class DiscourseClient {
+    baseUrl;
+    fetchImpl;
+    constructor(baseUrl, fetchImpl = fetch) {
+        this.baseUrl = baseUrl;
+        this.fetchImpl = fetchImpl;
+    }
+    async protocol() {
+        return this.getJson("/v1/protocol");
+    }
+    async createRoom(envelope) {
+        return this.postJson("/v1/rooms", envelope);
+    }
+    async joinRoom(roomId, envelope) {
+        return this.postJson(`/v1/rooms/${roomId}/join`, envelope);
+    }
+    async leaveRoom(roomId, envelope) {
+        return this.postJson(`/v1/rooms/${roomId}/leave`, envelope);
+    }
+    async submitEvent(roomId, envelope) {
+        return this.postJson(`/v1/rooms/${roomId}/events`, envelope);
+    }
+    async events(roomId) {
+        return this.getJson(`/v1/rooms/${roomId}/events`);
+    }
+    async archive(roomId) {
+        return this.getJson(`/v1/rooms/${roomId}/archive`);
+    }
+    async getJson(path) {
+        const response = await this.fetchImpl(this.url(path));
+        return readJson(response);
+    }
+    async postJson(path, body) {
+        const response = await this.fetchImpl(this.url(path), {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        return readJson(response);
+    }
+    url(path) {
+        return `${this.baseUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+    }
+}
+async function readJson(response) {
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`HTTP ${response.status}: ${text}`);
+    }
+    return response.json();
+}
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"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"}

package/dist/identity.d.ts

@@ -0,0 +1,97 @@
+export declare const AGENT_ID_PREFIX = "did:agent:";
+export declare const EVENT_ID_PREFIX = "evt_";
+export declare const DEFAULT_LIVE_WRITE_WINDOW_MS = 300000;
+export declare const DEFAULT_REQUEST_JWT_TTL_SECS = 300;
+export type AgentId = string;
+export interface Event<P = unknown> {
+    protocol: string;
+    type: string;
+    actor: AgentId;
+    created_at: number;
+    nonce: string;
+    room_id?: string;
+    payload: P;
+    [key: string]: unknown;
+}
+export interface Envelope<P = unknown> {
+    event_id: string;
+    event: Event<P>;
+    signature: string;
+}
+export type NonceScopeKind = "actor_protocol" | "actor_room";
+export interface NonceScope {
+    actor: AgentId;
+    protocol: string;
+    room_id?: string;
+    nonce: string;
+}
+export interface NonceStore {
+    checkAndInsert(scope: NonceScope): void;
+}
+export interface LiveWriteOptions {
+    nowMs?: number;
+    windowMs?: number;
+    nonceScope?: NonceScopeKind;
+}
+export interface RequestJwtHeader {
+    alg: "EdDSA";
+    typ: "JWT";
+    kid: AgentId;
+}
+export interface RequestBinding {
+    audience: string;
+    method: string;
+    host: string;
+    path: string;
+}
+export interface RequestJwtClaims {
+    iss: AgentId;
+    sub: AgentId;
+    aud: string;
+    iat: number;
+    exp: number;
+    jti: string;
+    method: string;
+    host: string;
+    path: string;
+}
+export interface RequestAuthContext extends RequestBinding {
+    nowSecs?: number;
+    maxTtlSecs?: number;
+}
+export declare class AgentSigner {
+    private readonly keyPair;
+    private constructor();
+    static generate(): AgentSigner;
+    static fromSeed(seed: Uint8Array): AgentSigner;
+    agentId(): AgentId;
+    publicKey(): Uint8Array;
+    signEvent<P>(event: Event<P>): Envelope<P>;
+    signRequestJwt(claims: RequestJwtClaims): string;
+}
+export declare class MemoryNonceStore implements NonceStore {
+    private readonly seen;
+    checkAndInsert(scope: NonceScope): void;
+}
+export declare function createEvent<P>(protocol: string, type: string, actor: AgentId, createdAt: number, nonce: string, payload: P): Event<P>;
+export declare function withRoomId<P>(event: Event<P>, roomId: string): Event<P>;
+export declare function agentIdFromPublicKey(publicKey: Uint8Array): AgentId;
+export declare function publicKeyBytes(agentId: AgentId): Uint8Array;
+export declare function validateAgentId(agentId: AgentId): AgentId;
+export declare function canonicalEventBytes(event: Event<unknown>): Uint8Array;
+export declare function eventId(event: Event<unknown>): string;
+export declare function signEvent(secretKey: Uint8Array, event: Event<unknown>): string;
+export declare function verifyEventId(envelope: Envelope<unknown>): void;
+export declare function verifySignature(envelope: Envelope<unknown>): void;
+export declare function verifyEnvelope(envelope: Envelope<unknown>): void;
+export declare function verifyTimestamp(createdAt: number, nowMs: number, windowMs: number): void;
+export declare function nonceScopeForEvent(event: Event<unknown>, kind?: NonceScopeKind): NonceScope;
+export declare function verifyLiveEnvelope(envelope: Envelope<unknown>, nonceStore: NonceStore, options?: LiveWriteOptions): void;
+export declare function createRequestBinding(audience: string, method: string, host: string, path: string): RequestBinding;
+export declare function createRequestJwtClaims(agentId: AgentId, binding: RequestBinding, issuedAt: number, ttlSecs: number, jti: string): RequestJwtClaims;
+export declare function verifyRequestJwt(token: string, context: RequestAuthContext): RequestJwtClaims;
+export declare function verifyRequestJwtLive(token: string, context: RequestAuthContext, nonceStore: NonceStore): RequestJwtClaims;
+export declare function unixTimeMillis(): number;
+export declare function unixTimeSecs(): number;
+export declare function randomNonce(prefix?: string): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,eAAe,SAAS,CAAC;AACtC,eAAO,MAAM,4BAA4B,SAAU,CAAC;AACpD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAGhD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,WAAW,KAAK,CAAC,CAAC,GAAG,OAAO;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,KAAK,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAW;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO;IAA5C,OAAO;IAEP,MAAM,CAAC,QAAQ,IAAI,WAAW;IAI9B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW;IAU9C,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,UAAU;IAIvB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAQ1C,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;CAuBjD;AAED,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAE1C,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAexC;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,GACT,KAAK,CAAC,CAAC,CAAC,CAUV;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAKvE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAQnE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAkB3D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,UAAU,CASrE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAKrD;AAED,wBAAgB,SAAS,CACvB,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GACpB,MAAM,CAUR;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAQ/D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAgBjE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAGhE;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,IAAI,CAON;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EACrB,IAAI,GAAE,cAAiC,GACtC,UAAU,CAOZ;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC3B,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,gBAAqB,GAC7B,IAAI,CAUN;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,cAAc,CAOhB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,gBAAgB,CAYlB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,GAC1B,gBAAgB,CA+DlB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,UAAU,GACrB,gBAAgB,CAQlB;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,WAAW,CAAC,MAAM,SAAO,GAAG,MAAM,CAEjD"}

package/dist/identity.js

@@ -0,0 +1,257 @@
+import canonicalize from "canonicalize";
+import bs58 from "bs58";
+import { createHash, randomBytes } from "node:crypto";
+import nacl from "tweetnacl";
+import { protocolError } from "./errors.js";
+export const AGENT_ID_PREFIX = "did:agent:";
+export const EVENT_ID_PREFIX = "evt_";
+export const DEFAULT_LIVE_WRITE_WINDOW_MS = 300_000;
+export const DEFAULT_REQUEST_JWT_TTL_SECS = 300;
+const REQUEST_AUTH_REPLAY_SCOPE = "agent-identity/request-auth";
+export class AgentSigner {
+    keyPair;
+    constructor(keyPair) {
+        this.keyPair = keyPair;
+    }
+    static generate() {
+        return new AgentSigner(nacl.sign.keyPair());
+    }
+    static fromSeed(seed) {
+        if (seed.byteLength !== 32) {
+            throw protocolError("invalid_private_key", `seed must be 32 bytes, got ${seed.byteLength}`);
+        }
+        return new AgentSigner(nacl.sign.keyPair.fromSeed(seed));
+    }
+    agentId() {
+        return agentIdFromPublicKey(this.keyPair.publicKey);
+    }
+    publicKey() {
+        return new Uint8Array(this.keyPair.publicKey);
+    }
+    signEvent(event) {
+        return {
+            event_id: eventId(event),
+            event,
+            signature: signEvent(this.keyPair.secretKey, event),
+        };
+    }
+    signRequestJwt(claims) {
+        const agentId = this.agentId();
+        if (claims.iss !== agentId || claims.sub !== agentId) {
+            throw protocolError("invalid_jwt_claim", "iss and sub must match the signing agent id");
+        }
+        const header = { alg: "EdDSA", typ: "JWT", kid: agentId };
+        const encodedHeader = base64UrlEncode(new TextEncoder().encode(JSON.stringify(header)));
+        const encodedPayload = base64UrlEncode(new TextEncoder().encode(JSON.stringify(claims)));
+        const signingInput = `${encodedHeader}.${encodedPayload}`;
+        const signature = nacl.sign.detached(new TextEncoder().encode(signingInput), this.keyPair.secretKey);
+        return `${signingInput}.${base64UrlEncode(signature)}`;
+    }
+}
+export class MemoryNonceStore {
+    seen = new Set();
+    checkAndInsert(scope) {
+        const key = JSON.stringify([
+            scope.actor,
+            scope.protocol,
+            scope.room_id ?? null,
+            scope.nonce,
+        ]);
+        if (this.seen.has(key)) {
+            throw protocolError("nonce_reused", "nonce was already used in this replay scope");
+        }
+        this.seen.add(key);
+    }
+}
+export function createEvent(protocol, type, actor, createdAt, nonce, payload) {
+    validateAgentId(actor);
+    return {
+        protocol,
+        type,
+        actor,
+        created_at: createdAt,
+        nonce,
+        payload,
+    };
+}
+export function withRoomId(event, roomId) {
+    return {
+        ...event,
+        room_id: roomId,
+    };
+}
+export function agentIdFromPublicKey(publicKey) {
+    if (publicKey.byteLength !== 32) {
+        throw protocolError("invalid_public_key", `public key must be 32 bytes, got ${publicKey.byteLength}`);
+    }
+    return `${AGENT_ID_PREFIX}${base58BtcEncode(publicKey)}`;
+}
+export function publicKeyBytes(agentId) {
+    const encoded = agentId.startsWith(AGENT_ID_PREFIX)
+        ? agentId.slice(AGENT_ID_PREFIX.length)
+        : undefined;
+    if (!encoded) {
+        throw protocolError("invalid_agent_id", "agent id must start with did:agent:");
+    }
+    const bytes = base58BtcDecode(encoded);
+    if (bytes.byteLength !== 32) {
+        throw protocolError("invalid_public_key", `agent id public key must be 32 bytes, got ${bytes.byteLength}`);
+    }
+    return bytes;
+}
+export function validateAgentId(agentId) {
+    publicKeyBytes(agentId);
+    return agentId;
+}
+export function canonicalEventBytes(event) {
+    const canonical = canonicalize(event);
+    if (canonical === undefined) {
+        throw protocolError("canonical_json", "event cannot be represented as canonical JSON");
+    }
+    return new TextEncoder().encode(canonical);
+}
+export function eventId(event) {
+    const digest = createHash("sha256")
+        .update(canonicalEventBytes(event))
+        .digest();
+    return `${EVENT_ID_PREFIX}${base58BtcEncode(digest)}`;
+}
+export function signEvent(secretKey, event) {
+    if (secretKey.byteLength !== 64) {
+        throw protocolError("invalid_private_key", `secret key must be 64 bytes, got ${secretKey.byteLength}`);
+    }
+    return base64UrlEncode(nacl.sign.detached(canonicalEventBytes(event), secretKey));
+}
+export function verifyEventId(envelope) {
+    const expected = eventId(envelope.event);
+    if (expected !== envelope.event_id) {
+        throw protocolError("invalid_event_id", `invalid event id: expected ${expected}, got ${envelope.event_id}`);
+    }
+}
+export function verifySignature(envelope) {
+    const signature = base64UrlDecode(envelope.signature);
+    if (signature.byteLength !== 64) {
+        throw protocolError("invalid_signature", `signature must be 64 bytes, got ${signature.byteLength}`);
+    }
+    const ok = nacl.sign.detached.verify(canonicalEventBytes(envelope.event), signature, publicKeyBytes(envelope.event.actor));
+    if (!ok) {
+        throw protocolError("invalid_signature", "signature verification failed");
+    }
+}
+export function verifyEnvelope(envelope) {
+    verifyEventId(envelope);
+    verifySignature(envelope);
+}
+export function verifyTimestamp(createdAt, nowMs, windowMs) {
+    if (windowMs < 0 || Math.abs(createdAt - nowMs) > windowMs) {
+        throw protocolError("timestamp_out_of_window", "timestamp is outside the allowed live-write window");
+    }
+}
+export function nonceScopeForEvent(event, kind = "actor_protocol") {
+    return {
+        actor: event.actor,
+        protocol: event.protocol,
+        room_id: kind === "actor_room" ? event.room_id : undefined,
+        nonce: event.nonce,
+    };
+}
+export function verifyLiveEnvelope(envelope, nonceStore, options = {}) {
+    verifyEnvelope(envelope);
+    verifyTimestamp(envelope.event.created_at, options.nowMs ?? unixTimeMillis(), options.windowMs ?? DEFAULT_LIVE_WRITE_WINDOW_MS);
+    nonceStore.checkAndInsert(nonceScopeForEvent(envelope.event, options.nonceScope));
+}
+export function createRequestBinding(audience, method, host, path) {
+    return {
+        audience,
+        method: method.toUpperCase(),
+        host,
+        path,
+    };
+}
+export function createRequestJwtClaims(agentId, binding, issuedAt, ttlSecs, jti) {
+    return {
+        iss: agentId,
+        sub: agentId,
+        aud: binding.audience,
+        iat: issuedAt,
+        exp: issuedAt + ttlSecs,
+        jti,
+        method: binding.method.toUpperCase(),
+        host: binding.host,
+        path: binding.path,
+    };
+}
+export function verifyRequestJwt(token, context) {
+    const parts = token.split(".");
+    if (parts.length !== 3) {
+        throw protocolError("invalid_jwt", "expected three compact JWS parts");
+    }
+    const header = JSON.parse(new TextDecoder().decode(base64UrlDecode(parts[0])));
+    const claims = JSON.parse(new TextDecoder().decode(base64UrlDecode(parts[1])));
+    const signature = base64UrlDecode(parts[2]);
+    const signingInput = `${parts[0]}.${parts[1]}`;
+    if (header.alg !== "EdDSA") {
+        throw protocolError("invalid_jwt_claim", "alg must be EdDSA");
+    }
+    if (header.typ !== "JWT") {
+        throw protocolError("invalid_jwt_claim", "typ must be JWT");
+    }
+    if (header.kid !== claims.iss || claims.iss !== claims.sub) {
+        throw protocolError("invalid_jwt_claim", "kid, iss, and sub must identify the same Agent ID");
+    }
+    if (!nacl.sign.detached.verify(new TextEncoder().encode(signingInput), signature, publicKeyBytes(header.kid))) {
+        throw protocolError("invalid_signature", "JWT signature verification failed");
+    }
+    const method = context.method.toUpperCase();
+    if (claims.aud !== context.audience)
+        throw protocolError("invalid_jwt_claim", "aud mismatch");
+    if (claims.method !== method)
+        throw protocolError("invalid_jwt_claim", "method mismatch");
+    if (claims.host !== context.host)
+        throw protocolError("invalid_jwt_claim", "host mismatch");
+    if (claims.path !== context.path)
+        throw protocolError("invalid_jwt_claim", "path mismatch");
+    const nowSecs = context.nowSecs ?? unixTimeSecs();
+    const maxTtlSecs = context.maxTtlSecs ?? DEFAULT_REQUEST_JWT_TTL_SECS;
+    if (claims.iat > nowSecs || claims.exp < nowSecs) {
+        throw protocolError("invalid_jwt_claim", "iat/exp outside valid time window");
+    }
+    if (claims.exp - claims.iat > maxTtlSecs) {
+        throw protocolError("invalid_jwt_claim", "JWT ttl exceeds maximum");
+    }
+    return claims;
+}
+export function verifyRequestJwtLive(token, context, nonceStore) {
+    const claims = verifyRequestJwt(token, context);
+    nonceStore.checkAndInsert({
+        actor: claims.iss,
+        protocol: REQUEST_AUTH_REPLAY_SCOPE,
+        nonce: claims.jti,
+    });
+    return claims;
+}
+export function unixTimeMillis() {
+    return Date.now();
+}
+export function unixTimeSecs() {
+    return Math.floor(Date.now() / 1000);
+}
+export function randomNonce(prefix = "n_") {
+    return `${prefix}${base64UrlEncode(randomBytes(16))}`;
+}
+function base58BtcEncode(bytes) {
+    return `z${bs58.encode(bytes)}`;
+}
+function base58BtcDecode(value) {
+    if (!value.startsWith("z")) {
+        throw protocolError("invalid_encoding", "expected base58btc multibase value");
+    }
+    return bs58.decode(value.slice(1));
+}
+function base64UrlEncode(bytes) {
+    return Buffer.from(bytes).toString("base64url");
+}
+function base64UrlDecode(value) {
+    return new Uint8Array(Buffer.from(value, "base64url"));
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./errors.js";
+export * from "./identity.js";
+export * from "./profile.js";
+export * from "./discourse.js";
+export * from "./http-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./errors.js";
+export * from "./identity.js";
+export * from "./profile.js";
+export * from "./discourse.js";
+export * from "./http-client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/dist/profile.d.ts

@@ -0,0 +1,40 @@
+import { AgentId, Envelope, Event } from "./identity.js";
+export declare const PROFILE_PROTOCOL = "agent-profile/1.0";
+export declare const PROFILE_UPDATE = "profile.update";
+export interface ServiceEndpoint {
+    type: string;
+    url: string;
+    protocols?: string[];
+}
+export interface ProfileUpdatePayload {
+    agent_id: AgentId;
+    name: string;
+    description?: string;
+    avatar_url?: string;
+    provider?: string;
+    capabilities?: string[];
+    service_endpoints?: ServiceEndpoint[];
+    links?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentProfile extends ProfileUpdatePayload {
+    updated_at: number;
+    profile_event_id: string;
+}
+export interface ProfileReadResponse {
+    profile: AgentProfile;
+    profile_event?: Envelope<ProfileUpdatePayload>;
+}
+export interface ProfileServiceEndpoints {
+    profiles: string;
+}
+export interface ProfileServiceDiscovery {
+    protocol: string;
+    service: string;
+    endpoints: ProfileServiceEndpoints;
+    features?: string[];
+}
+export declare function profileUpdateEvent(actor: AgentId, createdAt: number, nonce: string, payload: ProfileUpdatePayload): Event<ProfileUpdatePayload>;
+export declare function validateProfileUpdate(envelope: Envelope<ProfileUpdatePayload>): void;
+export declare function materializeProfile(envelope: Envelope<ProfileUpdatePayload>): AgentProfile;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,QAAQ,EACR,KAAK,EAGN,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AACpD,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,CAAC,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,uBAAuB,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,GAC5B,KAAK,CAAC,oBAAoB,CAAC,CAS7B;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACvC,IAAI,CAoBN;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACvC,YAAY,CAgBd"}

package/dist/profile.js

@@ -0,0 +1,37 @@
+import { protocolError } from "./errors.js";
+import { createEvent, verifyEnvelope, } from "./identity.js";
+export const PROFILE_PROTOCOL = "agent-profile/1.0";
+export const PROFILE_UPDATE = "profile.update";
+export function profileUpdateEvent(actor, createdAt, nonce, payload) {
+    return createEvent(PROFILE_PROTOCOL, PROFILE_UPDATE, actor, createdAt, nonce, payload);
+}
+export function validateProfileUpdate(envelope) {
+    verifyEnvelope(envelope);
+    if (envelope.event.protocol !== PROFILE_PROTOCOL) {
+        throw protocolError("invalid_event_protocol", `expected ${PROFILE_PROTOCOL}, got ${envelope.event.protocol}`);
+    }
+    if (envelope.event.type !== PROFILE_UPDATE) {
+        throw protocolError("invalid_event_type", `expected ${PROFILE_UPDATE}, got ${envelope.event.type}`);
+    }
+    if (envelope.event.actor !== envelope.event.payload.agent_id) {
+        throw protocolError("invalid_actor", "profile update actor must match payload.agent_id");
+    }
+}
+export function materializeProfile(envelope) {
+    validateProfileUpdate(envelope);
+    const payload = envelope.event.payload;
+    return {
+        agent_id: payload.agent_id,
+        name: payload.name,
+        description: payload.description,
+        avatar_url: payload.avatar_url,
+        provider: payload.provider,
+        capabilities: payload.capabilities ?? [],
+        service_endpoints: payload.service_endpoints ?? [],
+        links: payload.links ?? {},
+        metadata: payload.metadata ?? {},
+        updated_at: envelope.event.created_at,
+        profile_event_id: envelope.event_id,
+    };
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAIL,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAyC/C,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,SAAiB,EACjB,KAAa,EACb,OAA6B;IAE7B,OAAO,WAAW,CAChB,gBAAgB,EAChB,cAAc,EACd,KAAK,EACL,SAAS,EACT,KAAK,EACL,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAwC;IAExC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QACjD,MAAM,aAAa,CACjB,wBAAwB,EACxB,YAAY,gBAAgB,SAAS,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAC3C,MAAM,aAAa,CACjB,oBAAoB,EACpB,YAAY,cAAc,SAAS,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7D,MAAM,aAAa,CACjB,eAAe,EACf,kDAAkD,CACnD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAwC;IAExC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;IACvC,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,EAAE;QAClD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU;QACrC,gBAAgB,EAAE,QAAQ,CAAC,QAAQ;KACpC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "agent-protocols",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Agent Identity, Agent Profile, and Agent Discourse protocols",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ldclabs/agent-protocols.git",
+    "directory": "packages/agent-protocols"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./identity": {
+      "types": "./dist/identity.d.ts",
+      "import": "./dist/identity.js"
+    },
+    "./profile": {
+      "types": "./dist/profile.d.ts",
+      "import": "./dist/profile.js"
+    },
+    "./discourse": {
+      "types": "./dist/discourse.d.ts",
+      "import": "./dist/discourse.js"
+    },
+    "./http-client": {
+      "types": "./dist/http-client.d.ts",
+      "import": "./dist/http-client.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --import tsx --test src/*.test.ts"
+  },
+  "dependencies": {
+    "bs58": "^6.0.0",
+    "canonicalize": "^3.0.0",
+    "tweetnacl": "^1.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.22.0",
+    "typescript": "^6.0.0"
+  }
+}