gbz185-sdk 0.1.0

package/dist/tool-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-access.js","sourceRoot":"","sources":["../src/tool-access.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,WAAwB;QAAxB,gBAAW,GAAX,WAAW,CAAa;IAAG,CAAC;IAEzD,KAAK,CAAC,WAAW,CAAC,eAA0B;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAA0B;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,KAKzB;QACC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,IAAI,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC;QACnC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;gBACpC,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/tools.d.ts

@@ -0,0 +1,18 @@
+import type { JsonObject, ToolDescriptor, ToolInvokeItem, ToolInvokeRequest, ToolInvokeResult, ToolSyncData, ToolUpdateData } from "./types.js";
+export type ToolHandler = (input: JsonObject, context: {
+    sessionId: string | number;
+    item: ToolInvokeItem;
+}) => Promise<JsonObject> | JsonObject;
+export interface RegisteredTool {
+    descriptor: ToolDescriptor;
+    handler: ToolHandler;
+}
+export declare class ToolRuntime {
+    private tools;
+    private updatedTools;
+    registerTool(descriptor: ToolDescriptor, handler: ToolHandler): Promise<ToolDescriptor>;
+    listTools(requestedToolIds?: string[]): Promise<ToolSyncData>;
+    getUpdates(): Promise<ToolUpdateData>;
+    invoke(request: ToolInvokeRequest): Promise<ToolInvokeResult>;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAkB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhK,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;AAEjJ,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAqB;IAEnC,YAAY,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAOvF,SAAS,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAW7D,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAarC,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAyCpE"}

package/dist/tools.js

@@ -0,0 +1,77 @@
+import { assertToolDescriptor } from "./validation.js";
+export class ToolRuntime {
+    tools = new Map();
+    updatedTools = new Set();
+    async registerTool(descriptor, handler) {
+        assertToolDescriptor(descriptor);
+        this.tools.set(toolKey(descriptor.toolId, descriptor.toolVersion), { descriptor, handler });
+        this.updatedTools.add(descriptor.toolId);
+        return descriptor;
+    }
+    async listTools(requestedToolIds) {
+        const requested = requestedToolIds ? new Set(requestedToolIds) : undefined;
+        return {
+            syncType: requested ? 2 : 1,
+            timestamp: Date.now(),
+            toolSyncList: [...this.tools.values()]
+                .map((tool) => tool.descriptor)
+                .filter((descriptor) => !requested || requested.has(descriptor.toolId))
+        };
+    }
+    async getUpdates() {
+        const updateIds = new Set(this.updatedTools);
+        this.updatedTools.clear();
+        return {
+            syncType: 2,
+            timestamp: Date.now(),
+            toolUpdateList: [...this.tools.values()]
+                .map((tool) => tool.descriptor)
+                .filter((descriptor) => updateIds.has(descriptor.toolId))
+                .map(({ toolId, toolName, toolDescription, toolVersion }) => ({ toolId, toolName, toolDescription, toolVersion }))
+        };
+    }
+    async invoke(request) {
+        const results = [];
+        for (const item of request.toolInvokeList) {
+            const registered = this.tools.get(toolKey(item.toolId, item.toolVersion));
+            if (!registered) {
+                results.push({
+                    toolId: item.toolId,
+                    toolVersion: item.toolVersion,
+                    statusCode: "TOOL_NOT_FOUND",
+                    ok: false,
+                    error: `Tool not found: ${item.toolId}@${item.toolVersion}`
+                });
+                continue;
+            }
+            try {
+                const output = await registered.handler(item.toolInputParam, { sessionId: request.sessionId, item });
+                results.push({
+                    toolId: item.toolId,
+                    toolVersion: item.toolVersion,
+                    toolOutputParam: output,
+                    statusCode: 0,
+                    ok: true
+                });
+            }
+            catch (error) {
+                results.push({
+                    toolId: item.toolId,
+                    toolVersion: item.toolVersion,
+                    statusCode: "TOOL_EXECUTION_FAILED",
+                    ok: false,
+                    error: error.message
+                });
+            }
+        }
+        return {
+            sessionId: request.sessionId,
+            timestamp: request.timestamp ?? Date.now(),
+            toolResultList: results
+        };
+    }
+}
+function toolKey(toolId, version) {
+    return `${toolId}@${version}`;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,21 @@
+export interface JsonTransport {
+    request<TRequest = unknown, TResponse = unknown>(operation: string, payload: TRequest): Promise<TResponse>;
+}
+export type JsonOperationHandler<TRequest = unknown, TResponse = unknown> = (payload: TRequest) => Promise<TResponse> | TResponse;
+export declare class InProcessJsonTransport implements JsonTransport {
+    private handlers;
+    register<TRequest = unknown, TResponse = unknown>(operation: string, handler: JsonOperationHandler<TRequest, TResponse>): void;
+    request<TRequest = unknown, TResponse = unknown>(operation: string, payload: TRequest): Promise<TResponse>;
+}
+export interface HttpJsonTransportOptions {
+    endpoint: string;
+    fetchImpl?: typeof fetch;
+    headers?: Record<string, string>;
+}
+export declare class HttpJsonTransport implements JsonTransport {
+    private readonly options;
+    private readonly fetchImpl;
+    constructor(options: HttpJsonTransportOptions);
+    request<TRequest = unknown, TResponse = unknown>(operation: string, payload: TRequest): Promise<TResponse>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC5G;AAED,MAAM,MAAM,oBAAoB,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;AAElI,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,QAAQ,CAA2C;IAE3D,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,IAAI;IAIxH,OAAO,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;CAOjH;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,iBAAkB,YAAW,aAAa;IAGzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAEZ,OAAO,EAAE,wBAAwB;IAIxD,OAAO,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;CAcjH"}

package/dist/transport.js

@@ -0,0 +1,36 @@
+export class InProcessJsonTransport {
+    handlers = new Map();
+    register(operation, handler) {
+        this.handlers.set(operation, handler);
+    }
+    async request(operation, payload) {
+        const handler = this.handlers.get(operation);
+        if (!handler) {
+            throw new Error(`No JSON transport handler registered for operation: ${operation}`);
+        }
+        return handler(payload);
+    }
+}
+export class HttpJsonTransport {
+    options;
+    fetchImpl;
+    constructor(options) {
+        this.options = options;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    async request(operation, payload) {
+        const response = await this.fetchImpl(this.options.endpoint, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...(this.options.headers ?? {})
+            },
+            body: JSON.stringify({ operation, payload })
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP JSON transport failed: ${response.status} ${response.statusText}`);
+        }
+        return (await response.json());
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,sBAAsB;IACzB,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE3D,QAAQ,CAA0C,SAAiB,EAAE,OAAkD;QACrH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAA+B,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,OAAO,CAA0C,SAAiB,EAAE,OAAiB;QACzF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,uDAAuD,SAAS,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAuB,CAAC;IAChD,CAAC;CACF;AAQD,MAAM,OAAO,iBAAiB;IAGC;IAFZ,SAAS,CAAe;IAEzC,YAA6B,OAAiC;QAAjC,YAAO,GAAP,OAAO,CAA0B;QAC5D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO,CAA0C,SAAiB,EAAE,OAAiB;QACzF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;YAC3D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;aAChC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;SAC7C,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAc,CAAC;IAC9C,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,165 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type AgentInteractionMode = "point_to_point" | "group" | "hybrid";
+export type AgentRole = "requester" | "service";
+export type MessageArtifact = "work_communication" | "work_result";
+export type TaskState = "accepted" | "rejected" | "completed" | "failed" | "cancelled" | "in_progress" | "progress";
+export interface AgentIdentityCodeParts {
+    oid: "1.2.156.3088";
+    version: "1";
+    registrationServiceProvider: string;
+    registrationRequester: string;
+    ontologySerial: string;
+    instanceSerial: string;
+}
+export type AgentIdentityCode = string;
+export interface SkillDescription {
+    skillId: string;
+    skillName: string;
+    skillDescription: string;
+    tags: string[];
+    examples?: string[] | undefined;
+    inputTypes: string[];
+    outputTypes: string[];
+    dependencies?: JsonObject[] | undefined;
+}
+export interface AccessMethod {
+    type: "url" | "ip" | "fqdn" | string;
+    address: string;
+    metadata?: JsonObject | undefined;
+}
+export interface AuthenticationDescription {
+    type: "none" | "x509" | "bearer" | "custom" | string;
+    metadata?: JsonObject | undefined;
+}
+export interface AgentDescription {
+    agentId: AgentIdentityCode;
+    name: string;
+    alias?: string | undefined;
+    version: string;
+    description: string;
+    iconAddress?: string | undefined;
+    provider: string | JsonObject;
+    accessAddress?: string | undefined;
+    accessMethod?: AccessMethod[] | undefined;
+    servingArea?: JsonObject | undefined;
+    authentication?: AuthenticationDescription | undefined;
+    capabilities: JsonObject;
+    defaultInputTypes: string[];
+    defaultOutputTypes: string[];
+    skills: SkillDescription[];
+    discoverable?: boolean | undefined;
+    available?: boolean | undefined;
+    metadata?: JsonObject | undefined;
+}
+export interface DiscoveryQuery {
+    text?: string | undefined;
+    agentId?: AgentIdentityCode | undefined;
+    name?: string | undefined;
+    requiredSkills?: string[] | undefined;
+    tags?: string[] | undefined;
+    inputTypes?: string[] | undefined;
+    outputTypes?: string[] | undefined;
+    includeUndiscoverable?: boolean | undefined;
+    requireAvailable?: boolean | undefined;
+    limit?: number | undefined;
+}
+export interface DiscoveryResult {
+    description: AgentDescription;
+    score: number;
+    matchedBy: string[];
+}
+export interface DataItem {
+    type: string;
+    metadata: JsonObject;
+    payload: unknown;
+}
+export interface Message {
+    senderRole: AgentRole;
+    senderId: AgentIdentityCode;
+    sessionId: string;
+    taskId?: string | undefined;
+    id: string;
+    artifact?: MessageArtifact | undefined;
+    final?: boolean | undefined;
+    chunkIndex?: number | undefined;
+    lastChunk?: boolean | undefined;
+    dataItems: DataItem[];
+    createdAt: string;
+}
+export interface Task {
+    id: string;
+    sessionId: string;
+    state: TaskState;
+    stateChangedAt?: string | undefined;
+    messages?: Message[] | undefined;
+    artifacts?: Array<Message | Task> | undefined;
+}
+export interface SessionReceiver {
+    agentId: AgentIdentityCode;
+    accessAddress?: string | undefined;
+    mode: AgentInteractionMode;
+    parameters?: JsonObject | undefined;
+}
+export interface Session {
+    id: string;
+    mode: AgentInteractionMode;
+    sender: {
+        agentId: AgentIdentityCode;
+        accessAddress?: string | undefined;
+    };
+    receivers: SessionReceiver[];
+    context?: Array<Message | Task> | undefined;
+    createdAt: string;
+}
+export interface ToolDescriptor {
+    toolId: string;
+    toolName: string;
+    toolDescription: string;
+    toolVersion: string;
+    toolInputParam: JsonObject;
+    toolOutputParam: JsonObject;
+    metadata?: JsonObject | undefined;
+}
+export interface ToolRequestData {
+    requestType: 1 | 2;
+    timestamp?: string | number | undefined;
+    toolRequestList?: string[] | undefined;
+}
+export interface ToolSyncData {
+    syncType: 1 | 2;
+    timestamp?: string | number | undefined;
+    toolSyncList: ToolDescriptor[];
+}
+export interface ToolUpdateData {
+    syncType: 2;
+    timestamp?: string | number | undefined;
+    toolUpdateList: Pick<ToolDescriptor, "toolId" | "toolName" | "toolDescription" | "toolVersion">[];
+}
+export interface ToolInvokeItem {
+    toolId: string;
+    toolVersion: string;
+    toolInputParam: JsonObject;
+}
+export interface ToolInvokeRequest {
+    sessionId: string | number;
+    timestamp?: string | number | undefined;
+    toolInvokeList: ToolInvokeItem[];
+}
+export interface ToolResultItem {
+    toolId: string;
+    toolVersion: string;
+    toolOutputParam?: JsonObject | undefined;
+    statusCode: string | number;
+    ok: boolean;
+    error?: string | undefined;
+}
+export interface ToolInvokeResult {
+    sessionId: string | number;
+    timestamp?: string | number | undefined;
+    toolResultList: ToolResultItem[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,12 @@
+import type { AgentDescription, JsonObject, SkillDescription, ToolDescriptor } from "./types.js";
+export interface ValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+export declare function isJsonObject(value: unknown): value is JsonObject;
+export declare function validateSkillDescription(skill: SkillDescription, path?: string): ValidationResult;
+export declare function validateAgentDescription(description: AgentDescription): ValidationResult;
+export declare function assertAgentDescription(description: AgentDescription): void;
+export declare function validateToolDescriptor(tool: ToolDescriptor): ValidationResult;
+export declare function assertToolDescriptor(tool: ToolDescriptor): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjG,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAcD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,SAAU,GAAG,gBAAgB,CAelG;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,gBAAgB,GAAG,gBAAgB,CAkCxF;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAK1E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAa7E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAK/D"}

package/dist/validation.js

@@ -0,0 +1,94 @@
+import { validateIdentityCode } from "./identity-code.js";
+export function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requiredString(value, path, errors) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        errors.push(`${path} must be a non-empty string`);
+    }
+}
+function requiredStringArray(value, path, errors) {
+    if (!Array.isArray(value) || value.length === 0 || value.some((item) => typeof item !== "string" || item.trim().length === 0)) {
+        errors.push(`${path} must be a non-empty string array`);
+    }
+}
+export function validateSkillDescription(skill, path = "skill") {
+    const errors = [];
+    requiredString(skill.skillId, `${path}.skillId`, errors);
+    requiredString(skill.skillName, `${path}.skillName`, errors);
+    requiredString(skill.skillDescription, `${path}.skillDescription`, errors);
+    requiredStringArray(skill.tags, `${path}.tags`, errors);
+    requiredStringArray(skill.inputTypes, `${path}.inputTypes`, errors);
+    requiredStringArray(skill.outputTypes, `${path}.outputTypes`, errors);
+    if (skill.examples !== undefined) {
+        requiredStringArray(skill.examples, `${path}.examples`, errors);
+    }
+    if (skill.dependencies !== undefined && (!Array.isArray(skill.dependencies) || skill.dependencies.some((item) => !isJsonObject(item)))) {
+        errors.push(`${path}.dependencies must be an array of JSON objects`);
+    }
+    return { ok: errors.length === 0, errors };
+}
+export function validateAgentDescription(description) {
+    const errors = [];
+    if (!validateIdentityCode(description.agentId)) {
+        errors.push("agentId must be a valid GB/Z 185 identity code");
+    }
+    requiredString(description.name, "name", errors);
+    requiredString(description.version, "version", errors);
+    requiredString(description.description, "description", errors);
+    if (!(typeof description.provider === "string" && description.provider.trim()) && !isJsonObject(description.provider)) {
+        errors.push("provider must be a non-empty string or JSON object");
+    }
+    if (!isJsonObject(description.capabilities)) {
+        errors.push("capabilities must be a JSON object");
+    }
+    requiredStringArray(description.defaultInputTypes, "defaultInputTypes", errors);
+    requiredStringArray(description.defaultOutputTypes, "defaultOutputTypes", errors);
+    if (!Array.isArray(description.skills) || description.skills.length === 0) {
+        errors.push("skills must contain at least one skill");
+    }
+    else {
+        for (const [index, skill] of description.skills.entries()) {
+            errors.push(...validateSkillDescription(skill, `skills[${index}]`).errors);
+        }
+    }
+    if (description.accessMethod !== undefined) {
+        if (!Array.isArray(description.accessMethod)) {
+            errors.push("accessMethod must be an array");
+        }
+        else {
+            for (const [index, method] of description.accessMethod.entries()) {
+                requiredString(method.type, `accessMethod[${index}].type`, errors);
+                requiredString(method.address, `accessMethod[${index}].address`, errors);
+            }
+        }
+    }
+    return { ok: errors.length === 0, errors };
+}
+export function assertAgentDescription(description) {
+    const result = validateAgentDescription(description);
+    if (!result.ok) {
+        throw new Error(`Invalid agent description: ${result.errors.join("; ")}`);
+    }
+}
+export function validateToolDescriptor(tool) {
+    const errors = [];
+    requiredString(tool.toolId, "toolId", errors);
+    requiredString(tool.toolName, "toolName", errors);
+    requiredString(tool.toolDescription, "toolDescription", errors);
+    requiredString(tool.toolVersion, "toolVersion", errors);
+    if (!isJsonObject(tool.toolInputParam)) {
+        errors.push("toolInputParam must be a JSON object");
+    }
+    if (!isJsonObject(tool.toolOutputParam)) {
+        errors.push("toolOutputParam must be a JSON object");
+    }
+    return { ok: errors.length === 0, errors };
+}
+export function assertToolDescriptor(tool) {
+    const result = validateToolDescriptor(tool);
+    if (!result.ok) {
+        throw new Error(`Invalid tool descriptor: ${result.errors.join("; ")}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/docs/API_REFERENCE.md

@@ -0,0 +1,116 @@
+# gbz185-sdk API Reference
+
+This reference lists the main public APIs exported by `gbz185-sdk`.
+
+## Identity Code
+
+| API | Purpose |
+| --- | --- |
+| `formatIdentityCode(parts)` | Builds a GB/Z 185.2 identity code with prefix `1.2.156.3088` and version `1`. |
+| `parseIdentityCode(code)` | Parses identity code parts and validates OID/version/node structure. |
+| `validateIdentityCode(code)` | Returns a boolean instead of throwing. |
+| `validateIdentityCodeParts(parts)` | Validates parsed or manually assembled identity-code parts. |
+
+## Runtime Factory
+
+| API | Purpose |
+| --- | --- |
+| `createAgentInterconnectRuntime()` | Creates the in-memory reference runtime with identity, credential, description, discovery, interaction, message distribution, tool access, tool service, transport, and client wired together. |
+| `AgentInterconnectRuntime` | Interface describing the assembled runtime object. |
+
+## Agent-Side Facades
+
+| API | Purpose |
+| --- | --- |
+| `AgentIdentityMaintenance` | Agent-side identity-code and credential maintenance: register, refresh, update, issue credential, lock/unlock/revoke account, lock/unlock/revoke credential. |
+| `AgentDescriptionMaintenance` | Agent-side description maintenance: register, review request, publish, change, unpublish, revoke. |
+| `InterconnectionAuthorizationRuntime` | Creates process credential packages, authenticates peers, evaluates authorization decisions, and supports mutual authentication. |
+| `ToolAccessRuntime` | Agent-side tool access facade: get tool list, sync updates, invoke tools, repeat invocation until complete. |
+
+## Identity And Credentials
+
+| API | Purpose |
+| --- | --- |
+| `IdentityRegistryRuntime` | Identity account lifecycle: register, update, issue credential, lock, unlock, revoke, get, list. |
+| `IdentityAccount` | Account model with identity code, delegator, subject, status, evidence, credential IDs, audit log, timestamps. |
+| `IdentityAuditEvent` | Audit event emitted by identity lifecycle operations. |
+| `CredentialIssuer` | Interface for issuing, updating, locking, unlocking, revoking, and reading credentials. |
+| `CredentialVerifier` | Interface for verifying process credential packages. |
+| `DevelopmentCredentialIssuer` | Node.js crypto development implementation using Ed25519 keys. |
+| `DevelopmentCredentialVerifier` | Development verifier for validity, status, audience, scope, and signature checks. |
+| `CertificateChainVerifier` | Production extension point for X.509 chain validation. |
+| `CredentialStatusStore` | Extension point for credential lock/revoke status lookup. |
+| `createProcessCredentialPackage(input)` | Signs a process credential package for peer authentication. |
+
+## Agent Description
+
+| API | Purpose |
+| --- | --- |
+| `AgentDescription` | GB/Z 185.4 agent description model. |
+| `SkillDescription` | GB/Z 185.4 skill model. |
+| `AgentDescriptionRegistry` | Description lifecycle: register, review, issue publication certificate, publish, change, unpublish, revoke, get, list. |
+| `DescriptionRecord` | Stored description record with lifecycle status and publication metadata. |
+| `PublicationCertificate` | Reference model for publication certificate metadata. |
+| `validateAgentDescription(description)` | Returns validation errors for required fields and skills. |
+| `assertAgentDescription(description)` | Throws on invalid descriptions. |
+
+## Discovery
+
+| API | Purpose |
+| --- | --- |
+| `DiscoveryService` | Searches published and preset descriptions using text, identity code, name, skills, tags, IO types, discoverability, availability, and limit filters. |
+| `PresetDiscoverySource` | Represents provider preset data, cached discovery results, user configuration, or `.well-known`-derived descriptions. |
+| `DiscoveryQuery` | Query object for discovery. |
+| `DiscoveryResult` | Scored result with matched fields. |
+
+## Interaction And Message Distribution
+
+| API | Purpose |
+| --- | --- |
+| `InteractionRuntime` | Creates sessions, submits tasks, updates task state, sends messages, lists messages. |
+| `MessageDistributionRuntime` | Distributes group messages to all recipients except the sender and stores delivery receipts. |
+| `Session` | GB/Z 185.6 session model. |
+| `Task` | GB/Z 185.6 task model. |
+| `Message` | GB/Z 185.6 message model. |
+| `DataItem` | GB/Z 185.6 data payload model. |
+
+## Tool Invocation
+
+| API | Purpose |
+| --- | --- |
+| `ToolRuntime` | Resource-side tool service: register tools, list tools, get updates, invoke one or more tools. |
+| `ToolDescriptor` | GB/Z 185.7 tool property description. |
+| `ToolRequestData` | Tool-list request data shape. |
+| `ToolSyncData` | Tool-list sync data shape. |
+| `ToolUpdateData` | Tool-update notification data shape. |
+| `ToolInvokeRequest` | Tool invocation request data shape. |
+| `ToolInvokeResult` | Tool invocation result data shape. |
+
+## Client And Transport
+
+| API | Purpose |
+| --- | --- |
+| `JsonTransport` | Transport contract: `request(operation, payload)`. |
+| `InProcessJsonTransport` | Local in-process operation router used by the reference runtime. |
+| `HttpJsonTransport` | Minimal HTTP adapter that POSTs `{ operation, payload }` to a configured endpoint. |
+| `AgentInterconnectClient` | Client facade over identity, description, discovery, interaction, distribution, and tool operations. |
+
+## Conformance Metadata
+
+| API | Purpose |
+| --- | --- |
+| `GBZ185_FUNCTIONS` | 12 GB/Z 185.1 function domains mapped to SDK surfaces. |
+| `GBZ185_FRAI_INTERFACES` | FRAI-01 through FRAI-10 interface coverage map. |
+| `GBZ185_CONFORMANCE_MATRIX` | Clause-level conformance map for GB/Z 185.1 through GB/Z 185.7. |
+
+## Production Extension Points
+
+The reference runtime is intentionally replaceable. Production systems should implement these interfaces:
+
+- `IdentityAccountStore`
+- `DescriptionStore`
+- `CredentialIssuer`
+- `CredentialVerifier`
+- `CredentialStatusStore`
+- `CertificateChainVerifier`
+- `JsonTransport`