pi-code 1.0.67 → 1.0.68

package/extensions/internal/tool-target.ts

@@ -7,16 +7,41 @@
  * context-imports and the command path-scope guard all go through it).
  */
 
+import * as os from 'node:os'
+import * as path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
 /** The tools that name a file pi-code acts on. */
 const FILE_TOOLS: ReadonlySet<string> = new Set(['read', 'edit', 'write'])
 
+/** The spaces pi folds to a plain one before resolving (pi dist/utils/paths). */
+const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g
+
+/** `target` as pi's file tools read it before resolving against cwd: a leading @ (which
+ * some models add) stripped, ~ expanded, a file:// URL decoded, unicode spaces folded.
+ * pi does this in resolveToCwd (dist/core/tools/path-utils), which the package does not
+ * export. A reader that skips it judges a different file than the one pi opens: a
+ * command scoped to `Read(*.md)` allowed `~/secret/notes.md`, read as <cwd>/~/secret. */
+function asPiReadsIt(target: string): string {
+  const folded = target.replace(UNICODE_SPACES, ' ')
+  const bare = folded.startsWith('@') ? folded.slice(1) : folded
+  if (bare === '~') return os.homedir()
+  if (bare.startsWith('~/') || (process.platform === 'win32' && bare.startsWith('~\\'))) return path.join(os.homedir(), bare.slice(2))
+  if (!bare.startsWith('file://')) return bare
+  try {
+    return fileURLToPath(bare)
+  } catch {
+    return bare
+  }
+}
+
 /** The path a file tool call named, or undefined for any other tool, an errored call,
- * or a call that named none. The path is as the tool gave it: callers resolve it
- * against their own cwd. */
+ * or a call that named none. Normalised as pi normalises it, and still relative when
+ * the model gave a relative path: callers resolve it against their own cwd. */
 export function fileToolTarget(event: { toolName: string; input?: unknown; isError?: boolean }): string | undefined {
   if (event.isError === true) return undefined
   if (!FILE_TOOLS.has(event.toolName)) return undefined
   const input = event.input as { path?: unknown; file_path?: unknown } | undefined
   const target = typeof input?.path === 'string' ? input.path : input?.file_path
-  return typeof target === 'string' && target.length > 0 ? target : undefined
+  return typeof target === 'string' && target.length > 0 ? asPiReadsIt(target) : undefined
 }

package/extensions/skills.ts

@@ -167,11 +167,37 @@ function refusedByOverride(name: string, ctx: ExtensionContext, trusted: boolean
   return { action: 'handled' }
 }
 
+/** Forked skills still running in the background, by name. */
+const runningForks = new Set<string>()
+
+/** Whether a context: fork skill holds the invoking turn for its result. Claude: "The
+ * forked subagent runs in the background: you keep working while it runs, and its result
+ * arrives in your conversation when it completes. Set background: false in the frontmatter
+ * to instead wait for the result in the turn that invoked the skill." It also waits in
+ * non-interactive mode, when CLAUDE_CODE_DISABLE_BACKGROUND_TASKS is 1, and "when you
+ * invoke a forked skill while an earlier invocation of the same skill is still running". */
+function forkWaits(name: string, frontmatter: Record<string, unknown>, ctx: ExtensionContext): boolean {
+  if (String(frontmatter.background).trim().toLowerCase() === 'false') return true
+  return !ctx.hasUI || process.env.CLAUDE_CODE_DISABLE_BACKGROUND_TASKS === '1' || runningForks.has(name)
+}
+
+/** Start a forked skill in the background and hand its result to the conversation when it
+ * completes. The promise has no awaiter, and sendMessage on a pi whose session was
+ * replaced meanwhile throws: the catch keeps that from exiting pi, at the cost of the
+ * delivery, as a background subagent run's completion notice is lost the same way. */
+function startForkedSkill(pi: ExtensionAPI, ctx: ExtensionContext, fork: { name: string; filePath: string; expanded: string; agentName: string | undefined }): { action: 'handled' } {
+  runningForks.add(fork.name)
+  ctx.ui.notify(`Skill ${fork.name} is running in a forked subagent in the background; its result arrives here when it completes.`, 'info')
+  void runForkedSkill(fork.name, fork.filePath, fork.expanded, fork.agentName)
+    .then((result) => pi.sendMessage({ customType: 'skill-fork', content: result.text, display: true }, { triggerTurn: true }))
+    .catch(() => {})
+    .finally(() => runningForks.delete(fork.name))
+  return { action: 'handled' }
+}
+
 /** Claude's context: fork run: the expanded skill content becomes the prompt that
- * drives a subagent, without the conversation history. Divergence: Claude
- * backgrounds the fork by default; pi-code waits for the result in the invoking
- * turn (Claude's background: false behavior, which is also what Claude itself
- * does in -p and SDK runs). */
+ * drives a subagent, without the conversation history. Never rejects: a failed run
+ * is reported in the returned block. */
 async function runForkedSkill(name: string, filePath: string, expanded: string, agentName: string | undefined): Promise<{ action: 'transform'; text: string }> {
   try {
     const output = await runAgent({ prompt: expanded, fullTools: true, ...(agentName ? { agent: agentName } : {}) })
@@ -218,7 +244,9 @@ async function expandSkillInvocation(pi: ExtensionAPI, rawText: string, ctx: Ext
   }
   const expanded = await expandCommand(pi, parsed, args, { cwd: ctx.cwd }, found.filePath, undefined, { allowShell: !shellExecutionDisabled(ctx.cwd, os.homedir(), trusted) })
   if (typeof frontmatter.context === 'string' && frontmatter.context.trim().toLowerCase() === 'fork') {
-    return runForkedSkill(name, found.filePath, expanded, typeof frontmatter.agent === 'string' ? frontmatter.agent.trim() : undefined)
+    const agentName = typeof frontmatter.agent === 'string' ? frontmatter.agent.trim() : undefined
+    if (forkWaits(name, frontmatter, ctx)) return runForkedSkill(name, found.filePath, expanded, agentName)
+    return startForkedSkill(pi, ctx, { name, filePath: found.filePath, expanded, agentName })
   }
   return { action: 'transform', text: `<skill name="${name}" location="${found.filePath}">\nReferences are relative to ${found.baseDir}.\n\n${expanded}\n</skill>` }
 }

package/extensions/status-line.ts

@@ -114,12 +114,15 @@ function toNumber(value: string | undefined): number | undefined {
 }
 
 /** One rate-limit window from the `anthropic-ratelimit-<prefix>-*` header family,
- * taking a direct `-utilization` percentage when present, else computing it from
- * `-limit` and `-remaining`. resets_at comes from `-reset` when the header is set.
- * Header names vary, so only what is present is read and a bare number is enough. */
+ * taking `-utilization` when present, else computing the percentage from `-limit` and
+ * `-remaining`. `-utilization` is a 0 to 1 fraction, while Claude documents
+ * used_percentage as "from 0 to 100": it is scaled and rounded to one decimal, as
+ * Claude Code does (Math.round(utilization * 1000) / 10). resets_at comes from `-reset`
+ * when the header is set. Header names vary, so only what is present is read. */
 function readRateLimitWindow(headers: Record<string, string>, prefix: string): RateLimitWindow | undefined {
   const base = `anthropic-ratelimit-${prefix}`
-  let usedPercentage = toNumber(headers[`${base}-utilization`])
+  const utilization = toNumber(headers[`${base}-utilization`])
+  let usedPercentage = utilization === undefined ? undefined : Math.round(utilization * 1000) / 10
   if (usedPercentage === undefined) {
     const limit = toNumber(headers[`${base}-limit`])
     const remaining = toNumber(headers[`${base}-remaining`])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-code",
-  "version": "1.0.67",
+  "version": "1.0.68",
   "description": "Claude Code experience for the pi coding agent: reads your .claude config (rules, commands, skills, hooks, output styles, MCP servers, agents) and adds todo, checkpoints, memory, web, subagents, and goals",
   "keywords": [
     "pi",