@hunterzhu/pulse-server 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 import { type JsonValue, type Outcome } from '@hunterzhu/pulse-runtime';
 import { type ProviderPresetConfig } from '@hunterzhu/pulse-adapters';
+export { legacyPulseDataPath, pulseDataPath, pulseHomePath, pulseLogPath } from './paths.js';
 export type ApprovalMode = 'read-only' | 'ask' | 'auto';
 export interface LocalHostOptions {
     cwd?: string;
     dataDir?: string;
+    logDir?: string;
     provider?: ProviderPresetConfig;
     mockResponse?: string;
     mockToolCalls?: Array<{
@@ -67,11 +69,15 @@ export interface ConversationHandle {
 export declare class LocalHost {
     private readonly root;
     private readonly dataDir;
+    private readonly logDir;
+    private readonly usesDefaultDataDir;
+    private readonly shouldMigrateLegacyData;
     private readonly options;
     private readonly approvedToolCalls;
     private readonly active;
     private readonly conversationLocks;
     constructor(options?: LocalHostOptions);
+    private migrateLegacyData;
     init(): Promise<void>;
     private conversationDir;
     private manifestPath;

package/dist/index.js

@@ -1,12 +1,13 @@
 import { randomUUID } from 'node:crypto';
-import { mkdir, open, readFile, readdir, rm, stat, writeFile } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
-import { homedir } from 'node:os';
+import { mkdir, open, readFile, readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
 import { z } from 'zod';
 import { assertPublicNetworkUrl, conversationDirectory, publicUrl, safeShellEnv, searchFiles, within } from './security.js';
 import { FileRuntimePersistenceBackend, ModelRouter, InMemoryModelRegistry, PulseRuntime, defineReActLane, } from '@hunterzhu/pulse-runtime';
 import { createModelEffectExecutor, createProviderAdapter, createToolEffectExecutor, createToolEffectSubmissionPreparer, MockAdapter, runShell, FilesystemTool, } from '@hunterzhu/pulse-adapters';
 import { defineTool, ToolRegistry } from '@hunterzhu/pulse-tool-sdk';
+import { legacyPulseDataPath, pulseDataPath, pulseLogPath } from './paths.js';
+export { legacyPulseDataPath, pulseDataPath, pulseHomePath, pulseLogPath } from './paths.js';
 const textLimit = 48_000;
 const json = (value) => {
     if (value === null || typeof value === 'string' || typeof value === 'boolean')
@@ -92,8 +93,8 @@ function registerBuiltIns(registry, root, approvalMode, allowNetwork = false, is
         }));
     }
 }
-function buildProgram(toolNames) {
-    return (approvalMode = 'ask') => defineReActLane({ id: 'pulse.assistant', version: '1', system: 'You are Pulse, a careful general task assistant. Use available tools when they help. Explain what you did and cite workspace paths. Never claim an action succeeded unless its tool result confirms it.', toolSet: 'pulse.default', task: 'reason', instruction: ({ goal }) => goal, toolAllow: toolNames, maxTurns: 12, ...(approvalMode === 'ask' ? { toolApproval: { prompt: () => 'Reply with approved=true to continue or approved=false to deny.' } } : {}) });
+function buildProgram(toolNames, workspace) {
+    return (approvalMode = 'ask') => defineReActLane({ id: 'pulse.assistant', version: '1', system: `You are Pulse, a careful general task assistant. The current workspace is ${workspace}. When the user asks about the project, files, code, or directory contents, use the provided filesystem tools to inspect the workspace before answering. Paths passed to filesystem tools are relative to this workspace unless the tool says otherwise. Explain what you did and cite workspace paths. Never claim an action succeeded unless its tool result confirms it.`, toolSet: 'pulse.default', task: 'reason', instruction: ({ goal }) => goal, inputs: () => ({ toolDiscovery: { limit: toolNames.length } }), toolAllow: toolNames, maxTurns: 12, ...(approvalMode === 'ask' ? { toolApproval: { prompt: () => 'Reply with approved=true to continue or approved=false to deny.' } } : {}) });
 }
 function providerFromOptions(options) {
     const config = options.provider ?? { provider: 'mock', defaultModel: 'mock' };
@@ -110,12 +111,48 @@ function providerFromOptions(options) {
 export class LocalHost {
     root;
     dataDir;
+    logDir;
+    usesDefaultDataDir;
+    shouldMigrateLegacyData;
     options;
     approvedToolCalls = new Map();
     active = new Map();
     conversationLocks = new Map();
-    constructor(options = {}) { this.root = resolve(options.cwd ?? process.cwd()); this.dataDir = resolve(options.dataDir ?? process.env.PULSE_DATA_DIR ?? join(homedir(), '.local', 'share', 'pulse')); this.options = options; }
-    async init() { await mkdir(this.dataDir, { recursive: true }); await stat(this.root); }
+    constructor(options = {}) {
+        this.root = resolve(options.cwd ?? process.cwd());
+        this.usesDefaultDataDir = options.dataDir === undefined && process.env.PULSE_DATA_DIR === undefined;
+        this.shouldMigrateLegacyData = this.usesDefaultDataDir && process.env.PULSE_HOME === undefined;
+        this.dataDir = resolve(options.dataDir ?? process.env.PULSE_DATA_DIR ?? pulseDataPath());
+        this.logDir = resolve(options.logDir ?? process.env.PULSE_LOG_DIR ?? pulseLogPath());
+        this.options = options;
+    }
+    async migrateLegacyData() {
+        if (!this.shouldMigrateLegacyData)
+            return;
+        const legacy = resolve(legacyPulseDataPath());
+        if (legacy === this.dataDir)
+            return;
+        try {
+            await stat(this.dataDir);
+            return;
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+        try {
+            await stat(legacy);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+        await mkdir(dirname(this.dataDir), { recursive: true });
+        await rename(legacy, this.dataDir);
+    }
+    async init() { await this.migrateLegacyData(); await mkdir(this.dataDir, { recursive: true }); if (this.usesDefaultDataDir || this.options.logDir !== undefined || process.env.PULSE_LOG_DIR !== undefined)
+        await mkdir(this.logDir, { recursive: true }); await stat(this.root); }
     conversationDir(id) { return conversationDirectory(this.dataDir, id); }
     manifestPath(id) { return join(this.conversationDir(id), 'manifest.json'); }
     messagesPath(id) { return join(this.conversationDir(id), 'messages.jsonl'); }
@@ -205,7 +242,7 @@ export class LocalHost {
         router.register({ task: 'plan', candidates: [provider.model.id] });
         router.register({ task: 'merge', candidates: [provider.model.id] });
         const backend = new FileRuntimePersistenceBackend(join(this.runDir(conversationId, runId), 'runtime.json'));
-        const program = buildProgram(registry.list().map((tool) => tool.name))(this.options.approvalMode ?? 'ask');
+        const program = buildProgram(registry.list().map((tool) => tool.name), cwd)(this.options.approvalMode ?? 'ask');
         const toolVersions = Object.fromEntries(registry.list().map((tool) => [tool.name, tool.version]));
         const runtime = await PulseRuntime.restore(backend, { sessionId: runId, maxRuntimeMs: this.options.maxRuntimeMs ?? 15 * 60_000, programs: [program], models, modelRouter: router, toolVersions, builtinHumanEffects: true, effectExecutor: async (effect, signal, observe) => { if (effect.kind === 'llm')
                 return createModelEffectExecutor({ router, providers: new Map([[provider.adapter.id, provider.adapter]]) })(effect, signal, observe); if (effect.kind === 'tool')
@@ -253,7 +290,7 @@ export class LocalHost {
             await mkdir(this.runDir(conversationId, runId), { recursive: true });
             await writeFile(join(this.runDir(conversationId, runId), 'input.json'), JSON.stringify({ schemaVersion: 1, conversationId, runId, goal: input.text, cwd: manifest.cwd, provider: this.options.provider?.provider ?? 'mock', approvalMode: this.options.approvalMode ?? 'ask', createdAt: now }, null, 2));
             const { runtime, registry } = this.runtimeFor(conversationId, runId, manifest.cwd);
-            const program = buildProgram(registry.list().map((tool) => tool.name))(this.options.approvalMode ?? 'ask');
+            const program = buildProgram(registry.list().map((tool) => tool.name), manifest.cwd)(this.options.approvalMode ?? 'ask');
             runtime.register(program);
             const { agentId } = runtime.createAgent({ goal, program });
             const session = runtime.start(agentId);

package/dist/paths.d.ts

@@ -0,0 +1,6 @@
+/** The single user-level root shared by CLI, server, desktop, and web runtimes. */
+export declare function pulseHomePath(): string;
+export declare function pulseDataPath(): string;
+export declare function pulseLogPath(): string;
+/** The pre-.pulse location used by releases before the unified layout. */
+export declare function legacyPulseDataPath(): string;

package/dist/paths.js

@@ -0,0 +1,16 @@
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+/** The single user-level root shared by CLI, server, desktop, and web runtimes. */
+export function pulseHomePath() {
+    return resolve(process.env.PULSE_HOME ?? join(homedir(), '.pulse'));
+}
+export function pulseDataPath() {
+    return join(pulseHomePath(), 'data');
+}
+export function pulseLogPath() {
+    return resolve(process.env.PULSE_LOG_DIR ?? join(pulseHomePath(), 'logs'));
+}
+/** The pre-.pulse location used by releases before the unified layout. */
+export function legacyPulseDataPath() {
+    return join(homedir(), '.local', 'share', 'pulse');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunterzhu/pulse-server",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/zhuhengtan/Pulse"
@@ -16,9 +16,9 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@hunterzhu/pulse-adapters": "0.1.2",
-    "@hunterzhu/pulse-runtime": "0.1.2",
-    "@hunterzhu/pulse-tool-sdk": "0.1.2",
+    "@hunterzhu/pulse-adapters": "0.1.3",
+    "@hunterzhu/pulse-runtime": "0.1.3",
+    "@hunterzhu/pulse-tool-sdk": "0.1.3",
     "zod": "^3.24.1"
   }
 }