@yuhere/js-jsonrpc2 2.1.11 → 2.1.13

package/dist/cli/cli.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli/cli.js

@@ -137,4 +137,3 @@ main().catch((err) => {
     console.error('启动失败：', err);
     process.exit(1);
 });
-//# sourceMappingURL=cli.js.map

package/dist/cli/demo-methods.d.ts

@@ -7,4 +7,3 @@ import type { Repository } from '../core/Repository.js';
  * 被 dev/express.ts 与 src/cli.ts 共用。
  */
 export declare function installDemoMethods(repository: Repository): void;
-//# sourceMappingURL=demo-methods.d.ts.map

package/dist/cli/demo-methods.js

@@ -473,4 +473,3 @@ export function installDemoMethods(repository) {
         }
     });
 }
-//# sourceMappingURL=demo-methods.js.map

package/dist/cli/express.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=express.d.ts.map

package/dist/cli/express.js

@@ -39,4 +39,3 @@ const port = Number(process.env['PORT'] ?? 5000);
 server.listen(port, () => {
     console.log(`js-jsonrpc2 debug server listening on http://localhost:${port}`);
 });
-//# sourceMappingURL=express.js.map

package/dist/cli/stdio.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=stdio.d.ts.map

package/dist/cli/stdio.js

@@ -2,4 +2,3 @@ import { createRepository, serveStdio, s } from '../index.js';
 const repository = createRepository();
 repository.register({ namespace: 'echo', signature: [s.string(), s.string()] }, (v) => v);
 await serveStdio({ repository, framing: 'lines' });
-//# sourceMappingURL=stdio.js.map

package/dist/core/Repository.d.ts

@@ -19,4 +19,3 @@ export declare class Repository {
 }
 export declare function createRepository(options?: RepositoryOptions): Repository;
 export type { MethodDescriptor };
-//# sourceMappingURL=Repository.d.ts.map

package/dist/core/Repository.js

@@ -297,4 +297,3 @@ export class Repository {
 export function createRepository(options = {}) {
     return new Repository(options);
 }
-//# sourceMappingURL=Repository.js.map

package/dist/core/convert.d.ts

@@ -1,4 +1,3 @@
 import type { MethodDescriptor } from './descriptor.js';
 import type { Injections } from '../types.js';
 export declare function convertParams(descriptor: MethodDescriptor, params: unknown, injections: Injections): Promise<unknown[]>;
-//# sourceMappingURL=convert.d.ts.map

package/dist/core/convert.js

@@ -26,4 +26,3 @@ export async function convertParams(descriptor, params, injections) {
     }
     return converted;
 }
-//# sourceMappingURL=convert.js.map

package/dist/core/descriptor.d.ts

@@ -24,4 +24,3 @@ export declare function buildDescriptor(descriptor: RPCDescriptor, fn: RPCHandle
 export declare function signatureOf(descriptor: MethodDescriptor): unknown[];
 export declare function lookup(methods: Map<string, MethodDescriptor>, method: string): MethodDescriptor;
 export declare function invalidParams(message: string, data?: unknown): RPCError;
-//# sourceMappingURL=descriptor.d.ts.map

package/dist/core/descriptor.js

@@ -80,4 +80,3 @@ export function lookup(methods, method) {
 export function invalidParams(message, data) {
     return new RPCError(INVALID_PARAMS, message, data);
 }
-//# sourceMappingURL=descriptor.js.map

package/dist/core/index.d.ts

@@ -1,4 +1,3 @@
 export { Repository, createRepository } from './Repository.js';
 export type { MethodDescriptor } from './descriptor.js';
 export { validateRequest } from './spec-check.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/core/index.js

@@ -1,3 +1,2 @@
 export { Repository, createRepository } from './Repository.js';
 export { validateRequest } from './spec-check.js';
-//# sourceMappingURL=index.js.map

package/dist/core/llm-tools.d.ts

@@ -22,4 +22,3 @@ export interface JSONSchema {
 }
 export declare function listLlmTools(repository: Repository, injections: Injections, rawOptions?: unknown): Promise<LlmTools>;
 export declare function invokeLlmTool(repository: Repository, call: LlmToolCall, injections: Injections): Promise<unknown>;
-//# sourceMappingURL=llm-tools.d.ts.map

package/dist/core/llm-tools.js

@@ -1,7 +1,7 @@
 import { RPCError } from '../errors/RPCError.js';
 import { METHOD_NOT_FOUND } from '../errors/codes.js';
 import { assertAccessible } from './permission.js';
-import { InjectableMarker } from '../schema/json/index.js';
+import { InjectableMarker, VoidMarker, StreamMarker, Schema } from '../schema/json/index.js';
 import { RPCVersion } from '../schema/z/protocol.js';
 function schemaToJSONSchema(schema) {
     return convert(schema.toJSON());
@@ -120,6 +120,91 @@ function convert(desc) {
     }
     return out;
 }
+// ─────────────────────────────────────────────────────────────
+// 返回值的人类可读描述（拼进 function.description）
+// ─────────────────────────────────────────────────────────────
+function formatConstraints(constraints) {
+    if (!constraints)
+        return '';
+    const parts = Object.entries(constraints)
+        .filter(([, v]) => v !== undefined)
+        .map(([k, v]) => `${k}=${JSON.stringify(v)}`);
+    return parts.length > 0 ? ` { ${parts.join(', ')} }` : '';
+}
+/**
+ * 把 SchemaDescription 渲染成一行/多行文本，供 LLM 阅读。
+ * 与 WebUI `docGen.ts` 的 `renderSchema` 风格一致：
+ * - 读 `schema.nullable`（不再有 kind === 'nullable'）
+ * - 容器类型递归
+ * - 未知 kind 原样输出
+ */
+function renderSchema(schema, indent = 0) {
+    const pad = '  '.repeat(indent);
+    const lines = [];
+    let head = `${pad}- ${schema.kind}`;
+    if (schema.nullable)
+        head += ' (nullable)';
+    if (schema.description)
+        head += ` — ${schema.description}`;
+    const c = formatConstraints(schema.constraints);
+    if (c)
+        head += ` \`${c}\``;
+    lines.push(head);
+    const ch = schema.children ?? {};
+    const pushChild = (label, child) => {
+        const sub = renderSchema(child, indent + 1);
+        if (sub.length) {
+            sub[0] = `${'  '.repeat(indent + 1)}- **${label}**: ${sub[0].trim().replace(/^- /, '')}`;
+            lines.push(...sub);
+        }
+    };
+    if (isSchema(ch.inner))
+        pushChild('inner', ch.inner);
+    if (Array.isArray(ch.items)) {
+        ch.items.forEach((it, i) => {
+            if (isSchema(it))
+                pushChild(`[${i}]`, it);
+        });
+    }
+    else if (isSchema(ch.items)) {
+        pushChild('items', ch.items);
+    }
+    if (Array.isArray(ch.options)) {
+        ch.options.forEach((opt, i) => {
+            if (isSchema(opt))
+                pushChild(`option[${i}]`, opt);
+        });
+    }
+    if (ch.properties && typeof ch.properties === 'object') {
+        for (const [k, v] of Object.entries(ch.properties)) {
+            if (isSchema(v))
+                pushChild(k, v);
+        }
+    }
+    if (isSchema(ch.values))
+        pushChild('values', ch.values);
+    return lines;
+}
+function isSchema(v) {
+    return !!v && typeof v === 'object' && typeof v.kind === 'string';
+}
+/** 渲染返回值槽位（Schema / VoidMarker / StreamMarker）。 */
+function renderReturnSlot(slot) {
+    if (slot instanceof VoidMarker)
+        return 'void';
+    if (slot instanceof StreamMarker) {
+        const inner = renderSchema(slot.inner.toJSON(), 0)
+            .map((l) => l.replace(/^- /, ''))
+            .join('\n');
+        return `stream of:\n${inner}`;
+    }
+    if (slot instanceof Schema) {
+        return renderSchema(slot.toJSON(), 0)
+            .map((l) => l.replace(/^- /, ''))
+            .join('\n');
+    }
+    return 'unknown';
+}
 export async function listLlmTools(repository, injections, rawOptions) {
     const opts = (rawOptions ?? {});
     const { includeStreaming = false, prefix } = opts;
@@ -155,12 +240,14 @@ export async function listLlmTools(repository, injections, rawOptions) {
             required.push(key);
             paramIndex++;
         }
-        // description：document + 流式说明 + 无参说明
+        // description：document + 返回值 + 流式说明 + 无参说明
         const parts = [];
         const doc = descriptor.document;
         const docText = typeof doc === 'function' ? ((await doc(descriptor)) ?? '') : (doc ?? '');
         if (docText)
             parts.push(docText);
+        const returnText = renderReturnSlot(descriptor.signature[0]);
+        parts.push(`Returns:\n${returnText}\n\n`);
         if (isStream) {
             parts.push('(Returns a stream of results; the host application consumes it incrementally and the LLM only receives the aggregated result.)');
         }
@@ -222,4 +309,3 @@ export async function invokeLlmTool(repository, call, injections) {
         })();
     }
 }
-//# sourceMappingURL=llm-tools.js.map

package/dist/core/permission.d.ts

@@ -2,4 +2,3 @@ import type { MethodDescriptor } from './descriptor.js';
 import type { Injections } from '../types.js';
 export declare function checkPermission(descriptor: MethodDescriptor, injections: Injections): Promise<void>;
 export declare function assertAccessible(descriptor: MethodDescriptor, injections: Injections): Promise<void>;
-//# sourceMappingURL=permission.d.ts.map

package/dist/core/permission.js

@@ -26,4 +26,3 @@ export async function assertAccessible(descriptor, injections) {
         throw error;
     }
 }
-//# sourceMappingURL=permission.js.map

package/dist/core/spec-check.d.ts

@@ -1,3 +1,2 @@
 import type { RPCRequestInput } from '../types.js';
 export declare function validateRequest(input: unknown): RPCRequestInput;
-//# sourceMappingURL=spec-check.d.ts.map

package/dist/core/spec-check.js

@@ -8,4 +8,3 @@ export function validateRequest(input) {
     }
     return result.data;
 }
-//# sourceMappingURL=spec-check.js.map

package/dist/core/system-methods.d.ts

@@ -1,3 +1,2 @@
 import type { Repository } from './Repository.js';
 export declare function registerSystemMethods(repository: Repository): void;
-//# sourceMappingURL=system-methods.d.ts.map

package/dist/core/system-methods.js

@@ -34,7 +34,12 @@ export function registerSystemMethods(repository) {
             'It returns an array of possible signatures for this method.\n' +
             'A signature is an array of types.\n' +
             'The first of these types is the return type of the method, the rest are parameters.\n',
-        signature: [s.array(s.unknown()), s.string(), s.injectable('repository'), s.injectable('injections')],
+        signature: [
+            s.array(s.object({
+                kind: s.enum(["string", "number", "boolean", "literal", "enum", "array", "tuple", "object", "record", "union", "unknown", "null", "stream", "void"]).describe('Schema类型'),
+            })),
+            s.string(), s.injectable('repository'), s.injectable('injections')
+        ],
     }, async function systemMethodSignature(namespace, repository, injections) {
         const descriptor = repository.get(namespace);
         if (!descriptor)
@@ -62,10 +67,8 @@ export function registerSystemMethods(repository) {
     });
     repository.register({
         namespace: 'system.metrics',
-        document: 'This method takes one parameter, the name of a method implemented by the RPC server.\n\n' +
-            'It returns a documentation string describing the use of that method.\n' +
-            'If no such string is available, an empty string is returned.\n' +
-            'The documentation string may contain HTML markup.\n',
+        document: 'Return the current RPC metrics snapshot, if the configured metrics implementation supports it.\n\n' +
+            'Returns `null` when the active `RPCMetrics` implementation does not expose `snapshot()`.',
         signature: [s.unknown(), s.injectable('repository')],
     }, async function systemMetrics(repository) {
         function hasSnapshot(m) {
@@ -75,6 +78,7 @@ export function registerSystemMethods(repository) {
         if (hasSnapshot(metrics)) {
             return metrics.snapshot();
         }
+        return null;
     });
     repository.register({
         namespace: 'llm.tools',
@@ -91,6 +95,8 @@ export function registerSystemMethods(repository) {
                     name: s.string(),
                     description: s.string(),
                     parameters: s.record(s.unknown()),
+                    required: s.array(s.string()),
+                    additionalProperties: s.boolean()
                 }),
             })),
             s.injectable("repository"),
@@ -99,10 +105,9 @@ export function registerSystemMethods(repository) {
                 includeStreaming: s.boolean().describe('Include stream-returning methods (default false)'),
                 namePrefix: s.string().describe('Prefix added to every tool name'),
                 prefix: s.string().describe('Only include methods whose namespace starts with this'),
-            }).describe('Options').nullable()
+            }).strict().describe('Options').nullable()
         ],
     }, async function generateLlmTools(repository, injections, rawOptions) {
         return repository.listLlmTools(injections, rawOptions);
     });
 }
-//# sourceMappingURL=system-methods.js.map

package/dist/errors/RPCError.d.ts

@@ -6,4 +6,3 @@ export declare class RPCError extends Error {
     toPayload(): RPCErrorPayload;
     toJSON(): RPCErrorPayload;
 }
-//# sourceMappingURL=RPCError.d.ts.map

package/dist/errors/RPCError.js

@@ -20,4 +20,3 @@ export class RPCError extends Error {
         return this.toPayload();
     }
 }
-//# sourceMappingURL=RPCError.js.map

package/dist/errors/codes.d.ts

@@ -4,4 +4,3 @@ export declare const METHOD_NOT_FOUND = -32601;
 export declare const INVALID_PARAMS = -32602;
 export declare const INTERNAL_ERROR = -32603;
 export declare const PERMISSION_DENIED = -32604;
-//# sourceMappingURL=codes.d.ts.map

package/dist/errors/codes.js

@@ -4,4 +4,3 @@ export const METHOD_NOT_FOUND = -32601;
 export const INVALID_PARAMS = -32602;
 export const INTERNAL_ERROR = -32603;
 export const PERMISSION_DENIED = -32604;
-//# sourceMappingURL=codes.js.map

package/dist/errors/index.d.ts

@@ -1,3 +1,2 @@
 export { RPCError } from './RPCError.js';
 export * from './codes.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.js

@@ -1,3 +1,2 @@
 export { RPCError } from './RPCError.js';
 export * from './codes.js';
-//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -15,4 +15,3 @@ export { attachWebSocket, createWebSocketServer, serveStdio };
 export type { WSOptions, StandaloneWsOptions, StandaloneWsHandle } from './transport/ws/index.js';
 export type { StdioOptions } from './transport/stdio/index.js';
 export type { ExpressOptions } from './transport/express/index.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -14,4 +14,3 @@ export { createExpressRouter };
 import { attachWebSocket, createWebSocketServer } from './transport/ws/index.js';
 import { serveStdio } from './transport/stdio/index.js';
 export { attachWebSocket, createWebSocketServer, serveStdio };
-//# sourceMappingURL=index.js.map

package/dist/metrics/memory.d.ts

@@ -56,4 +56,3 @@ export interface MemoryMetrics extends RPCMetrics {
     reset(): void;
 }
 export declare function createMemoryMetrics(options?: MemoryMetricsOptions): MemoryMetrics;
-//# sourceMappingURL=memory.d.ts.map

package/dist/metrics/memory.js

@@ -185,4 +185,3 @@ export function createMemoryMetrics(options = {}) {
         },
     };
 }
-//# sourceMappingURL=memory.js.map

package/dist/metrics/prom.d.ts

@@ -1 +0,0 @@
-//# sourceMappingURL=prom.d.ts.map

package/dist/metrics/prom.js

@@ -102,4 +102,3 @@
 //         },
 //     };
 // }
-//# sourceMappingURL=prom.js.map

package/dist/schema/json/index.d.ts

@@ -17,4 +17,3 @@ export declare const s: {
     injectable: <const K extends string>(key: K) => import("./marker.js").InjectableMarker<K>;
     stream: <T>(inner: import("./primitives.js").Schema<T>) => import("./marker.js").StreamMarker<T>;
 };
-//# sourceMappingURL=index.d.ts.map

package/dist/schema/json/index.js

@@ -3,4 +3,3 @@ import { markers } from "./marker.js";
 export * from "./primitives.js";
 export * from "./marker.js";
 export const s = { ...primitives, ...markers };
-//# sourceMappingURL=index.js.map

package/dist/schema/json/marker.d.ts

@@ -20,4 +20,3 @@ export declare const markers: {
     injectable: <const K extends string>(key: K) => InjectableMarker<K>;
     stream: <T>(inner: Schema<T>) => StreamMarker<T>;
 };
-//# sourceMappingURL=marker.d.ts.map

package/dist/schema/json/marker.js

@@ -24,4 +24,3 @@ export const markers = {
     injectable: (key) => new InjectableMarker(key),
     stream: (inner) => new StreamMarker(inner),
 };
-//# sourceMappingURL=marker.js.map

package/dist/schema/json/primitives.d.ts

@@ -238,4 +238,3 @@ export declare const primitives: {
     null: () => NullSchema;
 };
 export {};
-//# sourceMappingURL=primitives.d.ts.map

package/dist/schema/json/primitives.js

@@ -623,4 +623,3 @@ export const primitives = {
     unknown: () => new UnknownSchema(),
     null: () => new NullSchema(),
 };
-//# sourceMappingURL=primitives.js.map

package/dist/schema/z/protocol.d.ts

@@ -6,4 +6,3 @@ export declare const RPCRequestSchema: import("../json/index.js").ObjectSchema<{
     params: import("../json/index.js").ArraySchema<import("../json/index.js").JSONValue>;
     id: import("../json/index.js").UnionSchema<readonly [import("../json/index.js").StringSchema<"string">, import("../json/index.js").NumberSchema]>;
 }, true>;
-//# sourceMappingURL=protocol.d.ts.map

package/dist/schema/z/protocol.js

@@ -6,4 +6,3 @@ export const RPCRequestSchema = s.object({
     params: s.array(s.unknown()).nullable(),
     id: s.union([s.string().min(1), s.number()]),
 }).strict();
-//# sourceMappingURL=protocol.js.map

package/dist/schema/z/register.d.ts

@@ -6,4 +6,3 @@ export declare const registerSchema: z.ZodTuple<[z.ZodObject<{
     grantTo: z.ZodOptional<z.ZodArray<z.ZodString>>;
     signature: z.ZodTuple<[z.ZodUnion<readonly [z.ZodInstanceOf<Schema<unknown>>, z.ZodInstanceOf<VoidMarker>, z.ZodInstanceOf<StreamMarker<unknown>>]>], z.ZodUnion<readonly [z.ZodInstanceOf<Schema<unknown>>, z.ZodInstanceOf<InjectableMarker<string>>]>>;
 }, z.core.$strict>, z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>], null>;
-//# sourceMappingURL=register.d.ts.map

package/dist/schema/z/register.js

@@ -18,4 +18,3 @@ export const registerSchema = z.tuple([
     descriptorSchema,
     z.function(),
 ]);
-//# sourceMappingURL=register.js.map

package/dist/stream/stringify-stream.d.ts

@@ -12,4 +12,3 @@ export interface StringifyStreamOptions {
 }
 export declare function stringifyStream(input: unknown, options?: StringifyStreamOptions): AsyncGenerator<string, void, unknown>;
 export declare function stringify(input: unknown, options?: StringifyStreamOptions): Promise<string>;
-//# sourceMappingURL=stringify-stream.d.ts.map