gbz185-sdk 0.1.0

package/dist/identity-code.js

@@ -0,0 +1,76 @@
+export const AGENT_IDENTITY_CODE_OID = "1.2.156.3088";
+export const CURRENT_IDENTITY_CODE_VERSION = "1";
+const NODE_RE = /^[0-9A-Z]+$/i;
+function validateNode(value, name, maxLength) {
+    if (!value || value.length > maxLength || !NODE_RE.test(value)) {
+        throw new Error(`${name} must be 1-${maxLength} base36 characters`);
+    }
+}
+export function formatIdentityCode(parts) {
+    const normalized = {
+        oid: parts.oid ?? AGENT_IDENTITY_CODE_OID,
+        version: parts.version ?? CURRENT_IDENTITY_CODE_VERSION,
+        registrationServiceProvider: parts.registrationServiceProvider.toUpperCase(),
+        registrationRequester: parts.registrationRequester.toUpperCase(),
+        ontologySerial: parts.ontologySerial.toUpperCase(),
+        instanceSerial: parts.instanceSerial.toUpperCase()
+    };
+    validateIdentityCodeParts(normalized);
+    return [
+        normalized.oid,
+        normalized.version,
+        normalized.registrationServiceProvider,
+        normalized.registrationRequester,
+        normalized.ontologySerial,
+        normalized.instanceSerial
+    ].join(".");
+}
+export function parseIdentityCode(code) {
+    const segments = code.split(".");
+    if (segments.length !== 9) {
+        throw new Error("Agent identity code must contain 9 dot-separated segments");
+    }
+    const oid = segments.slice(0, 4).join(".");
+    if (oid !== AGENT_IDENTITY_CODE_OID) {
+        throw new Error(`Unsupported agent identity code OID: ${oid}`);
+    }
+    const [version, registrationServiceProvider, registrationRequester, ontologySerial, instanceSerial] = segments.slice(4);
+    if (!version || version !== CURRENT_IDENTITY_CODE_VERSION) {
+        throw new Error(`Unsupported agent identity code version: ${version ?? ""}`);
+    }
+    if (!registrationServiceProvider || !registrationRequester || !ontologySerial || !instanceSerial) {
+        throw new Error("Agent identity code is missing one or more required nodes");
+    }
+    const parts = {
+        oid: AGENT_IDENTITY_CODE_OID,
+        version: CURRENT_IDENTITY_CODE_VERSION,
+        registrationServiceProvider: registrationServiceProvider.toUpperCase(),
+        registrationRequester: registrationRequester.toUpperCase(),
+        ontologySerial: ontologySerial.toUpperCase(),
+        instanceSerial: instanceSerial.toUpperCase()
+    };
+    validateIdentityCodeParts(parts);
+    return parts;
+}
+export function validateIdentityCode(code) {
+    try {
+        parseIdentityCode(code);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function validateIdentityCodeParts(parts) {
+    if (parts.oid !== AGENT_IDENTITY_CODE_OID) {
+        throw new Error(`Agent identity code OID must be ${AGENT_IDENTITY_CODE_OID}`);
+    }
+    if (parts.version !== CURRENT_IDENTITY_CODE_VERSION) {
+        throw new Error(`Agent identity code version must be ${CURRENT_IDENTITY_CODE_VERSION}`);
+    }
+    validateNode(parts.registrationServiceProvider, "registrationServiceProvider", 6);
+    validateNode(parts.registrationRequester, "registrationRequester", 6);
+    validateNode(parts.ontologySerial, "ontologySerial", 9);
+    validateNode(parts.instanceSerial, "instanceSerial", 9);
+}
+//# sourceMappingURL=identity-code.js.map

package/dist/identity-code.js.map

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

package/dist/identity-registry.d.ts

@@ -0,0 +1,68 @@
+import type { CredentialIssuer, IssuedCredential } from "./credentials.js";
+import type { AgentDescription, AgentIdentityCode, JsonObject } from "./types.js";
+export type IdentityAccountStatus = "active" | "locked" | "revoked";
+export interface IdentityAccount {
+    id: AgentIdentityCode;
+    delegatorId: string;
+    subject: string;
+    description?: Partial<AgentDescription> | undefined;
+    status: IdentityAccountStatus;
+    credentialIds: string[];
+    evidence?: JsonObject[] | undefined;
+    auditLog?: IdentityAuditEvent[] | undefined;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface IdentityAuditEvent {
+    eventId: string;
+    type: "registered" | "updated" | "locked" | "unlocked" | "revoked" | "credential_issued";
+    actor?: string | undefined;
+    reason?: string | undefined;
+    createdAt: string;
+    metadata?: JsonObject | undefined;
+}
+export interface RegisterIdentityInput {
+    delegatorId: string;
+    subject: string;
+    registrationServiceProvider: string;
+    registrationRequester: string;
+    ontologySerial?: string | undefined;
+    instanceSerial?: string | undefined;
+    description?: Partial<AgentDescription> | undefined;
+    evidence?: JsonObject[] | undefined;
+    issueCredential?: boolean | undefined;
+    credentialAudience?: string[] | undefined;
+    credentialScope?: string[] | undefined;
+}
+export interface RegisterIdentityResult {
+    account: IdentityAccount;
+    issuedCredential?: IssuedCredential | undefined;
+}
+export interface IdentityAccountStore {
+    save(account: IdentityAccount): Promise<void>;
+    get(agentId: AgentIdentityCode): Promise<IdentityAccount | undefined>;
+    list(): Promise<IdentityAccount[]>;
+}
+export declare class InMemoryIdentityAccountStore implements IdentityAccountStore {
+    private accounts;
+    save(account: IdentityAccount): Promise<void>;
+    get(agentId: AgentIdentityCode): Promise<IdentityAccount | undefined>;
+    list(): Promise<IdentityAccount[]>;
+}
+export declare class IdentityRegistryRuntime {
+    private readonly store;
+    private readonly credentialIssuer?;
+    constructor(store?: IdentityAccountStore, credentialIssuer?: CredentialIssuer | undefined);
+    register(input: RegisterIdentityInput): Promise<RegisterIdentityResult>;
+    update(agentId: AgentIdentityCode, patch: Partial<Pick<IdentityAccount, "description" | "evidence">>): Promise<IdentityAccount>;
+    issueCredential(agentId: AgentIdentityCode, input: Omit<Parameters<CredentialIssuer["issueCredential"]>[0], "agentId">): Promise<IssuedCredential>;
+    lock(agentId: AgentIdentityCode, reason?: string): Promise<IdentityAccount>;
+    unlock(agentId: AgentIdentityCode, reason?: string): Promise<IdentityAccount>;
+    revoke(agentId: AgentIdentityCode, reason?: string): Promise<IdentityAccount>;
+    get(agentId: AgentIdentityCode): Promise<IdentityAccount | undefined>;
+    list(): Promise<IdentityAccount[]>;
+    private setStatus;
+    private applyCredentialStatus;
+    private requireAccount;
+}
+//# sourceMappingURL=identity-registry.d.ts.map

package/dist/identity-registry.d.ts.map

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

package/dist/identity-registry.js

@@ -0,0 +1,155 @@
+import { randomUUID } from "node:crypto";
+import { formatIdentityCode } from "./identity-code.js";
+export class InMemoryIdentityAccountStore {
+    accounts = new Map();
+    async save(account) {
+        this.accounts.set(account.id, account);
+    }
+    async get(agentId) {
+        return this.accounts.get(agentId);
+    }
+    async list() {
+        return [...this.accounts.values()];
+    }
+}
+export class IdentityRegistryRuntime {
+    store;
+    credentialIssuer;
+    constructor(store = new InMemoryIdentityAccountStore(), credentialIssuer) {
+        this.store = store;
+        this.credentialIssuer = credentialIssuer;
+    }
+    async register(input) {
+        const now = new Date().toISOString();
+        const agentId = formatIdentityCode({
+            registrationServiceProvider: input.registrationServiceProvider,
+            registrationRequester: input.registrationRequester,
+            ontologySerial: input.ontologySerial ?? randomNode(8),
+            instanceSerial: input.instanceSerial ?? "0"
+        });
+        const account = {
+            id: agentId,
+            delegatorId: input.delegatorId,
+            subject: input.subject,
+            description: input.description,
+            status: "active",
+            credentialIds: [],
+            evidence: input.evidence,
+            auditLog: [audit("registered", "identity-registry", "identity account registered")],
+            createdAt: now,
+            updatedAt: now
+        };
+        let issuedCredential;
+        if (input.issueCredential && this.credentialIssuer) {
+            issuedCredential = await this.credentialIssuer.issueCredential({
+                agentId,
+                subject: input.subject,
+                audience: input.credentialAudience,
+                scope: input.credentialScope,
+                metadata: { delegatorId: input.delegatorId }
+            });
+            account.credentialIds.push(issuedCredential.credential.credentialId);
+            account.auditLog?.push(audit("credential_issued", "identity-registry", "initial credential issued"));
+        }
+        await this.store.save(account);
+        return { account, issuedCredential };
+    }
+    async update(agentId, patch) {
+        const account = await this.requireAccount(agentId);
+        const updated = {
+            ...account,
+            ...patch,
+            auditLog: [...(account.auditLog ?? []), audit("updated", "identity-registry", "identity account updated")],
+            updatedAt: new Date().toISOString()
+        };
+        await this.store.save(updated);
+        return updated;
+    }
+    async issueCredential(agentId, input) {
+        if (!this.credentialIssuer) {
+            throw new Error("No credential issuer configured");
+        }
+        const account = await this.requireAccount(agentId);
+        if (account.status !== "active") {
+            throw new Error(`Cannot issue credential for ${account.status} identity account`);
+        }
+        const issued = await this.credentialIssuer.issueCredential({ ...input, agentId });
+        const updated = {
+            ...account,
+            credentialIds: [...account.credentialIds, issued.credential.credentialId],
+            auditLog: [...(account.auditLog ?? []), audit("credential_issued", "identity-registry", "credential issued")],
+            updatedAt: new Date().toISOString()
+        };
+        await this.store.save(updated);
+        return issued;
+    }
+    async lock(agentId, reason) {
+        const account = await this.setStatus(agentId, "locked", reason);
+        await this.applyCredentialStatus(account, "lock", reason);
+        return account;
+    }
+    async unlock(agentId, reason) {
+        const account = await this.setStatus(agentId, "active", reason);
+        await this.applyCredentialStatus(account, "unlock", reason);
+        return account;
+    }
+    async revoke(agentId, reason) {
+        const account = await this.setStatus(agentId, "revoked", reason);
+        await this.applyCredentialStatus(account, "revoke", reason);
+        return account;
+    }
+    async get(agentId) {
+        return this.store.get(agentId);
+    }
+    async list() {
+        return this.store.list();
+    }
+    async setStatus(agentId, status, reason) {
+        const account = await this.requireAccount(agentId);
+        const eventType = status === "active" ? "unlocked" : status;
+        const updated = {
+            ...account,
+            status,
+            auditLog: [...(account.auditLog ?? []), audit(eventType, "identity-registry", reason)],
+            updatedAt: new Date().toISOString()
+        };
+        await this.store.save(updated);
+        return updated;
+    }
+    async applyCredentialStatus(account, action, reason) {
+        if (!this.credentialIssuer) {
+            return;
+        }
+        for (const credentialId of account.credentialIds) {
+            if (action === "lock") {
+                await this.credentialIssuer.lockCredential(credentialId, reason);
+            }
+            else if (action === "unlock") {
+                await this.credentialIssuer.unlockCredential(credentialId, reason);
+            }
+            else {
+                await this.credentialIssuer.revokeCredential(credentialId, reason);
+            }
+        }
+    }
+    async requireAccount(agentId) {
+        const account = await this.store.get(agentId);
+        if (!account) {
+            throw new Error(`Identity account not found: ${agentId}`);
+        }
+        return account;
+    }
+}
+function audit(type, actor, reason) {
+    return {
+        eventId: randomUUID(),
+        type,
+        actor,
+        reason,
+        createdAt: new Date().toISOString()
+    };
+}
+function randomNode(length) {
+    return randomUUID().replaceAll("-", "").slice(0, length).toUpperCase();
+}
+//# sourceMappingURL=identity-registry.js.map

package/dist/identity-registry.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export * from "./agent-maintenance.js";
+export * from "./authorization.js";
+export * from "./client.js";
+export * from "./conformance.js";
+export * from "./credentials.js";
+export * from "./description-registry.js";
+export * from "./discovery.js";
+export * from "./factory.js";
+export * from "./functional-architecture.js";
+export * from "./identity-code.js";
+export * from "./identity-registry.js";
+export * from "./interaction.js";
+export * from "./message-distribution.js";
+export * from "./tool-access.js";
+export * from "./tools.js";
+export * from "./transport.js";
+export * from "./types.js";
+export * from "./validation.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,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+export * from "./agent-maintenance.js";
+export * from "./authorization.js";
+export * from "./client.js";
+export * from "./conformance.js";
+export * from "./credentials.js";
+export * from "./description-registry.js";
+export * from "./discovery.js";
+export * from "./factory.js";
+export * from "./functional-architecture.js";
+export * from "./identity-code.js";
+export * from "./identity-registry.js";
+export * from "./interaction.js";
+export * from "./message-distribution.js";
+export * from "./tool-access.js";
+export * from "./tools.js";
+export * from "./transport.js";
+export * from "./types.js";
+export * from "./validation.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,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/interaction.d.ts

@@ -0,0 +1,41 @@
+import type { AgentIdentityCode, AgentInteractionMode, DataItem, Message, Session, SessionReceiver, Task, TaskState } from "./types.js";
+export interface CreateSessionInput {
+    mode: AgentInteractionMode;
+    sender: {
+        agentId: AgentIdentityCode;
+        accessAddress?: string | undefined;
+    };
+    receivers: SessionReceiver[];
+    context?: Array<Message | Task> | undefined;
+}
+export interface SubmitTaskInput {
+    sessionId: string;
+    initialMessages?: Message[] | undefined;
+    artifacts?: Array<Message | Task> | undefined;
+}
+export interface SendMessageInput {
+    senderRole: Message["senderRole"];
+    senderId: AgentIdentityCode;
+    sessionId: string;
+    taskId?: string | undefined;
+    artifact?: Message["artifact"] | undefined;
+    final?: boolean | undefined;
+    chunkIndex?: number | undefined;
+    lastChunk?: boolean | undefined;
+    dataItems: DataItem[];
+}
+export declare class InteractionRuntime {
+    private sessions;
+    private tasks;
+    private messages;
+    createSession(input: CreateSessionInput): Promise<Session>;
+    submitTask(input: SubmitTaskInput): Promise<Task>;
+    updateTaskState(taskId: string, state: TaskState): Promise<Task>;
+    sendMessage(input: SendMessageInput): Promise<Message>;
+    listMessages(sessionId: string): Promise<Message[]>;
+    getSession(sessionId: string): Promise<Session | undefined>;
+    getTask(taskId: string): Promise<Task | undefined>;
+    private requireSession;
+    private requireTask;
+}
+//# sourceMappingURL=interaction.d.ts.map

package/dist/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../src/interaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExI,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE;QACN,OAAO,EAAE,iBAAiB,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACpC,CAAC;IACF,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAClC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAgC;IAE1C,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1D,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BtD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAKnD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAI3D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAIxD,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/interaction.js

@@ -0,0 +1,95 @@
+import { randomUUID } from "node:crypto";
+export class InteractionRuntime {
+    sessions = new Map();
+    tasks = new Map();
+    messages = new Map();
+    async createSession(input) {
+        if (input.receivers.length === 0) {
+            throw new Error("A session must contain at least one service agent receiver");
+        }
+        const session = {
+            id: randomUUID(),
+            mode: input.mode,
+            sender: input.sender,
+            receivers: input.receivers,
+            context: input.context,
+            createdAt: new Date().toISOString()
+        };
+        this.sessions.set(session.id, session);
+        this.messages.set(session.id, []);
+        return session;
+    }
+    async submitTask(input) {
+        this.requireSession(input.sessionId);
+        const task = {
+            id: randomUUID(),
+            sessionId: input.sessionId,
+            state: "accepted",
+            stateChangedAt: new Date().toISOString(),
+            messages: input.initialMessages ?? [],
+            artifacts: input.artifacts
+        };
+        this.tasks.set(task.id, task);
+        if (input.initialMessages?.length) {
+            this.messages.set(input.sessionId, [...(this.messages.get(input.sessionId) ?? []), ...input.initialMessages]);
+        }
+        return task;
+    }
+    async updateTaskState(taskId, state) {
+        const task = this.requireTask(taskId);
+        const updated = { ...task, state, stateChangedAt: new Date().toISOString() };
+        this.tasks.set(taskId, updated);
+        return updated;
+    }
+    async sendMessage(input) {
+        this.requireSession(input.sessionId);
+        if (input.taskId) {
+            this.requireTask(input.taskId);
+        }
+        const message = {
+            senderRole: input.senderRole,
+            senderId: input.senderId,
+            sessionId: input.sessionId,
+            ...(input.taskId ? { taskId: input.taskId } : {}),
+            id: randomUUID(),
+            ...(input.artifact ? { artifact: input.artifact } : {}),
+            ...(input.final !== undefined ? { final: input.final } : {}),
+            ...(input.chunkIndex !== undefined ? { chunkIndex: input.chunkIndex } : {}),
+            ...(input.lastChunk !== undefined ? { lastChunk: input.lastChunk } : {}),
+            dataItems: input.dataItems,
+            createdAt: new Date().toISOString()
+        };
+        this.messages.set(input.sessionId, [...(this.messages.get(input.sessionId) ?? []), message]);
+        if (input.taskId) {
+            const task = this.requireTask(input.taskId);
+            const updated = { ...task, messages: [...(task.messages ?? []), message] };
+            this.tasks.set(task.id, updated);
+        }
+        return message;
+    }
+    async listMessages(sessionId) {
+        this.requireSession(sessionId);
+        return this.messages.get(sessionId) ?? [];
+    }
+    async getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    async getTask(taskId) {
+        return this.tasks.get(taskId);
+    }
+    requireSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        return session;
+    }
+    requireTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        return task;
+    }
+}
+//# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

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

package/dist/message-distribution.d.ts

@@ -0,0 +1,18 @@
+import type { InteractionRuntime, SendMessageInput } from "./interaction.js";
+import type { AgentIdentityCode, Message } from "./types.js";
+export interface DistributionReceipt {
+    recipientId: AgentIdentityCode;
+    sessionId: string;
+    messageId: string;
+    deliveredAt: string;
+    message: Message;
+}
+export declare class MessageDistributionRuntime {
+    private readonly interactionRuntime;
+    private inboxes;
+    constructor(interactionRuntime: InteractionRuntime);
+    distribute(input: SendMessageInput, recipients?: AgentIdentityCode[]): Promise<DistributionReceipt[]>;
+    listInbox(agentId: AgentIdentityCode): Promise<DistributionReceipt[]>;
+    private inferRecipients;
+}
+//# sourceMappingURL=message-distribution.d.ts.map

package/dist/message-distribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-distribution.d.ts","sourceRoot":"","sources":["../src/message-distribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,0BAA0B;IAGzB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAF/C,OAAO,CAAC,OAAO,CAAuD;gBAEzC,kBAAkB,EAAE,kBAAkB;IAE7D,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAmBrG,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAI7D,eAAe;CAO9B"}

package/dist/message-distribution.js

@@ -0,0 +1,35 @@
+export class MessageDistributionRuntime {
+    interactionRuntime;
+    inboxes = new Map();
+    constructor(interactionRuntime) {
+        this.interactionRuntime = interactionRuntime;
+    }
+    async distribute(input, recipients) {
+        const message = await this.interactionRuntime.sendMessage(input);
+        const targetRecipients = recipients ?? (await this.inferRecipients(input.sessionId, input.senderId));
+        const receipts = targetRecipients
+            .filter((recipientId) => recipientId !== input.senderId)
+            .map((recipientId) => ({
+            recipientId,
+            sessionId: input.sessionId,
+            messageId: message.id,
+            deliveredAt: new Date().toISOString(),
+            message
+        }));
+        for (const receipt of receipts) {
+            this.inboxes.set(receipt.recipientId, [...(this.inboxes.get(receipt.recipientId) ?? []), receipt]);
+        }
+        return receipts;
+    }
+    async listInbox(agentId) {
+        return this.inboxes.get(agentId) ?? [];
+    }
+    async inferRecipients(sessionId, senderId) {
+        const session = await this.interactionRuntime.getSession(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        return [session.sender.agentId, ...session.receivers.map((receiver) => receiver.agentId)].filter((agentId) => agentId !== senderId);
+    }
+}
+//# sourceMappingURL=message-distribution.js.map

package/dist/message-distribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-distribution.js","sourceRoot":"","sources":["../src/message-distribution.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,0BAA0B;IAGR;IAFrB,OAAO,GAAG,IAAI,GAAG,EAA4C,CAAC;IAEtE,YAA6B,kBAAsC;QAAtC,uBAAkB,GAAlB,kBAAkB,CAAoB;IAAG,CAAC;IAEvE,KAAK,CAAC,UAAU,CAAC,KAAuB,EAAE,UAAgC;QACxE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,gBAAgB,GAAG,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrG,MAAM,QAAQ,GAAG,gBAAgB;aAC9B,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,KAAK,KAAK,CAAC,QAAQ,CAAC;aACvD,GAAG,CAAC,CAAC,WAAW,EAAuB,EAAE,CAAC,CAAC;YAC1C,WAAW;YACX,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,OAAO;SACR,CAAC,CAAC,CAAC;QAEN,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACrG,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAA0B;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,SAAiB,EAAE,QAA2B;QAC1E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC;IACtI,CAAC;CACF"}

package/dist/tool-access.d.ts

@@ -0,0 +1,16 @@
+import type { ToolRuntime } from "./tools.js";
+import type { ToolInvokeRequest, ToolInvokeResult, ToolSyncData, ToolUpdateData } from "./types.js";
+export declare class ToolAccessRuntime {
+    private readonly toolService;
+    constructor(toolService: ToolRuntime);
+    getToolList(toolRequestList?: string[]): Promise<ToolSyncData>;
+    syncToolUpdates(): Promise<ToolUpdateData>;
+    invokeTools(request: ToolInvokeRequest): Promise<ToolInvokeResult>;
+    invokeUntilComplete(input: {
+        initialRequest: ToolInvokeRequest;
+        isComplete: (result: ToolInvokeResult, round: number) => boolean;
+        nextRequest: (result: ToolInvokeResult, round: number) => ToolInvokeRequest;
+        maxRounds?: number | undefined;
+    }): Promise<ToolInvokeResult[]>;
+}
+//# sourceMappingURL=tool-access.d.ts.map

package/dist/tool-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-access.d.ts","sourceRoot":"","sources":["../src/tool-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpG,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE/C,WAAW,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9D,eAAe,IAAI,OAAO,CAAC,cAAc,CAAC;IAI1C,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlE,mBAAmB,CAAC,KAAK,EAAE;QAC/B,cAAc,EAAE,iBAAiB,CAAC;QAClC,UAAU,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;QACjE,WAAW,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAC;QAC5E,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAchC"}

package/dist/tool-access.js

@@ -0,0 +1,30 @@
+export class ToolAccessRuntime {
+    toolService;
+    constructor(toolService) {
+        this.toolService = toolService;
+    }
+    async getToolList(toolRequestList) {
+        return this.toolService.listTools(toolRequestList);
+    }
+    async syncToolUpdates() {
+        return this.toolService.getUpdates();
+    }
+    async invokeTools(request) {
+        return this.toolService.invoke(request);
+    }
+    async invokeUntilComplete(input) {
+        const maxRounds = input.maxRounds ?? 8;
+        const results = [];
+        let request = input.initialRequest;
+        for (let round = 0; round < maxRounds; round += 1) {
+            const result = await this.invokeTools(request);
+            results.push(result);
+            if (input.isComplete(result, round)) {
+                return results;
+            }
+            request = input.nextRequest(result, round);
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=tool-access.js.map