@pencil-agent/nano-pencil 2.0.0-beta.9 → 2.0.0

package/dist/modes/interactive/theme/warm.json

@@ -1,81 +1,81 @@
-{
-  "$schema": "https://raw.githubusercontent.com/O-Pencil/nanoPencil/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
-  "name": "warm",
-  "vars": {
-    "warmBrown": "#c4a574",
-    "warmLight": "#d4a574",
-    "warmBorder": "#a08060",
-    "blue": "#5f87ff",
-    "green": "#b5bd68",
-    "red": "#cc6666",
-    "yellow": "#d4a84b",
-    "gray": "#808080",
-    "dimGray": "#666666",
-    "darkGray": "#505050",
-    "accent": "warmBrown",
-    "selectedBg": "#3d362a",
-    "userMsgBg": "#2e2a24",
-    "toolPendingBg": "#2a2820",
-    "toolSuccessBg": "#2a3024",
-    "toolErrorBg": "#3c2828",
-    "customMsgBg": "#2d2838"
-  },
-  "colors": {
-    "accent": "accent",
-    "border": "warmBorder",
-    "borderAccent": "warmLight",
-    "borderMuted": "darkGray",
-    "success": "green",
-    "error": "red",
-    "warning": "yellow",
-    "muted": "gray",
-    "dim": "dimGray",
-    "text": "",
-    "thinkingText": "gray",
-    "selectedBg": "selectedBg",
-    "userMessageBg": "userMsgBg",
-    "userMessageText": "warmLight",
-    "customMessageBg": "customMsgBg",
-    "customMessageText": "",
-    "customMessageLabel": "#b8956b",
-    "toolPendingBg": "toolPendingBg",
-    "toolSuccessBg": "toolSuccessBg",
-    "toolErrorBg": "toolErrorBg",
-    "toolTitle": "",
-    "toolOutput": "gray",
-    "mdHeading": "warmLight",
-    "mdLink": "#81a2be",
-    "mdLinkUrl": "dimGray",
-    "mdCode": "accent",
-    "mdCodeBlock": "green",
-    "mdCodeBlockBorder": "gray",
-    "mdQuote": "gray",
-    "mdQuoteBorder": "gray",
-    "mdHr": "gray",
-    "mdListBullet": "accent",
-    "toolDiffAdded": "green",
-    "toolDiffRemoved": "red",
-    "toolDiffContext": "gray",
-    "syntaxComment": "#6A9955",
-    "syntaxKeyword": "#569CD6",
-    "syntaxFunction": "#DCDCAA",
-    "syntaxVariable": "#9CDCFE",
-    "syntaxString": "#CE9178",
-    "syntaxNumber": "#B5CEA8",
-    "syntaxType": "#4EC9B0",
-    "syntaxOperator": "#D4D4D4",
-    "syntaxPunctuation": "#D4D4D4",
-    "thinkingOff": "darkGray",
-    "thinkingMinimal": "#6e6e6e",
-    "thinkingLow": "#5f87af",
-    "thinkingMedium": "warmBrown",
-    "thinkingHigh": "#b294bb",
-    "thinkingXhigh": "#d183e8",
-    "bashMode": "green"
-  },
-  "export": {
-    "pageBg": "#1a1814",
-    "cardBg": "#242018",
-    "infoBg": "#3c3728"
-  }
-}
+{
+  "$schema": "https://raw.githubusercontent.com/O-Pencil/nanoPencil/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "warm",
+  "vars": {
+    "warmBrown": "#c4a574",
+    "warmLight": "#d4a574",
+    "warmBorder": "#a08060",
+    "blue": "#5f87ff",
+    "green": "#b5bd68",
+    "red": "#cc6666",
+    "yellow": "#d4a84b",
+    "gray": "#808080",
+    "dimGray": "#666666",
+    "darkGray": "#505050",
+    "accent": "warmBrown",
+    "selectedBg": "#3d362a",
+    "userMsgBg": "#2e2a24",
+    "toolPendingBg": "#2a2820",
+    "toolSuccessBg": "#2a3024",
+    "toolErrorBg": "#3c2828",
+    "customMsgBg": "#2d2838"
+  },
+  "colors": {
+    "accent": "accent",
+    "border": "warmBorder",
+    "borderAccent": "warmLight",
+    "borderMuted": "darkGray",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "gray",
+    "dim": "dimGray",
+    "text": "",
+    "thinkingText": "gray",
+    "selectedBg": "selectedBg",
+    "userMessageBg": "userMsgBg",
+    "userMessageText": "warmLight",
+    "customMessageBg": "customMsgBg",
+    "customMessageText": "",
+    "customMessageLabel": "#b8956b",
+    "toolPendingBg": "toolPendingBg",
+    "toolSuccessBg": "toolSuccessBg",
+    "toolErrorBg": "toolErrorBg",
+    "toolTitle": "",
+    "toolOutput": "gray",
+    "mdHeading": "warmLight",
+    "mdLink": "#81a2be",
+    "mdLinkUrl": "dimGray",
+    "mdCode": "accent",
+    "mdCodeBlock": "green",
+    "mdCodeBlockBorder": "gray",
+    "mdQuote": "gray",
+    "mdQuoteBorder": "gray",
+    "mdHr": "gray",
+    "mdListBullet": "accent",
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "gray",
+    "syntaxComment": "#6A9955",
+    "syntaxKeyword": "#569CD6",
+    "syntaxFunction": "#DCDCAA",
+    "syntaxVariable": "#9CDCFE",
+    "syntaxString": "#CE9178",
+    "syntaxNumber": "#B5CEA8",
+    "syntaxType": "#4EC9B0",
+    "syntaxOperator": "#D4D4D4",
+    "syntaxPunctuation": "#D4D4D4",
+    "thinkingOff": "darkGray",
+    "thinkingMinimal": "#6e6e6e",
+    "thinkingLow": "#5f87af",
+    "thinkingMedium": "warmBrown",
+    "thinkingHigh": "#b294bb",
+    "thinkingXhigh": "#d183e8",
+    "bashMode": "green"
+  },
+  "export": {
+    "pageBg": "#1a1814",
+    "cardBg": "#242018",
+    "infoBg": "#3c3728"
+  }
+}

package/dist/packages/protocol/src/flags.d.ts

@@ -0,0 +1,20 @@
+/**
+ * [WHO]: Provides ExtensionFlag, ExtensionFlagOptions, ExtensionFlagValue
+ * [FROM]: No dependencies — flags are portable extension metadata
+ * [TO]: Consumed by protocol ExtensionAPI and the host extension loader/runner
+ * [HERE]: packages/protocol/src/flags.ts - stable CLI/config flag declaration contract
+ */
+/** Supported values for extension-declared flags. */
+export type ExtensionFlagValue = boolean | string;
+/** Options an extension passes to `api.registerFlag(...)`. */
+export interface ExtensionFlagOptions {
+    description?: string;
+    type: "boolean" | "string";
+    default?: ExtensionFlagValue;
+}
+/** A runtime flag an extension declares (parsed from CLI/config by the host). */
+export interface ExtensionFlag extends ExtensionFlagOptions {
+    name: string;
+    /** Absolute path of the declaring extension (filled by the host loader). */
+    extensionPath: string;
+}

package/dist/packages/protocol/src/hooks.d.ts

@@ -0,0 +1,17 @@
+/**
+ * [WHO]: Provides HookEventName and HookHandler — public lifecycle hook vocabulary
+ * [FROM]: No dependencies — context is generic so lifecycle/host can supply their own context type
+ * [TO]: Consumed by protocol ExtensionAPI and host extension event overloads
+ * [HERE]: packages/protocol/src/hooks.ts - stable hook-name contract without payload freezing
+ *
+ * Payload types intentionally stay out of protocol for now. The host keeps rich typed
+ * overloads; protocol only publishes the event-name vocabulary that external extensions
+ * may subscribe to.
+ */
+/** Lifecycle hook names an extension may subscribe to via `api.on(...)`. */
+export type HookEventName = "resources_discover" | "session_start" | "session_ready" | "session_before_switch" | "session_switch" | "session_before_fork" | "session_fork" | "session_before_compact" | "session_compact" | "session_shutdown" | "session_before_tree" | "session_tree" | "context" | "before_agent_start" | "agent_start" | "agent_result" | "agent_abort" | "agent_end" | "turn_start" | "turn_end" | "message_start" | "message_update" | "message_end" | "tool_execution_start" | "tool_execution_update" | "tool_execution_end" | "model_select" | "tool_call" | "tool_result" | "user_bash" | "input";
+/**
+ * Hook callback. The event payload is intentionally `any` this round so host-agnostic
+ * extensions compile without per-event payload types; typed payloads remain host-owned.
+ */
+export type HookHandler<TContext = unknown> = (event: any, ctx: TContext) => void | Promise<void>;

package/dist/packages/protocol/src/index.d.ts

@@ -1,13 +1,15 @@
 /**
  * [WHO]: Barrel for @pencil-agent/protocol — the stable protocol surface for extensions
- * [FROM]: Re-exports the per-protocol modules (tools + lifecycle + commands today; themes/hooks/permissions in later P3 checkpoints)
+ * [FROM]: Re-exports the per-protocol modules (tools + lifecycle + commands + hooks + flags today; themes/permissions in later P3 checkpoints)
  * [TO]: Consumed by third-party extensions, packages/mem-core, packages/soul-core, and the host (adopting these contracts)
  * [HERE]: packages/protocol/src/index.ts - protocol public entry
  *
  * Scope (this round / P3): tools (S1), lifecycle (ExtensionAPI/ExtensionContext/SessionManagerContract, S3),
- * commands, then themes/hooks/permissions. Explicitly NOT here (EVOLUTION-RESERVED): agent-profile,
+ * commands, hooks, flags, then themes/permissions. Explicitly NOT here (EVOLUTION-RESERVED): agent-profile,
  * host-adapter, tool-runtime, a2a-bridge, memory/soul providers — see evolution/PARP.md.
  */
 export * from "./tools.js";
 export * from "./lifecycle.js";
 export * from "./commands.js";
+export * from "./hooks.js";
+export * from "./flags.js";

package/dist/packages/protocol/src/index.js

@@ -1 +1 @@
-export*from"./tools.js";export*from"./lifecycle.js";export*from"./commands.js";
+export*from"./tools.js";export*from"./lifecycle.js";export*from"./commands.js";export*from"./hooks.js";export*from"./flags.js";

package/dist/packages/protocol/src/lifecycle.d.ts

@@ -1,17 +1,19 @@
 /**
  * [WHO]: Provides ExtensionAPI, ExtensionContext, ExtensionFactory, ExtensionUi,
- *        SessionManagerContract, HookEventName, HookHandler — the extension lifecycle protocol
- * [FROM]: Depends on ./commands and ./tools for command/tool registration contracts
+ *        SessionManagerContract — the extension lifecycle protocol
+ * [FROM]: Depends on ./commands, ./flags, ./hooks, and ./tools for registration contracts
  * [TO]: Consumed by packages/mem-core (extension adapter) and third-party extensions; the host's
  *       richer ExtensionContext/ExtensionAPI satisfy these structurally (extensions load dynamically)
  * [HERE]: packages/protocol/src/lifecycle.ts - the stable extension entry contract
  *
- * Scope note: event payloads are intentionally loose (HookHandler's event is `unknown`) this round;
- * per-event typed payloads land in hooks.ts during P3.1. This file carries only the surface that
+ * Scope note: event payloads are intentionally loose (HookHandler's event is `any`) this round;
+ * per-event typed payloads remain host-owned. This file carries only the surface that
  * lets a host-agnostic extension (e.g. mem-core) compile against the SDK instead of the host package.
  */
 import type { TSchema } from "@sinclair/typebox";
 import type { ExtensionCommand } from "./commands.js";
+import type { ExtensionFlagOptions, ExtensionFlagValue } from "./flags.js";
+import type { HookEventName, HookHandler } from "./hooks.js";
 import type { ToolContract } from "./tools.js";
 /** Read-only session info an extension may consult via `ctx.sessionManager`. */
 export interface SessionManagerContract {
@@ -42,28 +44,16 @@ export interface ExtensionContext {
     /** User-facing UI affordances. */
     ui: ExtensionUi;
 }
-/** Lifecycle hook names an extension may subscribe to via `api.on(...)`. */
-export type HookEventName = "session_start" | "session_ready" | "session_shutdown" | "before_agent_start" | "agent_start" | "agent_end" | "agent_result" | "turn_start" | "turn_end" | "tool_execution_start" | "tool_execution_end";
-/**
- * Hook callback. The event payload is intentionally `any` this round so host-agnostic
- * extensions compile without per-event payload types; typed payloads land in hooks.ts (P3.1).
- */
-export type HookHandler = (event: any, ctx: ExtensionContext) => void | Promise<void>;
-/** A runtime flag an extension declares (parsed from CLI/config by the host). */
-export interface ExtensionFlag {
-    name: string;
-    description?: string;
-    type: "boolean" | "string";
-    default?: boolean | string;
-    /** Absolute path of the declaring extension (filled by the host loader). */
-    extensionPath: string;
-}
 /** The registration surface a host passes to an extension factory. */
 export interface ExtensionAPI {
     /** Subscribe to a lifecycle hook. */
-    on(event: HookEventName, handler: HookHandler): void;
+    on(event: HookEventName, handler: HookHandler<ExtensionContext>): void;
     /** Register a slash command. */
     registerCommand(name: string, command: ExtensionCommand<ExtensionContext>): void;
+    /** Register a CLI/config flag declared by this extension. */
+    registerFlag(name: string, options: ExtensionFlagOptions): void;
+    /** Get the value of a registered CLI/config flag. */
+    getFlag(name: string): ExtensionFlagValue | undefined;
     /** Register a model-facing tool. Generic so each call infers its own parameter schema. */
     registerTool<TParams extends TSchema = TSchema, TDetails = unknown>(tool: ToolContract<TParams, TDetails>): void;
 }

package/dist/public-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * [WHO]: Public config subpath exports for auth, settings, resource, and package managers
+ * [FROM]: Re-exports selected core/platform config and package-manager modules
+ * [TO]: Consumed by advanced SDK users importing @pencil-agent/nano-pencil/config
+ * [HERE]: public-config.ts - package subpath entry for configuration APIs
+ */
+export { type ApiKeyCredential, type AuthCredential, AuthStorage, type AuthStorageBackend, FileAuthStorageBackend, InMemoryAuthStorageBackend, type OAuthCredential, } from "./core/platform/config/auth-storage.js";
+export { type CompactionSettings, type ImageSettings, type PackageSource, type RetrySettings, SettingsManager, } from "./core/platform/config/settings-manager.js";
+export type { ResourceCollision, ResourceDiagnostic, ResourceLoader } from "./core/platform/config/resource-loader.js";
+export { DefaultResourceLoader } from "./core/platform/config/resource-loader.js";
+export type { PackageManager, PathMetadata, ProgressCallback, ProgressEvent, ResolvedPaths, ResolvedResource, } from "./core/package-manager.js";
+export { DefaultPackageManager } from "./core/package-manager.js";

package/dist/public-config.js

@@ -0,0 +1 @@
+import{AuthStorage as a,FileAuthStorageBackend as o,InMemoryAuthStorageBackend as t}from"./core/platform/config/auth-storage.js";import{SettingsManager as f}from"./core/platform/config/settings-manager.js";import{DefaultResourceLoader as u}from"./core/platform/config/resource-loader.js";import{DefaultPackageManager as c}from"./core/package-manager.js";export{a as AuthStorage,c as DefaultPackageManager,u as DefaultResourceLoader,o as FileAuthStorageBackend,t as InMemoryAuthStorageBackend,f as SettingsManager};

package/dist/runtime.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [WHO]: Public runtime subpath exports for advanced AgentSession embedding
+ * [FROM]: Re-exports selected runtime/message modules
+ * [TO]: Consumed by advanced SDK users importing @pencil-agent/nano-pencil/runtime
+ * [HERE]: runtime.ts - package subpath entry for runtime APIs
+ */
+export { AgentSession, type AgentSessionConfig, type AgentSessionEvent, type AgentSessionEventListener, type ModelCycleResult, type ParsedSkillBlock, parseSkillBlock, type PromptOptions, type SessionStats, } from "./core/runtime/agent-session.js";
+export { createEventBus, type EventBus, type EventBusController } from "./core/runtime/event-bus.js";
+export { convertToLlm } from "./core/messages.js";

package/dist/runtime.js

@@ -0,0 +1 @@
+import{AgentSession as r,parseSkillBlock as t}from"./core/runtime/agent-session.js";import{createEventBus as m}from"./core/runtime/event-bus.js";import{convertToLlm as p}from"./core/messages.js";export{r as AgentSession,p as convertToLlm,m as createEventBus,t as parseSkillBlock};

package/dist/session-compaction.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [WHO]: Public session/compaction subpath exports for context compaction helpers
+ * [FROM]: Re-exports core/session/compaction/index.js
+ * [TO]: Consumed by advanced SDK users importing @pencil-agent/nano-pencil/session/compaction
+ * [HERE]: session-compaction.ts - package subpath entry for compaction APIs
+ */
+export * from "./core/session/compaction/index.js";

package/dist/session-compaction.js

@@ -0,0 +1 @@
+export*from"./core/session/compaction/index.js";

package/dist/session.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [WHO]: Public session subpath exports for session persistence and entry types
+ * [FROM]: Re-exports core/session/session-manager.js
+ * [TO]: Consumed by advanced SDK users importing @pencil-agent/nano-pencil/session
+ * [HERE]: session.ts - package subpath entry for session APIs
+ */
+export { type BranchSummaryEntry, buildSessionContext, type CompactionEntry, CURRENT_SESSION_VERSION, type CustomEntry, type CustomMessageEntry, type FileEntry, getLatestCompactionEntry, type ModelChangeEntry, migrateSessionEntries, type NewSessionOptions, parseSessionEntries, type SessionContext, type SessionEntry, type SessionEntryBase, type SessionHeader, type SessionInfo, type SessionInfoEntry, SessionManager, type SessionMessageEntry, type ThinkingLevelChangeEntry, } from "./core/session/session-manager.js";

package/dist/session.js

@@ -0,0 +1 @@
+import{buildSessionContext as t,CURRENT_SESSION_VERSION as n,getLatestCompactionEntry as i,migrateSessionEntries as o,parseSessionEntries as r,SessionManager as S}from"./core/session/session-manager.js";export{n as CURRENT_SESSION_VERSION,S as SessionManager,t as buildSessionContext,i as getLatestCompactionEntry,o as migrateSessionEntries,r as parseSessionEntries};

package/dist/skills.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [WHO]: Public skills subpath exports for skill discovery and prompt formatting
+ * [FROM]: Re-exports core/skills.js
+ * [TO]: Consumed by advanced SDK users importing @pencil-agent/nano-pencil/skills
+ * [HERE]: skills.ts - package subpath entry for skill APIs
+ */
+export { formatSkillsForPrompt, type LoadSkillsFromDirOptions, type LoadSkillsResult, loadSkills, loadSkillsFromDir, type Skill, type SkillFrontmatter, } from "./core/skills.js";

package/dist/skills.js

@@ -0,0 +1 @@
+import{formatSkillsForPrompt as r,loadSkills as i,loadSkillsFromDir as m}from"./core/skills.js";export{r as formatSkillsForPrompt,i as loadSkills,m as loadSkillsFromDir};

package/dist/tools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [WHO]: Public tools subpath exports for built-in tool implementations and types
+ * [FROM]: Re-exports core/tools/index.js
+ * [TO]: Consumed by advanced SDK users importing @pencil-agent/nano-pencil/tools
+ * [HERE]: tools.ts - package subpath entry for tool APIs
+ */
+export * from "./core/tools/index.js";

package/dist/tools.js

@@ -0,0 +1 @@
+export*from"./core/tools/index.js";