bkper 4.12.3 → 4.12.5

package/README.md

@@ -115,7 +115,7 @@ bkper agent install <pi-package-source>
 bkper agent --help
 ```
 
-`bkper agent` keeps Bkper defaults (appending Bkper domain context to Pi's default prompt) unless you explicitly pass `--system-prompt`.
+`bkper agent` keeps Bkper defaults (including the Bkper system prompt) unless you explicitly pass `--system-prompt`.
 Use `bkper help agent` for the Bkper CLI command help, and `bkper agent --help` for Pi help.
 
 For all available passthrough flags and commands, see the Pi CLI reference:
@@ -871,7 +871,7 @@ deployment:
 #### Agent
 
 -   `agent` - Start the interactive Bkper Agent
--   `agent <pi-args...>` - Run Pi CLI with Bkper defaults (domain context/resources)
+-   `agent <pi-args...>` - Run Pi CLI with Bkper defaults (system prompt/resources)
 
 #### App Lifecycle
 

package/lib/agent/run-agent-mode.d.ts

@@ -1,7 +1,6 @@
+import { InteractiveMode } from '@mariozechner/pi-coding-agent';
 import { runStartupMaintenance } from './startup-maintenance.js';
-type ReloadableResourceLoader = {
-    reload(): Promise<void>;
-};
+export type InteractiveRuntimeHost = ConstructorParameters<typeof InteractiveMode>[0];
 type NotificationType = 'info' | 'warning' | 'error';
 type SessionStartContext = {
     ui: {
@@ -13,18 +12,14 @@ type StartupExtensionAPI = {
     on: (event: 'session_start', handler: SessionStartHandler) => void;
 };
 export interface AgentModeDependencies {
-    createResourceLoader: () => ReloadableResourceLoader;
-    createSession: (options: {
-        resourceLoader: ReloadableResourceLoader;
-    }) => Promise<{
-        session: unknown;
+    createRuntime: () => Promise<{
+        runtime: InteractiveRuntimeHost;
         modelFallbackMessage?: string;
     }>;
-    createInteractiveMode: (session: unknown, modelFallbackMessage?: string) => {
+    createInteractiveMode: (runtime: InteractiveRuntimeHost, modelFallbackMessage?: string) => {
         run(): Promise<void>;
     };
 }
-export declare function appendBkperAgentPrompt(base: string[]): string[];
 export declare function registerBkperAgentStartupExtension(pi: StartupExtensionAPI, startupMaintenance?: typeof runStartupMaintenance): void;
 export declare function runAgentMode(dependencies?: AgentModeDependencies): Promise<void>;
 export {};

package/lib/agent/run-agent-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-agent-mode.d.ts","sourceRoot":"","sources":["../../src/agent/run-agent-mode.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,KAAK,wBAAwB,GAAG;IAC5B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF,KAAK,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErD,KAAK,mBAAmB,GAAG;IACvB,EAAE,EAAE;QACA,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;KAC9D,CAAC;CACL,CAAC;AAEF,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3F,KAAK,mBAAmB,GAAG;IACvB,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,MAAM,WAAW,qBAAqB;IAClC,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;IACrD,aAAa,EAAE,CAAC,OAAO,EAAE;QACrB,cAAc,EAAE,wBAAwB,CAAC;KAC5C,KAAK,OAAO,CAAC;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC,CAAC;IACH,qBAAqB,EAAE,CACnB,OAAO,EAAE,OAAO,EAChB,oBAAoB,CAAC,EAAE,MAAM,KAC5B;QACD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACxB,CAAC;CACL;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE/D;AAED,wBAAgB,kCAAkC,CAC9C,EAAE,EAAE,mBAAmB,EACvB,kBAAkB,GAAE,OAAO,qBAA6C,GACzE,IAAI,CAeN;AAyBD,wBAAsB,YAAY,CAC9B,YAAY,GAAE,qBAAmD,GAClE,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"run-agent-mode.d.ts","sourceRoot":"","sources":["../../src/agent/run-agent-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,eAAe,EAIlB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtF,KAAK,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErD,KAAK,mBAAmB,GAAG;IACvB,EAAE,EAAE;QACA,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;KAC9D,CAAC;CACL,CAAC;AAEF,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3F,KAAK,mBAAmB,GAAG;IACvB,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,MAAM,WAAW,qBAAqB;IAClC,aAAa,EAAE,MAAM,OAAO,CAAC;QACzB,OAAO,EAAE,sBAAsB,CAAC;QAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC,CAAC;IACH,qBAAqB,EAAE,CACnB,OAAO,EAAE,sBAAsB,EAC/B,oBAAoB,CAAC,EAAE,MAAM,KAC5B;QACD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACxB,CAAC;CACL;AAED,wBAAgB,kCAAkC,CAC9C,EAAE,EAAE,mBAAmB,EACvB,kBAAkB,GAAE,OAAO,qBAA6C,GACzE,IAAI,CAeN;AAqDD,wBAAsB,YAAY,CAC9B,YAAY,GAAE,qBAAmD,GAClE,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/lib/agent/run-agent-mode.js

@@ -7,12 +7,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { createAgentSession, DefaultResourceLoader, InteractiveMode, } from '@mariozechner/pi-coding-agent';
+import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, getAgentDir, InteractiveMode, SessionManager, } from '@mariozechner/pi-coding-agent';
 import { runStartupMaintenance } from './startup-maintenance.js';
-import { getBkperAgentAppendPrompt } from './system-prompt.js';
-export function appendBkperAgentPrompt(base) {
-    return [...base, getBkperAgentAppendPrompt()];
-}
+import { getBkperAgentSystemPrompt } from './system-prompt.js';
 export function registerBkperAgentStartupExtension(pi, startupMaintenance = runStartupMaintenance) {
     let startupMaintenanceTriggered = false;
     pi.on('session_start', (_event, ctx) => __awaiter(this, void 0, void 0, function* () {
@@ -28,20 +25,37 @@ export function registerBkperAgentStartupExtension(pi, startupMaintenance = runS
 }
 function createDefaultDependencies() {
     return {
-        createResourceLoader: () => new DefaultResourceLoader({
-            appendSystemPromptOverride: appendBkperAgentPrompt,
-            extensionFactories: [
-                (pi) => {
-                    registerBkperAgentStartupExtension(pi);
-                },
-            ],
-        }),
-        createSession: (_a) => __awaiter(this, [_a], void 0, function* ({ resourceLoader }) {
-            return createAgentSession({
-                resourceLoader: resourceLoader,
+        createRuntime: () => __awaiter(this, void 0, void 0, function* () {
+            const createRuntime = (_a) => __awaiter(this, [_a], void 0, function* ({ cwd, agentDir, sessionManager, sessionStartEvent, }) {
+                const services = yield createAgentSessionServices({
+                    cwd,
+                    agentDir,
+                    resourceLoaderOptions: {
+                        systemPromptOverride: () => getBkperAgentSystemPrompt(),
+                        extensionFactories: [
+                            (pi) => {
+                                registerBkperAgentStartupExtension(pi);
+                            },
+                        ],
+                    },
+                });
+                return Object.assign(Object.assign({}, (yield createAgentSessionFromServices({
+                    services,
+                    sessionManager,
+                    sessionStartEvent,
+                }))), { services, diagnostics: services.diagnostics });
+            });
+            const runtime = yield createAgentSessionRuntime(createRuntime, {
+                cwd: process.cwd(),
+                agentDir: getAgentDir(),
+                sessionManager: SessionManager.create(process.cwd()),
             });
+            return {
+                runtime,
+                modelFallbackMessage: runtime.modelFallbackMessage,
+            };
         }),
-        createInteractiveMode: (session, modelFallbackMessage) => new InteractiveMode(session, {
+        createInteractiveMode: (runtime, modelFallbackMessage) => new InteractiveMode(runtime, {
             modelFallbackMessage,
         }),
     };
@@ -51,10 +65,8 @@ export function runAgentMode() {
         var _a;
         var _b;
         (_a = (_b = process.env).PI_SKIP_VERSION_CHECK) !== null && _a !== void 0 ? _a : (_b.PI_SKIP_VERSION_CHECK = '1');
-        const resourceLoader = dependencies.createResourceLoader();
-        yield resourceLoader.reload();
-        const { session, modelFallbackMessage } = yield dependencies.createSession({ resourceLoader });
-        const mode = dependencies.createInteractiveMode(session, modelFallbackMessage);
+        const { runtime, modelFallbackMessage } = yield dependencies.createRuntime();
+        const mode = dependencies.createInteractiveMode(runtime, modelFallbackMessage);
         yield mode.run();
     });
 }

package/lib/agent/run-agent-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-agent-mode.js","sourceRoot":"","sources":["../../src/agent/run-agent-mode.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACH,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,GAGlB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAoC/D,MAAM,UAAU,sBAAsB,CAAC,IAAc;IACjD,OAAO,CAAC,GAAG,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,kCAAkC,CAC9C,EAAuB,EACvB,qBAAmD,qBAAqB;IAExE,IAAI,2BAA2B,GAAG,KAAK,CAAC;IAExC,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAO,MAAM,EAAE,GAAG,EAAE,EAAE;QACzC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QAE5C,IAAI,2BAA2B,EAAE,CAAC;YAC9B,OAAO;QACX,CAAC;QACD,2BAA2B,GAAG,IAAI,CAAC;QAEnC,KAAK,kBAAkB,CAAC;YACpB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;SAC1D,CAAC,CAAC;IACP,CAAC,CAAA,CAAC,CAAC;AACP,CAAC;AAED,SAAS,yBAAyB;IAC9B,OAAO;QACH,oBAAoB,EAAE,GAAG,EAAE,CACvB,IAAI,qBAAqB,CAAC;YACtB,0BAA0B,EAAE,sBAAsB;YAClD,kBAAkB,EAAE;gBAChB,CAAC,EAAgB,EAAE,EAAE;oBACjB,kCAAkC,CAAC,EAAE,CAAC,CAAC;gBAC3C,CAAC;aACJ;SACJ,CAAC;QACN,aAAa,EAAE,KAA2B,EAAE,0CAAtB,EAAE,cAAc,EAAE;YACpC,OAAA,kBAAkB,CAAC;gBACf,cAAc,EACV,cAA0E;aACjF,CAAC,CAAA;UAAA;QACN,qBAAqB,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,CACrD,IAAI,eAAe,CAAC,OAA2D,EAAE;YAC7E,oBAAoB;SACvB,CAAC;KACT,CAAC;AACN,CAAC;AAED,MAAM,UAAgB,YAAY;yDAC9B,eAAsC,yBAAyB,EAAE;;;QAEjE,YAAA,OAAO,CAAC,GAAG,EAAC,qBAAqB,uCAArB,qBAAqB,GAAK,GAAG,EAAC;QAE1C,MAAM,cAAc,GAAG,YAAY,CAAC,oBAAoB,EAAE,CAAC;QAC3D,MAAM,cAAc,CAAC,MAAM,EAAE,CAAC;QAE9B,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;QAC/F,MAAM,IAAI,GAAG,YAAY,CAAC,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAE/E,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC;CAAA"}
+{"version":3,"file":"run-agent-mode.js","sourceRoot":"","sources":["../../src/agent/run-agent-mode.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACH,8BAA8B,EAC9B,yBAAyB,EACzB,0BAA0B,EAC1B,WAAW,EACX,eAAe,EACf,cAAc,GAGjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AA+B/D,MAAM,UAAU,kCAAkC,CAC9C,EAAuB,EACvB,qBAAmD,qBAAqB;IAExE,IAAI,2BAA2B,GAAG,KAAK,CAAC;IAExC,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,CAAO,MAAM,EAAE,GAAG,EAAE,EAAE;QACzC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QAE5C,IAAI,2BAA2B,EAAE,CAAC;YAC9B,OAAO;QACX,CAAC;QACD,2BAA2B,GAAG,IAAI,CAAC;QAEnC,KAAK,kBAAkB,CAAC;YACpB,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;SAC1D,CAAC,CAAC;IACP,CAAC,CAAA,CAAC,CAAC;AACP,CAAC;AAED,SAAS,yBAAyB;IAC9B,OAAO;QACH,aAAa,EAAE,GAAS,EAAE;YACtB,MAAM,aAAa,GAAqC,KAKrD,EAAE,0CAL0D,EAC3D,GAAG,EACH,QAAQ,EACR,cAAc,EACd,iBAAiB,GACpB;gBACG,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;oBAC9C,GAAG;oBACH,QAAQ;oBACR,qBAAqB,EAAE;wBACnB,oBAAoB,EAAE,GAAG,EAAE,CAAC,yBAAyB,EAAE;wBACvD,kBAAkB,EAAE;4BAChB,CAAC,EAAgB,EAAE,EAAE;gCACjB,kCAAkC,CAAC,EAAE,CAAC,CAAC;4BAC3C,CAAC;yBACJ;qBACJ;iBACJ,CAAC,CAAC;gBAEH,uCACO,CAAC,MAAM,8BAA8B,CAAC;oBACrC,QAAQ;oBACR,cAAc;oBACd,iBAAiB;iBACpB,CAAC,CAAC,KACH,QAAQ,EACR,WAAW,EAAE,QAAQ,CAAC,WAAW,IACnC;YACN,CAAC,CAAA,CAAC;YAEF,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,aAAa,EAAE;gBAC3D,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;gBAClB,QAAQ,EAAE,WAAW,EAAE;gBACvB,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;aACvD,CAAC,CAAC;YAEH,OAAO;gBACH,OAAO;gBACP,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;aACrD,CAAC;QACN,CAAC,CAAA;QACD,qBAAqB,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,CACrD,IAAI,eAAe,CAAC,OAAO,EAAE;YACzB,oBAAoB;SACvB,CAAC;KACT,CAAC;AACN,CAAC;AAED,MAAM,UAAgB,YAAY;yDAC9B,eAAsC,yBAAyB,EAAE;;;QAEjE,YAAA,OAAO,CAAC,GAAG,EAAC,qBAAqB,uCAArB,qBAAqB,GAAK,GAAG,EAAC;QAE1C,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAG,YAAY,CAAC,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAE/E,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC;CAAA"}

package/lib/agent/system-prompt.d.ts

@@ -1,3 +1,3 @@
-export declare function getBkperAgentAppendPrompt(): string;
-export declare const BKPER_AGENT_APPEND_PROMPT = "# Bkper Context\n\nYou are a Bkper team member.\n\nFor normal Bkper work, prioritize Bkper domain context, local project instructions, and surrounding files over Pi customization topics. Pi documentation is relevant only when the task is specifically about Pi itself or its runtime or customization.\n\n## Operating Principles\n\n- Protect the zero-sum invariant above all else.\n- Preserve invariants and data integrity first, then user intent, then implementation convenience.\n- Think in resources, movements, and balances \u2014 not debits and credits.\n- Extend meaning with properties before adding structural complexity.\n- Model domain and flows before coding; represent business reality, not technical shortcuts.\n- Prefer simplicity over cleverness; choose small, boring, maintainable solutions.\n- Question the premise before adding complexity; prefer simplifying or removing over layering new structure.\n- Design for global readiness from day one: currencies, timezones, units, and formats.\n- Treat performance and security as foundational concerns.\n- For conceptual questions, answer directly and concisely before reaching for tools.\n";
+export declare function getBkperAgentSystemPrompt(): string;
+export declare const BKPER_AGENT_SYSTEM_PROMPT = "# Bkper Context\n\nYou are a Bkper team member.\n\nProtect the zero-sum invariant above all else.\n\nYou help users by reading files, executing commands, editing code, and writing new files.\n\nAvailable tools:\n- read: read file contents\n- bash: run shell commands for search and discovery\n- edit: make precise file edits\n- write: create or replace files\n\nGuidelines:\n- Use bash for discovery and search like ls, rg, and find. Use it to run bkper CLI commands when relevant.\n- Use read to inspect file contents instead of cat or sed.\n- Use edit for precise changes.\n- When changing multiple separate locations in one file, use one edit call with multiple entries in edits[].\n- Each edits[].oldText is matched against the original file, not after earlier edits are applied. Do not use overlapping or nested edits. Merge nearby changes into one edit.\n- Keep edits[].oldText as small as possible while still being unique in the file.\n- Use write only for new files or complete rewrites.\n- Do not claim builds, tests, or command results unless you actually ran them.\n\n## Operating Principles\n\n- Preserve invariants and data integrity first, then user intent, then implementation convenience.\n- Think in resources, movements, and balances \u2014 not debits and credits.\n- Extend meaning with properties before adding structural complexity.\n- Model domain and flows before coding; represent business reality, not technical shortcuts.\n- Prefer simplicity over cleverness; choose small, boring, maintainable solutions.\n- Design for global readiness from day one: currencies, timezones, units, and formats.\n";
 //# sourceMappingURL=system-prompt.d.ts.map

package/lib/agent/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/agent/system-prompt.ts"],"names":[],"mappings":"AAaA,wBAAgB,yBAAyB,IAAI,MAAM,CAuBlD;AAED,eAAO,MAAM,yBAAyB,ooCAkBrC,CAAC"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/agent/system-prompt.ts"],"names":[],"mappings":"AAaA,wBAAgB,yBAAyB,IAAI,MAAM,CAsBlD;AAED,eAAO,MAAM,yBAAyB,2lDAgCrC,CAAC"}

package/lib/agent/system-prompt.js

@@ -8,10 +8,10 @@ function resolveCoreConceptsPath() {
     const thisDir = path.dirname(fileURLToPath(import.meta.url));
     return path.resolve(thisDir, '..', 'docs', 'core-concepts.md');
 }
-export function getBkperAgentAppendPrompt() {
+export function getBkperAgentSystemPrompt() {
     const cliRefPath = resolveCliReferencePath();
     const coreConceptsPath = resolveCoreConceptsPath();
-    return `${BKPER_AGENT_APPEND_PROMPT}
+    return `${BKPER_AGENT_SYSTEM_PROMPT}
 ## Reference Routing
 
 - Read local \`AGENTS.md\`, nearby files, and existing tests first for project-specific work.
@@ -27,28 +27,41 @@ ${coreConceptsPath}
 ${cliRefPath}
 \`\`\`
 
-- Read Pi documentation only when the task is specifically about Pi itself: prompt behavior, extensions, skills, themes, TUI, SDK, custom tools, model/provider integration, or other Pi runtime customization.
-- For generic engineering work, do not load Bkper or Pi reference docs unless directly relevant.
+- For generic engineering work, do not load Bkper reference docs unless directly relevant.
 - When scope is unclear, inspect local files and project instructions first; load reference docs only after identifying a concrete need.
 `;
 }
-export const BKPER_AGENT_APPEND_PROMPT = `# Bkper Context
+export const BKPER_AGENT_SYSTEM_PROMPT = `# Bkper Context
 
 You are a Bkper team member.
 
-For normal Bkper work, prioritize Bkper domain context, local project instructions, and surrounding files over Pi customization topics. Pi documentation is relevant only when the task is specifically about Pi itself or its runtime or customization.
+Protect the zero-sum invariant above all else.
+
+You help users by reading files, executing commands, editing code, and writing new files.
+
+Available tools:
+- read: read file contents
+- bash: run shell commands for search and discovery
+- edit: make precise file edits
+- write: create or replace files
+
+Guidelines:
+- Use bash for discovery and search like ls, rg, and find. Use it to run bkper CLI commands when relevant.
+- Use read to inspect file contents instead of cat or sed.
+- Use edit for precise changes.
+- When changing multiple separate locations in one file, use one edit call with multiple entries in edits[].
+- Each edits[].oldText is matched against the original file, not after earlier edits are applied. Do not use overlapping or nested edits. Merge nearby changes into one edit.
+- Keep edits[].oldText as small as possible while still being unique in the file.
+- Use write only for new files or complete rewrites.
+- Do not claim builds, tests, or command results unless you actually ran them.
 
 ## Operating Principles
 
-- Protect the zero-sum invariant above all else.
 - Preserve invariants and data integrity first, then user intent, then implementation convenience.
 - Think in resources, movements, and balances — not debits and credits.
 - Extend meaning with properties before adding structural complexity.
 - Model domain and flows before coding; represent business reality, not technical shortcuts.
 - Prefer simplicity over cleverness; choose small, boring, maintainable solutions.
-- Question the premise before adding complexity; prefer simplifying or removing over layering new structure.
 - Design for global readiness from day one: currencies, timezones, units, and formats.
-- Treat performance and security as foundational concerns.
-- For conceptual questions, answer directly and concisely before reaching for tools.
 `;
 //# sourceMappingURL=system-prompt.js.map

package/lib/agent/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/agent/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,uBAAuB;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,uBAAuB;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,yBAAyB;IACrC,MAAM,UAAU,GAAG,uBAAuB,EAAE,CAAC;IAC7C,MAAM,gBAAgB,GAAG,uBAAuB,EAAE,CAAC;IACnD,OAAO,GAAG,yBAAyB;;;;;;;EAOrC,gBAAgB;;;;;;EAMhB,UAAU;;;;;;CAMX,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;CAkBxC,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/agent/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,uBAAuB;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,uBAAuB;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,yBAAyB;IACrC,MAAM,UAAU,GAAG,uBAAuB,EAAE,CAAC;IAC7C,MAAM,gBAAgB,GAAG,uBAAuB,EAAE,CAAC;IACnD,OAAO,GAAG,yBAAyB;;;;;;;EAOrC,gBAAgB;;;;;;EAMhB,UAAU;;;;;CAKX,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCxC,CAAC"}

package/lib/commands/agent-command.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { main as runPiMain } from '@mariozechner/pi-coding-agent';
 import { runAgentMode } from '../agent/run-agent-mode.js';
-import { getBkperAgentAppendPrompt } from '../agent/system-prompt.js';
+import { getBkperAgentSystemPrompt } from '../agent/system-prompt.js';
 function createDefaultDependencies() {
     return {
         runPi: (args) => runPiMain(args),
@@ -23,7 +23,7 @@ function buildPiArgs(args) {
     if (hasSystemPromptArg(args)) {
         return args;
     }
-    return ['--append-system-prompt', getBkperAgentAppendPrompt(), ...args];
+    return ['--system-prompt', getBkperAgentSystemPrompt(), ...args];
 }
 export function runAgentCommand(piArgs_1) {
     return __awaiter(this, arguments, void 0, function* (piArgs, dependencies = createDefaultDependencies()) {

package/lib/commands/agent-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-command.js","sourceRoot":"","sources":["../../src/commands/agent-command.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAOtE,SAAS,yBAAyB;IAC9B,OAAO;QACH,KAAK,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1C,kBAAkB,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE;KAC3C,CAAC;AACN,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAc;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,iBAAiB,IAAI,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,WAAW,CAAC,IAAc;IAC/B,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,wBAAwB,EAAE,yBAAyB,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAgB,eAAe;yDACjC,MAAgB,EAChB,eAAyC,yBAAyB,EAAE;QAEpE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,YAAY,CAAC,kBAAkB,EAAE,CAAC;YACxC,OAAO;QACX,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CAAA;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IAClD,OAAO;SACF,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,qDAAqD,CAAC;SAClE,kBAAkB,CAAC,IAAI,CAAC;SACxB,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"agent-command.js","sourceRoot":"","sources":["../../src/commands/agent-command.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAOtE,SAAS,yBAAyB;IAC9B,OAAO;QACH,KAAK,EAAE,CAAC,IAAc,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1C,kBAAkB,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE;KAC3C,CAAC;AACN,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAc;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,iBAAiB,IAAI,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,WAAW,CAAC,IAAc;IAC/B,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,iBAAiB,EAAE,yBAAyB,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAgB,eAAe;yDACjC,MAAgB,EAChB,eAAyC,yBAAyB,EAAE;QAEpE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,YAAY,CAAC,kBAAkB,EAAE,CAAC;YACxC,OAAO;QACX,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CAAA;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IAClD,OAAO;SACF,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,qDAAqD,CAAC;SAClE,kBAAkB,CAAC,IAAI,CAAC;SACxB,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/lib/docs/cli-reference.md

@@ -115,7 +115,7 @@ bkper agent install <pi-package-source>
 bkper agent --help
 ```
 
-`bkper agent` keeps Bkper defaults (appending Bkper domain context to Pi's default prompt) unless you explicitly pass `--system-prompt`.
+`bkper agent` keeps Bkper defaults (including the Bkper system prompt) unless you explicitly pass `--system-prompt`.
 Use `bkper help agent` for the Bkper CLI command help, and `bkper agent --help` for Pi help.
 
 For all available passthrough flags and commands, see the Pi CLI reference:
@@ -871,7 +871,7 @@ deployment:
 #### Agent
 
 -   `agent` - Start the interactive Bkper Agent
--   `agent <pi-args...>` - Run Pi CLI with Bkper defaults (domain context/resources)
+-   `agent <pi-args...>` - Run Pi CLI with Bkper defaults (system prompt/resources)
 
 #### App Lifecycle
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper",
-    "version": "4.12.3",
+    "version": "4.12.5",
     "description": "Command line client for Bkper",
     "bin": {
         "bkper": "./lib/cli.js"
@@ -47,7 +47,7 @@
         "upgrade:api": "bun update @bkper/bkper-api-types --latest && bun update bkper-js --latest"
     },
     "dependencies": {
-        "@mariozechner/pi-coding-agent": "^0.64.0",
+        "@mariozechner/pi-coding-agent": "^0.65.2",
         "bkper-js": "^2.32.1",
         "commander": "^13.1.0",
         "dotenv": "^8.2.0",