@topce/pizx 0.3.0 → 0.4.0

package/README.md

@@ -289,6 +289,57 @@ configurePi({ model: 'anthropic/claude-sonnet-4-5', maxTokens: 8000, timeoutMs:
 configureAgent({ maxTurns: 5, excludeTools: ['write'] })
 ```
 
+### System Prompt Overrides
+
+All tags accept `system` (replaces default) and `appendSystemPrompt` (appended after system).
+
+```js
+// π: custom system prompt
+await π({ system: 'You are a security auditor' })`review this code`
+
+// Π: set system prompt and append extra instructions
+await Π({ system: 'You are a test engineer', appendSystemPrompt: 'Write tests first' })`add tests for auth`
+
+// Patterns: inject system context via mergeSystem
+await Ω({ system: 'Prioritize security over performance' })`design login flow`
+```
+
+### Thinking Budgets
+
+Fine-grained token budgets per reasoning level. Passes through to providers via `thinkingBudgets`.
+
+```js
+// Per-call
+await π({ thinkingBudgets: { medium: 16384, high: 65536 } })`analyze`
+
+// Global default
+configurePi({ thinkingBudgets: { medium: 20480, high: 131072 } })
+
+// Patterns support it too
+await Ω({ thinkingBudgets: { high: 65536 } })`deep analysis task`
+```
+
+### Skill Integration
+
+Load Pi agent skills from disk and inject them as system context. Skills are discovered from the same paths as `skill.sh`: `.pi/skills`, `.agents/skills`, `~/.pi/agent/skills`, etc.
+
+```js
+import { loadSkillContent, loadSkillContents } from '@topce/pizx'
+
+// Load a single skill
+const codeStyle = await loadSkillContent('code-simplification')
+if (codeStyle) {
+  await π({ system: codeStyle })`refactor auth.ts`
+}
+
+// Load multiple skills
+const skills = await loadSkillContents(['test-driven-development', 'spec-driven-development'])
+
+// Π and all patterns accept skills option
+await Π({ skills: ['code-simplification'] })`clean up this file`
+await Ω({ skills: ['spec-driven-development', 'incremental-implementation'] })`build the feature`
+```
+
 ## CLI Reference
 
 ```bash

package/dist/cli.js

@@ -179,6 +179,37 @@ function pickModel(preferred) {
   return models[0];
 }
 
+// src/skill-loader.ts
+import { readFile } from "node:fs/promises";
+import { homedir as homedir3 } from "node:os";
+import { join as join3 } from "node:path";
+var SKILL_PATHS = [
+  ".pi/skills",
+  ".agents/skills",
+  "skills",
+  join3(homedir3(), ".pi", "agent", "skills"),
+  join3(homedir3(), ".codewhale", "skills"),
+  join3(homedir3(), ".claude", "skills")
+];
+async function loadSkillContent(name) {
+  for (const base of SKILL_PATHS) {
+    const candidate = join3(base, name, "SKILL.md");
+    try {
+      return await readFile(candidate, "utf-8");
+    } catch {
+    }
+  }
+  return void 0;
+}
+async function loadSkillContents(names) {
+  const map = /* @__PURE__ */ new Map();
+  for (const name of names) {
+    const content = await loadSkillContent(name);
+    if (content) map.set(name, content);
+  }
+  return map;
+}
+
 // src/patterns/types.ts
 var PatternOutput = class {
   constructor(text, startTime = Date.now(), endTime = Date.now()) {
@@ -309,16 +340,32 @@ async function confirmPhase(description, opts) {
 async function ask(prompt, opts = {}) {
   const model = pickModel(opts.model);
   if (!model) throw new Error("pizx/patterns: No AI models configured. Run `pi auth login` first.");
+  let systemPrompt = opts.system;
+  if (opts.skills && opts.skills.length > 0) {
+    const skillMap = await loadSkillContents(opts.skills);
+    if (skillMap.size > 0) {
+      const skillBlocks = [];
+      for (const [name, content] of skillMap) {
+        skillBlocks.push(`Skill context (${name}):
+${content}`);
+      }
+      const skillContext = skillBlocks.join("\n\n");
+      systemPrompt = systemPrompt ? `${systemPrompt}
+
+${skillContext}` : skillContext;
+    }
+  }
   const t0 = Date.now();
   const result = await completeSimple(
     model,
     {
-      systemPrompt: opts.system,
+      systemPrompt,
       messages: [{ role: "user", content: prompt, timestamp: Date.now() }]
     },
     {
       maxTokens: opts.maxTokens ?? 4096,
       reasoning: opts.thinkingLevel ?? "medium",
+      thinkingBudgets: opts.thinkingBudgets,
       timeoutMs: opts.timeoutMs,
       maxRetries: opts.maxRetries
     }
@@ -2709,8 +2756,11 @@ var defaults16 = {
   maxTokens: 4096
 };
 function makeContext(pieces, args, opts) {
+  const systemParts = [];
+  if (opts.system) systemParts.push(opts.system);
+  if (opts.appendSystemPrompt) systemParts.push(opts.appendSystemPrompt);
   return {
-    systemPrompt: opts.system,
+    systemPrompt: systemParts.length > 0 ? systemParts.join("\n\n") : void 0,
     messages: [
       {
         role: "user",
@@ -2724,6 +2774,7 @@ function makeOpts(opts) {
   return {
     maxTokens: opts.maxTokens,
     reasoning: opts.thinkingLevel,
+    thinkingBudgets: opts.thinkingBudgets,
     timeoutMs: opts.timeoutMs,
     maxRetries: opts.maxRetries
   };
@@ -2810,7 +2861,10 @@ function makePi(opts = {}) {
 var \u03C0 = makePi();
 
 // src/pi-agent.ts
-import { createAgentSession as createAgentSession2 } from "@earendil-works/pi-coding-agent";
+import {
+  createAgentSession as createAgentSession2,
+  DefaultResourceLoader
+} from "@earendil-works/pi-coding-agent";
 var _agentDefaults = {
   quiet: false,
   maxTurns: 10
@@ -2842,14 +2896,43 @@ var AgentOutput = class {
 var AgentPromise = class extends Promise {
 };
 var _sharedSession = null;
+function createLoader(opts) {
+  const hasSystem = opts.system !== void 0;
+  const hasAppend = opts.appendSystemPrompt !== void 0;
+  const hasSkills = opts.skills && opts.skills.length > 0;
+  if (!hasSystem && !hasAppend && !hasSkills) return void 0;
+  return new DefaultResourceLoader({
+    cwd: opts.cwd ?? process.cwd(),
+    agentDir: "",
+    systemPrompt: opts.system,
+    appendSystemPrompt: opts.appendSystemPrompt ? [opts.appendSystemPrompt] : void 0
+  });
+}
 async function getSession(opts) {
   if (_sharedSession && !opts.model) return _sharedSession;
   try {
+    const loader = createLoader(opts);
+    if (opts.skills && opts.skills.length > 0 && loader) {
+      const skillMap = await loadSkillContents(opts.skills);
+      const skillPaths = [];
+      for (const [name] of skillMap) {
+        for (const base of SKILL_PATHS) {
+          skillPaths.push({
+            path: `${base}/${name}`,
+            metadata: { source: "pizx", scope: "project", origin: "top-level" }
+          });
+        }
+      }
+      if (skillPaths.length > 0) {
+        loader.extendResources({ skillPaths });
+      }
+    }
     const result = await createAgentSession2({
       cwd: opts.cwd,
       thinkingLevel: opts.thinkingLevel,
       tools: opts.tools,
-      excludeTools: opts.excludeTools
+      excludeTools: opts.excludeTools,
+      resourceLoader: loader
     });
     _sharedSession = result.session;
     return _sharedSession;