@oyasmi/pipiclaw 0.5.3 → 0.5.5

package/README.md

@@ -140,6 +140,7 @@ pipiclaw
     ├── SOUL.md
     ├── AGENTS.md
     ├── MEMORY.md
+    ├── ENVIRONMENT.md
     ├── events/
     ├── skills/
     └── sub-agents/
@@ -385,6 +386,7 @@ Pipiclaw 的核心不是一个临时机器人实例，而是一组长期存在
     ├── SOUL.md
     ├── AGENTS.md
     ├── MEMORY.md
+    ├── ENVIRONMENT.md
     ├── events/
     ├── skills/
     ├── sub-agents/
@@ -395,8 +397,7 @@ Pipiclaw 的核心不是一个临时机器人实例，而是一组长期存在
     │   ├── .channel-meta.json
     │   ├── context.jsonl
     │   ├── log.jsonl
-    │   ├── subagent-runs.jsonl
-    │   └── skills/
+    │   └── subagent-runs.jsonl
     └── group_{conversationId}/
         └── ...
 ```

package/dist/agent/channel-runner.d.ts

@@ -1,7 +1,7 @@
-import { type BuiltInCommand } from "../commands.js";
 import type { DingTalkContext } from "../runtime/dingtalk.js";
 import type { ChannelStore } from "../runtime/store.js";
 import { type SandboxConfig } from "../sandbox.js";
+import { type BuiltInCommand } from "./commands.js";
 import { type AgentRunner } from "./types.js";
 export declare class ChannelRunner implements AgentRunner {
     private readonly sandboxConfig;

package/dist/agent/channel-runner.js

@@ -2,30 +2,31 @@ import { Agent } from "@mariozechner/pi-agent-core";
 import { AgentSession, AuthStorage, convertToLlm, DefaultResourceLoader, ModelRegistry, SessionManager, } from "@mariozechner/pi-coding-agent";
 import { mkdir, readFile, writeFile } from "fs/promises";
 import { dirname, join, resolve } from "path";
-import { createCommandExtension } from "../command-extension.js";
-import { renderBuiltInHelp } from "../commands.js";
-import { getAgentConfig, getApiKeyForModel, getSoul, loadPipiclawSkills } from "../config-loader.js";
-import { PipiclawSettingsManager } from "../context.js";
 import * as log from "../log.js";
 import { buildFirstTurnMemoryBootstrap as renderFirstTurnMemoryBootstrap } from "../memory/bootstrap.js";
 import { createMemoryCandidateCache } from "../memory/candidates.js";
 import { getChannelMemoryPath } from "../memory/files.js";
 import { MemoryLifecycle } from "../memory/lifecycle.js";
 import { recallRelevantMemory } from "../memory/recall.js";
-import { resolveInitialModel } from "../model-utils.js";
+import { getApiKeyForModel } from "../models/api-keys.js";
+import { resolveInitialModel } from "../models/utils.js";
 import { APP_HOME_DIR, AUTH_CONFIG_PATH, MODELS_CONFIG_PATH } from "../paths.js";
-import { buildAppendSystemPrompt } from "../prompt-builder.js";
 import { createExecutor } from "../sandbox.js";
+import { PipiclawSettingsManager } from "../settings.js";
 import { HAN_REGEX } from "../shared/text-utils.js";
 import { isRecord } from "../shared/type-guards.js";
 import { discoverSubAgents, formatSubAgentList } from "../subagents/discovery.js";
 import { createPipiclawTools } from "../tools/index.js";
+import { createCommandExtension } from "./command-extension.js";
+import { renderBuiltInHelp } from "./commands.js";
 import { clipUserInput } from "./progress-formatter.js";
+import { buildAppendSystemPrompt } from "./prompt-builder.js";
 import { createRunQueue } from "./run-queue.js";
 import { handleSessionEvent } from "./session-events.js";
 import { SessionResourceGate } from "./session-resource-gate.js";
 import { getLastAssistantUsage } from "./type-guards.js";
 import { createEmptyRunState, MAX_USER_MESSAGE_CHARS, } from "./types.js";
+import { getAgentConfig, getSoul, loadPipiclawSkills } from "./workspace-resources.js";
 function isSilentOutcome(outcome) {
     return outcome.kind === "silent";
 }

package/dist/{command-extension.js → agent/command-extension.js}

@@ -1,5 +1,5 @@
 import { basename } from "path";
-import { findExactModelReferenceMatch, formatModelList, formatModelReference } from "./model-utils.js";
+import { findExactModelReferenceMatch, formatModelList, formatModelReference } from "../models/utils.js";
 export const COMMAND_RESULT_CUSTOM_TYPE = "pipiclaw.command_result";
 function buildSessionText(stats, currentModel, thinkingLevel) {
     const modelText = currentModel ? `\`${formatModelReference(currentModel)}\`` : "(none)";

package/dist/{prompt-builder.d.ts → agent/prompt-builder.d.ts}

@@ -1,4 +1,4 @@
-import type { SandboxConfig } from "./sandbox.js";
+import type { SandboxConfig } from "../sandbox.js";
 export interface AppendSystemPromptOptions {
     subAgentList?: string;
 }

package/dist/{prompt-builder.js → agent/prompt-builder.js}

@@ -31,6 +31,7 @@ ${workspacePath}/
 ├── SOUL.md                      # Your identity/personality (read-only)
 ├── AGENTS.md                    # Custom behavior instructions (read-only)
 ├── MEMORY.md                    # Stable workspace memory (admin-managed, read on demand)
+├── ENVIRONMENT.md               # Environment facts and notable machine-level changes (read on demand)
 ├── sub-agents/                  # Predefined sub-agent definitions
 ├── skills/                      # Global CLI tools you create
 ├── events/                      # Scheduled events
@@ -39,9 +40,7 @@ ${workspacePath}/
     ├── MEMORY.md                # Channel durable memory (read on demand, runtime-managed)
     ├── HISTORY.md               # Channel summarized history (read on demand, runtime-managed)
     ├── log.jsonl                # Raw message archive (cold storage)
-    ├── context.jsonl            # Raw session archive (cold storage)
-    ├── scratch/                 # Your working directory
-    └── skills/                  # Channel-specific tools`);
+    └── context.jsonl            # Raw session archive (cold storage)`);
     sections.push(`## Events
 You can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \`${workspacePath}/events/\`.
 
@@ -80,6 +79,8 @@ Memory files are not preloaded into session context. Read them explicitly when m
 ### Files
 - Workspace memory: ${workspacePath}/MEMORY.md
   Stable shared background memory. Admin-managed. Read on demand.
+- Workspace environment: ${workspacePath}/ENVIRONMENT.md
+  Durable environment facts and notable machine-level changes. Read on demand when environment state or prior machine changes matter.
 - Channel session memory: ${channelPath}/SESSION.md
   Current working state for this channel. Runtime-managed. Read on demand. Prefer this when current task state matters.
 - Channel memory: ${channelPath}/MEMORY.md
@@ -92,20 +93,21 @@ Memory files are not preloaded into session context. Read them explicitly when m
 - SESSION.md is the primary runtime-managed working-state artifact for current active work.
 - The runtime automatically consolidates channel MEMORY.md and HISTORY.md before compaction or session trimming.
 - Workspace MEMORY.md is not updated by normal runtime consolidation.
+- ENVIRONMENT.md is not normal conversational memory. Read it only when environment history or machine state matters.
 
 ### Cold Storage
 - ${channelPath}/log.jsonl is a raw archive. It is not normal memory and is not proactively loaded.
 - ${channelPath}/context.jsonl is a raw session archive. It is not normal memory and is not proactively loaded.
 
 When a task depends on prior decisions, preferences, or long-running work, prefer SESSION.md first for current state, then MEMORY.md, then HISTORY.md.`);
-    sections.push(`## System Configuration Log
-Maintain ${workspacePath}/SYSTEM.md to log all environment modifications:
-- Installed packages (apk add, npm install, pip install)
-- Environment variables set
-- Config files modified
-- Skill dependencies installed
-
-Update this file whenever you modify the environment.`);
+    sections.push(`## Environment Log
+Maintain ${workspacePath}/ENVIRONMENT.md to record durable environment changes when they matter:
+- Installed packages or tools that future work depends on
+- Important environment variables or credential sources
+- Config files modified outside normal project code
+- Runtime prerequisites that affect future sessions
+
+Keep it factual and concise. Do not use it for task progress or conversation summaries.`);
     sections.push(`## Tools
 - read: Read files
 - edit: Surgical file edits

package/dist/agent/type-guards.js

@@ -1,5 +1,5 @@
-import { COMMAND_RESULT_CUSTOM_TYPE } from "../command-extension.js";
 import { isRecord } from "../shared/type-guards.js";
+import { COMMAND_RESULT_CUSTOM_TYPE } from "./command-extension.js";
 function isMessageWithRole(value) {
     return isRecord(value) && typeof value.role === "string";
 }

package/dist/agent/types.d.ts

@@ -1,7 +1,7 @@
-import type { BuiltInCommand } from "../commands.js";
 import type { DingTalkContext } from "../runtime/dingtalk.js";
 import type { ChannelStore } from "../runtime/store.js";
 import type { UsageTotals } from "../shared/types.js";
+import type { BuiltInCommand } from "./commands.js";
 export interface AgentRunner {
     run(ctx: DingTalkContext, store: ChannelStore): Promise<{
         stopReason: string;

package/dist/agent/workspace-resources.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Workspace resource loaders for pipiclaw:
+ * SOUL.md, AGENTS.md, and workspace-level skills.
+ */
+import { type Skill } from "@mariozechner/pi-coding-agent";
+/**
+ * Load SOUL.md — defines the agent's identity, personality, and communication style.
+ * Only loaded from workspace root (global).
+ */
+export declare function getSoul(workspaceDir: string): string;
+/**
+ * Load AGENTS.md — defines the agent's behavior instructions, capabilities, and constraints.
+ * Only loaded from workspace root (global).
+ */
+export declare function getAgentConfig(channelDir: string): string;
+/**
+ * Load skills from the workspace-level skill directory only.
+ */
+export declare function loadPipiclawSkills(channelDir: string, workspacePath: string): Skill[];

package/dist/{config-loader.js → agent/workspace-resources.js}

@@ -1,11 +1,11 @@
 /**
- * Configuration file loaders for pipiclaw workspace files:
- * SOUL.md, AGENTS.md, skills/, and API key resolution.
+ * Workspace resource loaders for pipiclaw:
+ * SOUL.md, AGENTS.md, and workspace-level skills.
  */
 import { loadSkillsFromDir } from "@mariozechner/pi-coding-agent";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
-import * as log from "./log.js";
+import * as log from "../log.js";
 /**
  * Load SOUL.md — defines the agent's identity, personality, and communication style.
  * Only loaded from workspace root (global).
@@ -44,11 +44,9 @@ export function getAgentConfig(channelDir) {
     return "";
 }
 /**
- * Load skills from both workspace-level and channel-level skill directories.
- * Channel-level skills override global skills with the same name.
+ * Load skills from the workspace-level skill directory only.
  */
 export function loadPipiclawSkills(channelDir, workspacePath) {
-    const skillMap = new Map();
     const hostWorkspacePath = join(channelDir, "..");
     const translatePath = (hostPath) => {
         if (hostPath.startsWith(hostWorkspacePath)) {
@@ -56,34 +54,11 @@ export function loadPipiclawSkills(channelDir, workspacePath) {
         }
         return hostPath;
     };
-    // Load workspace-level skills (global)
     const workspaceSkillsDir = join(hostWorkspacePath, "skills");
-    for (const skill of loadSkillsFromDir({ dir: workspaceSkillsDir, source: "workspace" }).skills) {
+    const skills = loadSkillsFromDir({ dir: workspaceSkillsDir, source: "workspace" }).skills;
+    for (const skill of skills) {
         skill.filePath = translatePath(skill.filePath);
         skill.baseDir = translatePath(skill.baseDir);
-        skillMap.set(skill.name, skill);
     }
-    // Load channel-specific skills
-    const channelSkillsDir = join(channelDir, "skills");
-    for (const skill of loadSkillsFromDir({ dir: channelSkillsDir, source: "channel" }).skills) {
-        skill.filePath = translatePath(skill.filePath);
-        skill.baseDir = translatePath(skill.baseDir);
-        skillMap.set(skill.name, skill);
-    }
-    return Array.from(skillMap.values());
-}
-/**
- * Resolve an API key for the given model's provider.
- * Checks ModelRegistry first, then falls back to ANTHROPIC_API_KEY env var.
- */
-export async function getApiKeyForModel(modelRegistry, model) {
-    const key = await modelRegistry.getApiKeyForProvider(model.provider);
-    if (key)
-        return key;
-    // Fallback: try anthropic env var
-    const envKey = process.env.ANTHROPIC_API_KEY;
-    if (envKey)
-        return envKey;
-    throw new Error(`No API key found for provider: ${model.provider}.\n\n` +
-        "Configure credentials in ~/.pi/pipiclaw/auth.json or ~/.pi/pipiclaw/models.json, or set the matching provider environment variable.");
+    return skills;
 }

package/dist/index.d.ts

@@ -1,23 +1,25 @@
-export { type AgentRunner, getOrCreateRunner } from "./agent.js";
-export { COMMAND_RESULT_CUSTOM_TYPE, createCommandExtension, type PipiclawCommandExtensionOptions, } from "./command-extension.js";
-export { type BuiltInCommand, type BuiltInCommandName, parseBuiltInCommand, renderBuiltInHelp } from "./commands.js";
-export { getAgentConfig, getApiKeyForModel, getSoul, loadPipiclawSkills, } from "./config-loader.js";
-export { type PipiclawMemoryRecallSettings, type PipiclawSessionMemorySettings, type PipiclawSettings, PipiclawSettingsManager, } from "./context.js";
+export { COMMAND_RESULT_CUSTOM_TYPE, createCommandExtension, type PipiclawCommandExtensionOptions, } from "./agent/command-extension.js";
+export { type BuiltInCommand, type BuiltInCommandName, parseBuiltInCommand, renderBuiltInHelp, } from "./agent/commands.js";
+export { type AgentRunner, getOrCreateRunner } from "./agent/index.js";
+export { type AppendSystemPromptOptions, buildAppendSystemPrompt } from "./agent/prompt-builder.js";
+export { getAgentConfig, getSoul, loadPipiclawSkills, } from "./agent/workspace-resources.js";
 export { type BuildMemoryCandidatesOptions, buildMemoryCandidates, type MemoryCandidate, } from "./memory/candidates.js";
 export { type BackgroundMaintenanceResult, type ConsolidationRunOptions, type InlineConsolidationResult, runBackgroundMaintenance, runInlineConsolidation, } from "./memory/consolidation.js";
 export { ensureChannelMemoryFiles, ensureChannelMemoryFilesSync, getChannelSessionPath, readChannelSession, rewriteChannelSession, } from "./memory/files.js";
 export { type ConsolidationReason, MemoryLifecycle, type MemoryLifecycleOptions } from "./memory/lifecycle.js";
 export { type RecalledMemory, type RecallRequest, type RecallResult, recallRelevantMemory, } from "./memory/recall.js";
 export { renderSessionMemory, type SessionMemoryState, type SessionMemoryUpdateOptions, updateChannelSessionMemory, } from "./memory/session.js";
-export { findExactModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./model-utils.js";
+export { runSidecarTask, type SidecarResult, type SidecarTask, } from "./memory/sidecar-worker.js";
+export { getApiKeyForModel } from "./models/api-keys.js";
+export { findExactModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./models/utils.js";
 export { APP_HOME_DIR, APP_NAME, AUTH_CONFIG_PATH, CHANNEL_CONFIG_PATH, MODELS_CONFIG_PATH, SETTINGS_CONFIG_PATH, SUB_AGENTS_DIR, SUB_AGENTS_DIR_NAME, WORKSPACE_DIR, } from "./paths.js";
-export { type AppendSystemPromptOptions, buildAppendSystemPrompt } from "./prompt-builder.js";
+export { ensureChannelDir, getChannelDir, getChannelDirName, } from "./runtime/channel-paths.js";
 export { createDingTalkContext } from "./runtime/delivery.js";
 export { type BusyMessageMode, DingTalkBot, type DingTalkConfig, type DingTalkContext, type DingTalkEvent, type DingTalkHandler, } from "./runtime/dingtalk.js";
 export { createEventsWatcher, EventsWatcher, type ImmediateEvent, type OneShotEvent, type PeriodicEvent, type ScheduledEvent, } from "./runtime/events.js";
 export { ChannelStore, type LoggedMessage, type LoggedSubAgentRun } from "./runtime/store.js";
 export { createExecutor, type ExecOptions, type ExecResult, type Executor, parseSandboxArg, type SandboxConfig, validateSandbox, } from "./sandbox.js";
-export { runSidecarTask, type SidecarResult, type SidecarTask, } from "./sidecar-worker.js";
+export { type PipiclawMemoryRecallSettings, type PipiclawSessionMemorySettings, type PipiclawSettings, PipiclawSettingsManager, } from "./settings.js";
 export { discoverSubAgents, formatSubAgentList, getSubAgentsDir, type ResolvedSubAgentConfig, resolveSubAgentConfig, type SubAgentConfig, type SubAgentContextMode, type SubAgentDiscoveryResult, type SubAgentInvocationOverrides, type SubAgentMemoryMode, type SubAgentToolName, } from "./subagents/discovery.js";
 export { createSubAgentTool, type SubAgentToolDetails, type SubAgentToolOptions, } from "./subagents/tool.js";
 export { type CreatePipiclawToolsOptions, createPipiclawBaseTools, createPipiclawTools, } from "./tools/index.js";

package/dist/index.js

@@ -1,23 +1,25 @@
-export { getOrCreateRunner } from "./agent.js";
-export { COMMAND_RESULT_CUSTOM_TYPE, createCommandExtension, } from "./command-extension.js";
-export { parseBuiltInCommand, renderBuiltInHelp } from "./commands.js";
-export { getAgentConfig, getApiKeyForModel, getSoul, loadPipiclawSkills, } from "./config-loader.js";
-export { PipiclawSettingsManager, } from "./context.js";
+export { COMMAND_RESULT_CUSTOM_TYPE, createCommandExtension, } from "./agent/command-extension.js";
+export { parseBuiltInCommand, renderBuiltInHelp, } from "./agent/commands.js";
+export { getOrCreateRunner } from "./agent/index.js";
+export { buildAppendSystemPrompt } from "./agent/prompt-builder.js";
+export { getAgentConfig, getSoul, loadPipiclawSkills, } from "./agent/workspace-resources.js";
 export { buildMemoryCandidates, } from "./memory/candidates.js";
 export { runBackgroundMaintenance, runInlineConsolidation, } from "./memory/consolidation.js";
 export { ensureChannelMemoryFiles, ensureChannelMemoryFilesSync, getChannelSessionPath, readChannelSession, rewriteChannelSession, } from "./memory/files.js";
 export { MemoryLifecycle } from "./memory/lifecycle.js";
 export { recallRelevantMemory, } from "./memory/recall.js";
 export { renderSessionMemory, updateChannelSessionMemory, } from "./memory/session.js";
-export { findExactModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./model-utils.js";
+export { runSidecarTask, } from "./memory/sidecar-worker.js";
+export { getApiKeyForModel } from "./models/api-keys.js";
+export { findExactModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./models/utils.js";
 export { APP_HOME_DIR, APP_NAME, AUTH_CONFIG_PATH, CHANNEL_CONFIG_PATH, MODELS_CONFIG_PATH, SETTINGS_CONFIG_PATH, SUB_AGENTS_DIR, SUB_AGENTS_DIR_NAME, WORKSPACE_DIR, } from "./paths.js";
-export { buildAppendSystemPrompt } from "./prompt-builder.js";
+export { ensureChannelDir, getChannelDir, getChannelDirName, } from "./runtime/channel-paths.js";
 export { createDingTalkContext } from "./runtime/delivery.js";
 export { DingTalkBot, } from "./runtime/dingtalk.js";
 export { createEventsWatcher, EventsWatcher, } from "./runtime/events.js";
 export { ChannelStore } from "./runtime/store.js";
 export { createExecutor, parseSandboxArg, validateSandbox, } from "./sandbox.js";
-export { runSidecarTask, } from "./sidecar-worker.js";
+export { PipiclawSettingsManager, } from "./settings.js";
 export { discoverSubAgents, formatSubAgentList, getSubAgentsDir, resolveSubAgentConfig, } from "./subagents/discovery.js";
 export { createSubAgentTool, } from "./subagents/tool.js";
 export { createPipiclawBaseTools, createPipiclawTools, } from "./tools/index.js";

package/dist/memory/consolidation.js

@@ -3,8 +3,8 @@ import { parseJsonObject } from "../shared/llm-json.js";
 import { splitH2Sections } from "../shared/markdown-sections.js";
 import { clipText } from "../shared/text-utils.js";
 import { buildStandardMessages } from "../shared/type-guards.js";
-import { runSidecarTask } from "../sidecar-worker.js";
 import { appendChannelHistoryBlock, appendChannelMemoryUpdate, readChannelHistory, readChannelMemory, readChannelSession, rewriteChannelHistory, rewriteChannelMemory, } from "./files.js";
+import { runSidecarTask } from "./sidecar-worker.js";
 const INLINE_TRANSCRIPT_MAX_CHARS = 28_000;
 const MEMORY_CLEANUP_LENGTH_THRESHOLD = 5_000;
 const MEMORY_UPDATE_BLOCK_THRESHOLD = 4;

package/dist/memory/lifecycle.d.ts

@@ -1,7 +1,7 @@
 import type { AgentMessage } from "@mariozechner/pi-agent-core";
 import type { Api, Model } from "@mariozechner/pi-ai";
 import type { ExtensionFactory, SessionEntry } from "@mariozechner/pi-coding-agent";
-import type { PipiclawSessionMemorySettings } from "../context.js";
+import type { PipiclawSessionMemorySettings } from "../settings.js";
 export type ConsolidationReason = "compaction" | "new-session" | "idle";
 export interface MemoryLifecycleOptions {
     channelId: string;

package/dist/memory/recall.js

@@ -1,8 +1,8 @@
 import { parseJsonObject } from "../shared/llm-json.js";
 import { HAN_REGEX } from "../shared/text-utils.js";
-import { runSidecarTask } from "../sidecar-worker.js";
 import { buildMemoryCandidates } from "./candidates.js";
 import { COMMON_CHINESE_WORDS } from "./chinese-words.js";
+import { runSidecarTask } from "./sidecar-worker.js";
 const RERANK_SYSTEM_PROMPT = `You are selecting which memory snippets are most relevant to the current user turn.
 
 Return strict JSON only:

package/dist/memory/session.js

@@ -5,8 +5,8 @@ import { parseJsonObject } from "../shared/llm-json.js";
 import { splitH1Sections } from "../shared/markdown-sections.js";
 import { clipText } from "../shared/text-utils.js";
 import { buildStandardMessages, isRecord } from "../shared/type-guards.js";
-import { runSidecarTask, SidecarParseError } from "../sidecar-worker.js";
 import { readChannelMemory, readChannelSession, rewriteChannelSession } from "./files.js";
+import { runSidecarTask, SidecarParseError } from "./sidecar-worker.js";
 const SESSION_TRANSCRIPT_MAX_CHARS = 20_000;
 const SESSION_MEMORY_MAX_CHARS = 4_000;
 const SESSION_ITEM_LIMIT = 12;

package/dist/{sidecar-worker.js → memory/sidecar-worker.js}

@@ -1,6 +1,6 @@
 import { Agent } from "@mariozechner/pi-agent-core";
 import { convertToLlm } from "@mariozechner/pi-coding-agent";
-import { extractAssistantText } from "./shared/text-utils.js";
+import { extractAssistantText } from "../shared/text-utils.js";
 export class SidecarTimeoutError extends Error {
     constructor(taskName, timeoutMs) {
         super(`Sidecar task "${taskName}" timed out after ${timeoutMs}ms`);

package/dist/models/api-keys.d.ts

@@ -0,0 +1,7 @@
+import type { Api, Model } from "@mariozechner/pi-ai";
+import type { ModelRegistry } from "@mariozechner/pi-coding-agent";
+/**
+ * Resolve an API key for the given model's provider.
+ * Checks ModelRegistry first, then falls back to ANTHROPIC_API_KEY.
+ */
+export declare function getApiKeyForModel(modelRegistry: ModelRegistry, model: Model<Api>): Promise<string>;

package/dist/models/api-keys.js

@@ -0,0 +1,16 @@
+/**
+ * Resolve an API key for the given model's provider.
+ * Checks ModelRegistry first, then falls back to ANTHROPIC_API_KEY.
+ */
+export async function getApiKeyForModel(modelRegistry, model) {
+    const key = await modelRegistry.getApiKeyForProvider(model.provider);
+    if (key) {
+        return key;
+    }
+    const envKey = process.env.ANTHROPIC_API_KEY;
+    if (envKey) {
+        return envKey;
+    }
+    throw new Error(`No API key found for provider: ${model.provider}.\n\n` +
+        "Configure credentials in ~/.pi/pipiclaw/auth.json or ~/.pi/pipiclaw/models.json, or set the matching provider environment variable.");
+}

package/dist/{model-utils.d.ts → models/utils.d.ts}

@@ -1,6 +1,6 @@
 import { type Api, type Model } from "@mariozechner/pi-ai";
 import type { ModelRegistry } from "@mariozechner/pi-coding-agent";
-import type { PipiclawSettingsManager } from "./context.js";
+import type { PipiclawSettingsManager } from "../settings.js";
 export declare function formatModelReference(model: Model<Api>): string;
 export declare function findExactModelReferenceMatch(modelReference: string, availableModels: Model<Api>[]): {
     match?: Model<Api>;

package/dist/runtime/bootstrap.js

@@ -1,11 +1,12 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
-import { getOrCreateRunner } from "../agent.js";
-import { parseBuiltInCommand } from "../commands.js";
+import { parseBuiltInCommand } from "../agent/commands.js";
+import { getOrCreateRunner } from "../agent/index.js";
 import * as log from "../log.js";
 import { ensureChannelMemoryFilesSync } from "../memory/files.js";
 import { APP_HOME_DIR, APP_NAME, AUTH_CONFIG_PATH, CHANNEL_CONFIG_PATH, MODELS_CONFIG_PATH, SETTINGS_CONFIG_PATH, WORKSPACE_DIR, } from "../paths.js";
 import { parseSandboxArg, validateSandbox } from "../sandbox.js";
+import { ensureChannelDir } from "./channel-paths.js";
 import { createDingTalkContext } from "./delivery.js";
 import { DingTalkBot, } from "./dingtalk.js";
 import { createEventsWatcher } from "./events.js";
@@ -68,6 +69,26 @@ This file stores stable workspace-level memory.
 
 <!-- Put long-lived project facts here. -->
 `;
+const DEFAULT_ENVIRONMENT = `# Environment
+
+This file records durable environment facts and notable machine-level changes.
+
+- Record installed tools, runtime prerequisites, and important config changes here.
+- Keep entries concise and factual.
+- Do not use this file for task progress, conversation summaries, or project-specific decisions.
+
+## Environment Facts
+
+<!-- Put stable machine or runtime facts here. -->
+
+## Installed Tools
+
+<!-- Record durable tools or dependencies that were installed for this workspace. -->
+
+## Config Changes
+
+<!-- Record important config or environment changes that affect future work. -->
+`;
 const CHANNEL_CONFIG_TEMPLATE = {
     clientId: "your-dingtalk-client-id",
     clientSecret: "your-dingtalk-client-secret",
@@ -139,6 +160,7 @@ export function bootstrapAppHome(paths = DEFAULT_BOOTSTRAP_PATHS) {
     writeTextFileIfMissing(join(paths.workspaceDir, "SOUL.md"), DEFAULT_SOUL, "workspace/SOUL.md", created);
     writeTextFileIfMissing(join(paths.workspaceDir, "AGENTS.md"), DEFAULT_AGENT, "workspace/AGENTS.md", created);
     writeTextFileIfMissing(join(paths.workspaceDir, "MEMORY.md"), DEFAULT_MEMORY, "workspace/MEMORY.md", created);
+    writeTextFileIfMissing(join(paths.workspaceDir, "ENVIRONMENT.md"), DEFAULT_ENVIRONMENT, "workspace/ENVIRONMENT.md", created);
     const channelTemplateCreated = writeJsonFileIfMissing(paths.channelConfigPath, CHANNEL_CONFIG_TEMPLATE, "channel.json", created);
     writeJsonFileIfMissing(paths.authConfigPath, {}, "auth.json", created);
     writeJsonFileIfMissing(paths.modelsConfigPath, MODELS_CONFIG_TEMPLATE, "models.json", created);
@@ -273,7 +295,7 @@ export async function bootstrap(argv, options = {}) {
     const getState = (channelId) => {
         let state = channelStates.get(channelId);
         if (!state) {
-            const channelDir = join(paths.workspaceDir, channelId);
+            const channelDir = ensureChannelDir(paths.workspaceDir, channelId);
             ensureChannelMemoryFilesSync(channelDir);
             state = {
                 running: false,

package/dist/runtime/channel-paths.d.ts

@@ -0,0 +1,3 @@
+export declare function getChannelDirName(channelId: string): string;
+export declare function getChannelDir(baseDir: string, channelId: string): string;
+export declare function ensureChannelDir(baseDir: string, channelId: string): string;

package/dist/runtime/channel-paths.js

@@ -0,0 +1,13 @@
+import { mkdirSync } from "fs";
+import { join } from "path";
+export function getChannelDirName(channelId) {
+    return channelId.replaceAll("/", "__");
+}
+export function getChannelDir(baseDir, channelId) {
+    return join(baseDir, getChannelDirName(channelId));
+}
+export function ensureChannelDir(baseDir, channelId) {
+    const channelDir = getChannelDir(baseDir, channelId);
+    mkdirSync(channelDir, { recursive: true });
+    return channelDir;
+}

package/dist/runtime/dingtalk.js

@@ -11,9 +11,10 @@ import axios from "axios";
 import { DWClient, TOPIC_ROBOT } from "dingtalk-stream";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { dirname, join } from "path";
-import { parseBuiltInCommand, renderBuiltInHelp } from "../commands.js";
+import { parseBuiltInCommand, renderBuiltInHelp } from "../agent/commands.js";
 import * as log from "../log.js";
 import { isRecord } from "../shared/type-guards.js";
+import { getChannelDir } from "./channel-paths.js";
 class ChannelQueue {
     constructor() {
         this.queue = [];
@@ -761,6 +762,6 @@ export class DingTalkBot {
     getConversationMetaPath(channelId) {
         if (!this.config.stateDir)
             return null;
-        return join(this.config.stateDir, channelId, ".channel-meta.json");
+        return join(getChannelDir(this.config.stateDir, channelId), ".channel-meta.json");
     }
 }

package/dist/runtime/store.js

@@ -1,6 +1,7 @@
 import { closeSync, existsSync, mkdirSync, openSync, readSync, renameSync, statSync } from "fs";
 import { appendFile, writeFile } from "fs/promises";
 import { dirname, join } from "path";
+import { ensureChannelDir, getChannelDir } from "./channel-paths.js";
 const MAX_LOG_SIZE_BYTES = 1_000_000;
 const DEDUPE_TTL_MS = 60_000;
 const DEDUPE_CLEANUP_INTERVAL_MS = 30_000;
@@ -19,11 +20,7 @@ export class ChannelStore {
      * Get or create the directory for a channel/DM
      */
     getChannelDir(channelId) {
-        const dir = join(this.workingDir, channelId);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        return dir;
+        return ensureChannelDir(this.workingDir, channelId);
     }
     /**
      * Log a message to the channel's log.jsonl raw archive.
@@ -102,7 +99,7 @@ export class ChannelStore {
      * Returns null if no log exists
      */
     getLastTimestamp(channelId) {
-        const logPath = join(this.workingDir, channelId, "log.jsonl");
+        const logPath = join(getChannelDir(this.workingDir, channelId), "log.jsonl");
         if (!existsSync(logPath)) {
             return null;
         }

package/dist/{context.d.ts → settings.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Context management for pipiclaw.
+ * Settings management for pipiclaw.
  *
  * `log.jsonl` and `context.jsonl` are treated as raw cold storage.
  * They are not proactively scanned or loaded as part of the memory model.

package/dist/{context.js → settings.js}

@@ -1,5 +1,5 @@
 /**
- * Context management for pipiclaw.
+ * Settings management for pipiclaw.
  *
  * `log.jsonl` and `context.jsonl` are treated as raw cold storage.
  * They are not proactively scanned or loaded as part of the memory model.

package/dist/subagents/discovery.js

@@ -1,7 +1,7 @@
 import { parseFrontmatter } from "@mariozechner/pi-coding-agent";
 import { existsSync, readdirSync, readFileSync } from "fs";
 import { join } from "path";
-import { findExactModelReferenceMatch, formatModelReference } from "../model-utils.js";
+import { findExactModelReferenceMatch, formatModelReference } from "../models/utils.js";
 import { SUB_AGENTS_DIR_NAME } from "../paths.js";
 const ALLOWED_SUB_AGENT_TOOLS = ["read", "bash", "edit", "write"];
 const DEFAULT_SUB_AGENT_TOOLS = ["read", "bash"];

package/dist/subagents/tool.d.ts

@@ -1,7 +1,7 @@
 import { type AgentEvent, type AgentMessage, type AgentTool } from "@mariozechner/pi-agent-core";
 import type { Api, Model } from "@mariozechner/pi-ai";
-import type { PipiclawMemoryRecallSettings } from "../context.js";
 import type { Executor } from "../sandbox.js";
+import type { PipiclawMemoryRecallSettings } from "../settings.js";
 import type { UsageTotals } from "../shared/types.js";
 import { type ResolvedSubAgentConfig, type SubAgentDiscoveryResult } from "./discovery.js";
 declare const subagentSchema: import("@sinclair/typebox").TObject<{

package/dist/subagents/tool.js

@@ -4,7 +4,7 @@ import { Type } from "@sinclair/typebox";
 import { createMemoryCandidateCache } from "../memory/candidates.js";
 import { readChannelSession } from "../memory/files.js";
 import { recallRelevantMemory } from "../memory/recall.js";
-import { formatModelReference } from "../model-utils.js";
+import { formatModelReference } from "../models/utils.js";
 import { splitH1Sections } from "../shared/markdown-sections.js";
 import { clipText, extractAssistantText, extractLabelFromArgs, HAN_REGEX } from "../shared/text-utils.js";
 import { createBashTool } from "../tools/bash.js";

package/dist/tools/index.d.ts

@@ -1,7 +1,7 @@
 import type { AgentTool } from "@mariozechner/pi-agent-core";
 import type { Api, Model } from "@mariozechner/pi-ai";
-import type { PipiclawMemoryRecallSettings } from "../context.js";
 import type { Executor, SandboxConfig } from "../sandbox.js";
+import type { PipiclawMemoryRecallSettings } from "../settings.js";
 import type { SubAgentDiscoveryResult } from "../subagents/discovery.js";
 export interface CreatePipiclawToolsOptions {
     executor: Executor;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oyasmi/pipiclaw",
-	"version": "0.5.3",
+	"version": "0.5.5",
 	"description": "An AI assistant runtime for coding and team workflows, with DingTalk AI Cards, sub-agents, memory, and scheduled events.",
 	"type": "module",
 	"bin": {

package/dist/agent.d.ts

@@ -1,2 +0,0 @@
-export type { AgentRunner } from "./agent/index.js";
-export { ChannelRunner, getOrCreateRunner } from "./agent/index.js";

package/dist/agent.js

@@ -1 +0,0 @@
-export { ChannelRunner, getOrCreateRunner } from "./agent/index.js";

package/dist/config-loader.d.ts

@@ -1,26 +0,0 @@
-/**
- * Configuration file loaders for pipiclaw workspace files:
- * SOUL.md, AGENTS.md, skills/, and API key resolution.
- */
-import type { Api, Model } from "@mariozechner/pi-ai";
-import { type ModelRegistry, type Skill } from "@mariozechner/pi-coding-agent";
-/**
- * Load SOUL.md — defines the agent's identity, personality, and communication style.
- * Only loaded from workspace root (global).
- */
-export declare function getSoul(workspaceDir: string): string;
-/**
- * Load AGENTS.md — defines the agent's behavior instructions, capabilities, and constraints.
- * Only loaded from workspace root (global).
- */
-export declare function getAgentConfig(channelDir: string): string;
-/**
- * Load skills from both workspace-level and channel-level skill directories.
- * Channel-level skills override global skills with the same name.
- */
-export declare function loadPipiclawSkills(channelDir: string, workspacePath: string): Skill[];
-/**
- * Resolve an API key for the given model's provider.
- * Checks ModelRegistry first, then falls back to ANTHROPIC_API_KEY env var.
- */
-export declare function getApiKeyForModel(modelRegistry: ModelRegistry, model: Model<Api>): Promise<string>;