@hunterzhu/pulse-runtime 0.3.0 → 0.4.1

package/README.md

@@ -1,5 +1,7 @@
 # @hunterzhu/pulse-runtime
 
+[简体中文](https://github.com/zhuhengtan/Pulse/blob/main/packages/runtime/README.zh-CN.md)
+
 The core agent runtime for Pulse: programs, lanes, agents, and outcomes.
 
 ## Requirements
@@ -40,3 +42,7 @@ tools is described in the docs.
 
 - [Documentation](https://github.com/zhuhengtan/Pulse#readme)
 - [Source](https://github.com/zhuhengtan/Pulse/tree/main/packages/runtime)
+
+## License
+
+This package is licensed under [PolyForm Noncommercial 1.0.0](./LICENSE). Commercial use requires separate permission. This is a source-available noncommercial license, not an OSI-approved open-source license.

package/dist/dsl/program.d.ts

@@ -9,6 +9,7 @@ export type NextStepTarget<TState = unknown> = string | {
     complete: {
         value?: JsonValue;
         privacy?: PrivacyLabel;
+        derivedFrom?: ProvenanceRef[];
         children?: 'reject_if_active' | 'cancel' | 'await';
     };
 } | {
@@ -89,6 +90,7 @@ export interface StepContext<TState = JsonValue> {
     results: {
         meta(ref: ResultRef): ResultMeta | undefined;
         summary(ref: ResultRef): JsonValue | undefined;
+        read(ref: ResultRef): JsonValue | undefined;
     };
     mergeProposals: ReadonlyArray<MergeProposal>;
     mutateLane(mutator: (draft: TState) => void): void;

package/dist/dsl/program.js

@@ -8,7 +8,7 @@ function target(step, fallback) {
     if ('step' in step)
         return { step: step.step };
     if ('complete' in step)
-        return { step: fallback, action: { type: 'complete', result: step.complete.value ?? null, ...(step.complete.privacy === undefined ? {} : { privacy: step.complete.privacy }), ...(step.complete.children === undefined ? {} : { children: step.complete.children }) } };
+        return { step: fallback, action: { type: 'complete', result: step.complete.value ?? null, ...(step.complete.privacy === undefined ? {} : { privacy: step.complete.privacy }), ...(step.complete.derivedFrom === undefined ? {} : { derivedFrom: step.complete.derivedFrom }), ...(step.complete.children === undefined ? {} : { children: step.complete.children }) } };
     return { step: fallback, action: { type: 'fail', error: { code: step.fail.code, message: step.fail.message, ...(step.fail.retryable === undefined ? {} : { retryable: step.fail.retryable }), ...(step.fail.details === undefined ? {} : { details: step.fail.details }) }, ...(step.fail.privacy === undefined ? {} : { privacy: step.fail.privacy }), ...(step.fail.derivedFrom === undefined ? {} : { derivedFrom: step.fail.derivedFrom }) } };
 }
 function clone(value) { return structuredClone(value); }
@@ -318,7 +318,8 @@ function makeContext(context, initialState) {
     const ctx = {
         lane: context.lane, goal: context.lane.goal, global, globalVersion, laneState: readonlyState, history, now: context.now, ...(context.lane.progressWatchdog === undefined ? {} : { watchdog: context.lane.progressWatchdog }), ...(context.resumeInput ? { resumeInput: context.resumeInput } : {}), ...(context.humanInputs?.length ? { humanInputs: context.humanInputs } : {}),
         results: { meta: resultMeta, summary: (ref) => { if (context.state.results.has(ref) && resultVisible(context, ref))
-                derivedRefs.add(ref); return resultMeta(ref)?.summary; } },
+                derivedRefs.add(ref); return resultMeta(ref)?.summary; }, read: (ref) => { if (context.state.results.has(ref) && resultVisible(context, ref))
+                derivedRefs.add(ref); return findResult(context, ref); } },
         mergeProposals: [...context.state.mergeProposals.values()].filter((proposal) => proposal.agentId === context.lane.agentId).map((proposal) => { for (const ref of proposal.delta.derivedFrom ?? [])
             derivedRefs.add(ref); return clone(proposal); }),
         mutateLane: (mutator) => { mutator((draftProxy?.draft ?? draft)); const changes = draftProxy?.changes(); delta = { target: 'lane', baseVersion: context.lane.context.version, ops: changes?.ops.map((op) => op.op === 'set' ? { op: 'set', path: op.path, value: asJson(op.value) } : op.op === 'append' ? { op: 'append', path: op.path, value: asJson(op.value) } : { op: 'remove', path: op.path }) ?? [] }; },
@@ -539,7 +540,13 @@ export class StepBuilder {
             if (finishReason === 'tool_calls') {
                 if (turns >= maxTurns || toolCalls.length === 0)
                     return maxTurnsReached();
-                const invalidTool = toolCalls.find((call) => { const item = call && typeof call === 'object' && !Array.isArray(call) ? call : {}; const toolName = typeof item.name === 'string' ? item.name : ''; return !toolName || (options.toolAllow !== undefined && !options.toolAllow.includes(toolName)); });
+                const canonicalToolName = (name) => {
+                    if (options.toolAllow === undefined || options.toolAllow.includes(name))
+                        return name;
+                    const aliases = options.toolAllow.filter((allowed) => allowed.replaceAll('.', '_') === name);
+                    return aliases.length === 1 ? aliases[0] : undefined;
+                };
+                const invalidTool = toolCalls.find((call) => { const item = call && typeof call === 'object' && !Array.isArray(call) ? call : {}; const toolName = typeof item.name === 'string' ? item.name : ''; const canonical = canonicalToolName(toolName); return !toolName || canonical === undefined || (options.toolAllow !== undefined && !options.toolAllow.includes(canonical)); });
                 if (invalidTool !== undefined)
                     return fail({ code: 'ACTION_TOOL_NOT_ALLOWED', message: 'Model requested a tool outside the ReAct allow-list.', retryable: false });
                 const resolution = waitResolution(ctx.resumeInput);
@@ -551,74 +558,76 @@ export class StepBuilder {
                 const calls = toolCalls.map((call, index) => {
                     const item = call && typeof call === 'object' && !Array.isArray(call) ? call : {};
                     const originalId = typeof item.toolCallId === 'string' ? item.toolCallId : `call-${index + 1}`;
-                    const toolName = typeof item.name === 'string' ? item.name : '';
+                    const rawToolName = typeof item.name === 'string' ? item.name : '';
+                    const toolName = canonicalToolName(rawToolName);
                     return { originalId, toolName, toolCallId: options.scopeToolCallsToEffect ? `${name}:${sourceEffectId ?? 'turn'}:${turns}:${originalId}` : `${name}:${turns}:${originalId}`, input: item.input ?? {} };
                 });
                 const askCalls = calls.filter((call) => String(call.toolName).startsWith('ask.'));
                 if (askCalls.length > 0) {
                     if (askCalls.length !== calls.length)
                         return fail({ code: 'ASK_MIXED_TOOL_CALLS', message: 'An ask interaction must be requested in a separate model turn from workspace tools.', retryable: false });
-                    if (askCalls.length !== 1)
-                        return fail({ code: 'ASK_MULTIPLE_REQUESTS', message: 'Only one ask interaction may be requested at a time.', retryable: false });
-                    const call = askCalls[0];
-                    const rawInput = call.input && typeof call.input === 'object' && !Array.isArray(call.input) ? call.input : {};
-                    const askType = call.toolName === 'ask.choice' ? 'choice' : call.toolName === 'ask.multi' ? 'multi' : call.toolName === 'ask.input' ? 'input' : undefined;
-                    if (!askType)
-                        return fail({ code: 'ASK_TOOL_UNKNOWN', message: `Unknown ask tool ${String(call.toolName)}.`, retryable: false });
-                    if (typeof rawInput.prompt === 'string' && rawInput.prompt.length > 2_000)
-                        return fail({ code: 'ASK_PROMPT_TOO_LARGE', message: 'Ask prompts must be 2000 characters or fewer.', retryable: false });
-                    const prompt = typeof rawInput.prompt === 'string' && rawInput.prompt.trim() ? rawInput.prompt : `Pulse needs your input for ${askType}.`;
-                    const askInput = { kind: 'ask', type: askType, toolName: String(call.toolName), toolCallId: String(call.toolCallId), prompt };
-                    if (askType === 'choice' || askType === 'multi') {
-                        const rawOptions = Array.isArray(rawInput.options) ? rawInput.options : [];
-                        if (rawOptions.length > 50)
-                            return fail({ code: 'ASK_OPTIONS_TOO_MANY', message: 'ask.choice and ask.multi accept at most 50 options.', retryable: false });
-                        const seen = new Set();
-                        const options = rawOptions.flatMap((option) => {
-                            const item = typeof option === 'string' ? { label: option, value: option } : option && typeof option === 'object' && !Array.isArray(option) ? option : undefined;
-                            if (!item || typeof item.label !== 'string' || typeof item.value !== 'string')
-                                return [];
-                            if (item.label.length === 0 || item.label.length > 500 || item.value.length === 0 || item.value.length > 500 || seen.has(item.value))
-                                return [];
-                            seen.add(item.value);
-                            return [{ label: item.label, value: item.value }];
-                        });
-                        if (options.length === 0)
-                            return fail({ code: 'ASK_OPTIONS_REQUIRED', message: 'ask.choice and ask.multi require at least one valid option.', retryable: false });
-                        askInput.options = options;
-                        if (askType === 'multi') {
-                            const min = typeof rawInput.min === 'number' && Number.isInteger(rawInput.min) ? rawInput.min : undefined;
-                            const max = typeof rawInput.max === 'number' && Number.isInteger(rawInput.max) ? rawInput.max : undefined;
-                            if ((rawInput.min !== undefined && (min === undefined || min < 0)) || (rawInput.max !== undefined && (max === undefined || max < 1)) || (min !== undefined && max !== undefined && min > max))
-                                return fail({ code: 'ASK_RANGE_INVALID', message: 'ask.multi min and max must be integers with min <= max.', retryable: false });
-                            if (min !== undefined)
-                                askInput.min = min;
-                            if (max !== undefined)
-                                askInput.max = max;
-                        }
-                    }
-                    else {
-                        if (typeof rawInput.placeholder === 'string') {
-                            if (rawInput.placeholder.length > 500)
-                                return fail({ code: 'ASK_PROMPT_TOO_LARGE', message: 'Ask placeholders must be 500 characters or fewer.', retryable: false });
-                            askInput.placeholder = rawInput.placeholder;
+                    const askEffects = [];
+                    for (const [askIndex, call] of askCalls.entries()) {
+                        const rawInput = call.input && typeof call.input === 'object' && !Array.isArray(call.input) ? call.input : {};
+                        const askType = call.toolName === 'ask.choice' ? 'choice' : call.toolName === 'ask.multi' ? 'multi' : call.toolName === 'ask.input' ? 'input' : undefined;
+                        if (!askType)
+                            return fail({ code: 'ASK_TOOL_UNKNOWN', message: `Unknown ask tool ${String(call.toolName)}.`, retryable: false });
+                        if (typeof rawInput.prompt === 'string' && rawInput.prompt.length > 2_000)
+                            return fail({ code: 'ASK_PROMPT_TOO_LARGE', message: 'Ask prompts must be 2000 characters or fewer.', retryable: false });
+                        const prompt = typeof rawInput.prompt === 'string' && rawInput.prompt.trim() ? rawInput.prompt : `Pulse needs your input for ${askType}.`;
+                        const askInput = { kind: 'ask', type: askType, toolName: String(call.toolName), toolCallId: String(call.toolCallId), prompt };
+                        if (askType === 'choice' || askType === 'multi') {
+                            const rawOptions = Array.isArray(rawInput.options) ? rawInput.options : [];
+                            if (rawOptions.length > 50)
+                                return fail({ code: 'ASK_OPTIONS_TOO_MANY', message: 'ask.choice and ask.multi accept at most 50 options.', retryable: false });
+                            const seen = new Set();
+                            const options = rawOptions.flatMap((option) => {
+                                const item = typeof option === 'string' ? { label: option, value: option } : option && typeof option === 'object' && !Array.isArray(option) ? option : undefined;
+                                if (!item || typeof item.label !== 'string' || typeof item.value !== 'string')
+                                    return [];
+                                if (item.label.length === 0 || item.label.length > 500 || item.value.length === 0 || item.value.length > 500 || seen.has(item.value))
+                                    return [];
+                                seen.add(item.value);
+                                return [{ label: item.label, value: item.value }];
+                            });
+                            if (options.length === 0)
+                                return fail({ code: 'ASK_OPTIONS_REQUIRED', message: 'ask.choice and ask.multi require at least one valid option.', retryable: false });
+                            askInput.options = options;
+                            if (askType === 'multi') {
+                                const min = typeof rawInput.min === 'number' && Number.isInteger(rawInput.min) ? rawInput.min : undefined;
+                                const max = typeof rawInput.max === 'number' && Number.isInteger(rawInput.max) ? rawInput.max : undefined;
+                                if ((rawInput.min !== undefined && (min === undefined || min < 0)) || (rawInput.max !== undefined && (max === undefined || max < 1)) || (min !== undefined && max !== undefined && min > max))
+                                    return fail({ code: 'ASK_RANGE_INVALID', message: 'ask.multi min and max must be integers with min <= max.', retryable: false });
+                                if (min !== undefined)
+                                    askInput.min = min;
+                                if (max !== undefined)
+                                    askInput.max = max;
+                            }
                         }
-                        if (typeof rawInput.defaultValue === 'string') {
-                            if (rawInput.defaultValue.length > 2_000)
-                                return fail({ code: 'ASK_PROMPT_TOO_LARGE', message: 'Ask default values must be 2000 characters or fewer.', retryable: false });
-                            askInput.defaultValue = rawInput.defaultValue;
+                        else {
+                            if (typeof rawInput.placeholder === 'string') {
+                                if (rawInput.placeholder.length > 500)
+                                    return fail({ code: 'ASK_PROMPT_TOO_LARGE', message: 'Ask placeholders must be 500 characters or fewer.', retryable: false });
+                                askInput.placeholder = rawInput.placeholder;
+                            }
+                            if (typeof rawInput.defaultValue === 'string') {
+                                if (rawInput.defaultValue.length > 2_000)
+                                    return fail({ code: 'ASK_PROMPT_TOO_LARGE', message: 'Ask default values must be 2000 characters or fewer.', retryable: false });
+                                askInput.defaultValue = rawInput.defaultValue;
+                            }
                         }
+                        const humanEffect = {
+                            key: `${name}-ask-${turns}-${askIndex + 1}`,
+                            ...(sourceEffectId === undefined ? {} : { llmEffectId: sourceEffectId }),
+                            ...(sourcePrivacy === undefined ? {} : { privacy: sourcePrivacy }),
+                            ...(toolDerivedFrom.length ? { derivedFrom: [...toolDerivedFrom] } : {}),
+                            kind: 'human',
+                            concurrencyClass: 'none',
+                            input: askInput,
+                        };
+                        askEffects.push(humanEffect);
                     }
-                    const humanEffect = {
-                        key: `${name}-ask-${turns}`,
-                        ...(sourceEffectId === undefined ? {} : { llmEffectId: sourceEffectId }),
-                        ...(sourcePrivacy === undefined ? {} : { privacy: sourcePrivacy }),
-                        ...(toolDerivedFrom.length ? { derivedFrom: [...toolDerivedFrom] } : {}),
-                        kind: 'human',
-                        concurrencyClass: 'none',
-                        input: askInput,
-                    };
-                    return { actions: [{ type: 'submit_effects', effects: [humanEffect], wait: { onUnsatisfied: 'resume_with_error' } }], next: `${name}:tools`, locals: clearPendingResult(ctx) };
+                    return { actions: [{ type: 'submit_effects', effects: askEffects, wait: { onUnsatisfied: 'resume_with_error' } }], next: `${name}:tools`, locals: clearPendingResult(ctx) };
                 }
                 const makeToolEffects = (approvedCalls) => ({ type: 'submit_effects', effects: approvedCalls.map((call, index) => ({ key: `${name}-tool-${turns}-${index + 1}`, toolCallId: String(call.toolCallId ?? `${name}:${turns}:${String(call.originalId)}`), ...(sourceEffectId === undefined ? {} : { llmEffectId: sourceEffectId }), ...(sourcePrivacy === undefined ? {} : { privacy: sourcePrivacy }), ...(toolDerivedFrom.length ? { derivedFrom: [...toolDerivedFrom] } : {}), kind: 'tool', concurrencyClass: 'tool', input: { toolCallId: String(call.toolCallId ?? `${name}:${turns}:${String(call.originalId)}`), name: String(call.toolName), arguments: call.input, ...(sourcePrivacy === undefined ? {} : { privacy: sourcePrivacy }), ...(toolDerivedFrom.length ? { derivedFrom: [...toolDerivedFrom] } : {}) } })), wait: { onUnsatisfied: 'resume_with_error' } });
                 const dispatchTools = (action, locals) => {

package/dist/transitions/validate.js

@@ -1006,6 +1006,11 @@ export function validateStep(state, laneId, output) {
                         ownerCopy.visibleResultRefs.add(resultId);
                     else
                         ownerCopy.visibleResultRefs = new Set([resultId]);
+                    for (const source of action.derivedFrom ?? []) {
+                        const ref = typeof source === 'string' ? (source.startsWith('result-') ? source : undefined) : source.kind === 'result' ? source.ref : undefined;
+                        if (ref)
+                            ownerCopy.visibleResultRefs.add(ref);
+                    }
                     mutations.push({ op: 'setLane', laneId: owner.id, record: ownerCopy });
                 }
             }

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@hunterzhu/pulse-runtime",
-  "version": "0.3.0",
+  "version": "0.4.1",
+  "license": "PolyForm-Noncommercial-1.0.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/zhuhengtan/Pulse"