@felan-ai/felan 0.1.0-alpha.3 → 0.2.0

package/NOTICE

@@ -6,6 +6,6 @@ This package composes the MIT-licensed @felan-ai/agent-core and Felan extension
 packages listed in package.json. Their package-level LICENSE and NOTICE files
 contain the applicable attribution and source provenance.
 
-The terminal application uses @earendil-works/pi-coding-agent 0.82.1 from
+The terminal application uses @earendil-works/pi-coding-agent 0.83.0 from
 https://github.com/earendil-works/pi, licensed under the MIT License.
 Copyright (c) 2025 Mario Zechner.

package/README.md

@@ -8,9 +8,16 @@ npx @felan-ai/felan
 ```
 
 The package exposes the `felan` binary. It stores model credentials, settings,
-and sessions under `~/.felan/agent` by default; set `FELAN_AGENT_DIR` to select
-another local directory. Use `/login` inside the TUI to configure provider-owned
-model credentials without a Felan account.
+sessions, agents, and runtime state under `~/.felan` by default; set
+`FELAN_AGENT_DIR` to select another directory. Use `/login` inside the TUI to
+configure provider-owned model credentials without a Felan account. Felan reads
+global settings from `~/.felan/settings.json` and does not load Pi project
+settings. Pi project trust does not apply to Felan's fixed resource policy, so
+Felan starts without a project trust prompt.
+
+Felan suppresses Pi's version notification, bundled changelog, package update
+notifications, and install/update telemetry. Update behavior is owned by the
+Felan application.
 
 Each session uses a cwd-bound `HostAgentRuntime`. Pi's session runtime recreates
 the host runtime, filtered settings, resources, and session composition for
@@ -18,14 +25,65 @@ new, resume, fork, clone, and import flows, then rebinds the active interactive
 UI. Host mode uses the current user's filesystem and process permissions and is
 not an isolation boundary.
 
-Only the source-controlled Felan extension package list is imported. Ambient Pi
-packages, extensions, skills, prompts, themes, and context files remain filtered;
-inline Felan extensions can still provide shared tools, prompts, interaction,
-and subagent behavior. The default local list includes `@felan-ai/ext-powerline`
-for an ANSI-aware footer; it is a direct TUI dependency and is not part of any
-cloud composition. Agent Core's `spawn_agent` tool delegates child creation
-through the portable host contract; local children run as in-process Agent Core
-sessions on fresh host runtimes without Felan cloud services.
+Only source-controlled built-in Felan extensions can be imported. External
+packages, extensions, configured skill paths, prompts, themes, and Pi context
+files remain filtered. Agent Skills are loaded from `~/.agents/skills` and
+`<workspace>/.agents/skills` and are shared with local subagents.
+The built-in powerline reads `~/.felan/powerline.json` (or
+`$FELAN_AGENT_DIR/powerline.json`) once when it initializes.
+
+All built-in extensions are enabled by default. Toggle them in
+`~/.felan/settings.json`:
+
+```json
+{
+  "builtinExtensions": {
+    "subagents": true,
+    "prewalk": true,
+    "context": true,
+    "powerline": false
+  }
+}
+```
+
+## System prompt append
+
+The TUI reads one optional `$FELAN_AGENT_DIR/APPEND_SYSTEM.md` file when each
+session is constructed (`~/.felan/APPEND_SYSTEM.md` by default). Missing and
+blank files add nothing; other read failures stop session construction with the
+filesystem error. The file extends Agent Core's Felan prompt after enabled
+extension capabilities. Child persona instructions follow this application
+append. Explicit Agent Skills and the current working directory are added last.
+
+System prompt inputs are limited to Agent Core, enabled capabilities, the
+single application append above, explicit Agent Skills, and the current working
+directory. Pi `SYSTEM.md`, project `APPEND_SYSTEM.md`, and project
+prompt/context files stay outside local composition.
+
+When enabled, `@felan-ai/ext-subagents` uses the session-bound local host and
+provides `Agent`, `list_subagents`,
+`get_subagent_result`, `steer_subagent`, and `cancel_subagent`. A root-scoped
+local host tracks foreground and background runs, persists the latest child session
+metadata, delivers completion notices, supports bounded nesting, and uses the
+application's current workspace. The TUI status line shows active/recent child
+state, and runtime shutdown awaits active-child cancellation before Pi teardown.
+Completed-child continuation uses the same child ID and Pi session file while
+replacing the latest result. The default list also
+includes `@felan-ai/ext-powerline` for an ANSI-aware footer; it is a direct TUI
+dependency and is not part of cloud composition.
+
+Local agent definitions are loaded only from bundled Felan definitions,
+`~/.felan/agents/*.md` (or `$FELAN_AGENT_DIR/agents/*.md`), and
+`<workspace>/.felan/agents/*.md`, with
+project definitions taking precedence. Pi ambient agent discovery remains
+disabled. Local subagent concurrency defaults to four and depth defaults to
+three; set `felanSubagents.concurrency` and `felanSubagents.maxDepth` in the
+Felan settings file to configure those bounded values.
+
+Local model selectors are deterministic and support explicit inheritance or an
+exact authenticated `provider/model`; exact selectors never fall back. Requested
+thinking levels are checked against that resolved model and unsupported levels
+return `unsupported_thinking` instead of being silently clamped.
 
 ```sh
 felan --diagnostics

package/dist/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE5F,MAAM,WAAW,oBAAqB,SAAQ,8BAA8B;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBrF"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,oBAAqB,SAAQ,8BAA8B;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CrF"}

package/dist/application.js

@@ -1,15 +1,26 @@
 import { InteractiveMode } from '@earendil-works/pi-coding-agent';
-import { createLocalFelanRuntime } from './runtime.js';
+import { createLocalFelanRuntime, } from './runtime.js';
+import { attachLocalSubagentPresenter } from './subagents/presenter.js';
 export async function runLocalFelan(options = {}) {
     const runtime = await createLocalFelanRuntime(options);
     const previousPiAgentDir = process.env.PI_CODING_AGENT_DIR;
+    const previousPiSkipVersionCheck = process.env.PI_SKIP_VERSION_CHECK;
+    const previousPiTelemetry = process.env.PI_TELEMETRY;
     process.env.PI_CODING_AGENT_DIR = runtime.services.agentDir;
+    process.env.PI_SKIP_VERSION_CHECK = '1';
+    process.env.PI_TELEMETRY = '0';
     try {
         const mode = new InteractiveMode(runtime, {
             ...(options.initialMessage === undefined ? {} : { initialMessage: options.initialMessage }),
             ...(options.verbose === undefined ? {} : { verbose: options.verbose }),
         });
-        await mode.run();
+        const detachPresenter = attachLocalSubagentPresenter(runtime, mode);
+        try {
+            await mode.run();
+        }
+        finally {
+            detachPresenter();
+        }
     }
     finally {
         try {
@@ -22,6 +33,18 @@ export async function runLocalFelan(options = {}) {
             else {
                 process.env.PI_CODING_AGENT_DIR = previousPiAgentDir;
             }
+            if (previousPiSkipVersionCheck === undefined) {
+                delete process.env.PI_SKIP_VERSION_CHECK;
+            }
+            else {
+                process.env.PI_SKIP_VERSION_CHECK = previousPiSkipVersionCheck;
+            }
+            if (previousPiTelemetry === undefined) {
+                delete process.env.PI_TELEMETRY;
+            }
+            else {
+                process.env.PI_TELEMETRY = previousPiTelemetry;
+            }
         }
     }
 }

package/dist/application.js.map

@@ -1 +1 @@
-{"version":3,"file":"application.js","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAuC,MAAM,cAAc,CAAC;AAO5F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE;YACxC,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;gBACrC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,kBAAkB,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EACL,uBAAuB,GAExB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAOxE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC3D,MAAM,0BAA0B,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACrE,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE;YACxC,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,4BAA4B,CAClD,OAAO,EACP,IAAqE,CACtE,CAAC;QACF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;gBAAS,CAAC;YACT,eAAe,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;gBACrC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,kBAAkB,CAAC;YACvD,CAAC;YACD,IAAI,0BAA0B,KAAK,SAAS,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,0BAA0B,CAAC;YACjE,CAAC;YACD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,mBAAmB,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/extensions.d.ts

@@ -1,4 +1,16 @@
 import type { ExtensionPackageImporter } from '@felan-ai/agent-core';
-export declare const localExtensionPackages: readonly ["@felan-ai/ext-prewalk", "@felan-ai/ext-context", "@felan-ai/ext-powerline"];
+import { type SubagentHost } from '@felan-ai/ext-subagents';
+export declare const subagentsExtensionPackage = "@felan-ai/ext-subagents";
+export declare const builtinExtensionPackages: {
+    readonly subagents: "@felan-ai/ext-subagents";
+    readonly prewalk: "@felan-ai/ext-prewalk";
+    readonly context: "@felan-ai/ext-context";
+    readonly powerline: "@felan-ai/ext-powerline";
+};
+export declare const localExtensionPackages: ("@felan-ai/ext-subagents" | "@felan-ai/ext-prewalk" | "@felan-ai/ext-context" | "@felan-ai/ext-powerline")[];
+export type BuiltinExtensionName = keyof typeof builtinExtensionPackages;
+export type BuiltinExtensionSettings = Partial<Record<BuiltinExtensionName, boolean>>;
+export declare function resolveBuiltinExtensionPackages(settings: unknown): readonly string[];
 export declare const importLocalExtension: ExtensionPackageImporter;
+export declare function createLocalExtensionImporter(host: SubagentHost, importExtension?: ExtensionPackageImporter, shutdownHost?: () => Promise<void>): ExtensionPackageImporter;
 //# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,eAAO,MAAM,sBAAsB,wFAIzB,CAAC;AAIX,eAAO,MAAM,oBAAoB,EAAE,wBAKlC,CAAC"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAEjC,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,wBAAwB;;;;;CAK3B,CAAC;AACX,eAAO,MAAM,sBAAsB,+GAA0C,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AACzE,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAAC;AAItF,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAYpF;AAED,eAAO,MAAM,oBAAoB,EAAE,wBAKlC,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,YAAY,EAClB,eAAe,GAAE,wBAA+C,EAChE,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACjC,wBAAwB,CAiB1B"}

package/dist/extensions.js

@@ -1,13 +1,54 @@
-export const localExtensionPackages = [
-    '@felan-ai/ext-prewalk',
-    '@felan-ai/ext-context',
-    '@felan-ai/ext-powerline',
-];
+import { createSubagentsExtension, } from '@felan-ai/ext-subagents';
+export const subagentsExtensionPackage = '@felan-ai/ext-subagents';
+export const builtinExtensionPackages = {
+    subagents: subagentsExtensionPackage,
+    prewalk: '@felan-ai/ext-prewalk',
+    context: '@felan-ai/ext-context',
+    powerline: '@felan-ai/ext-powerline',
+};
+export const localExtensionPackages = Object.values(builtinExtensionPackages);
 const localExtensionPackageSet = new Set(localExtensionPackages);
+export function resolveBuiltinExtensionPackages(settings) {
+    if (settings === undefined)
+        return localExtensionPackages;
+    if (!isRecord(settings))
+        throw new Error('builtinExtensions must be an object');
+    for (const [name, enabled] of Object.entries(settings)) {
+        if (!Object.hasOwn(builtinExtensionPackages, name))
+            throw new Error(`Unknown built-in extension: ${name}`);
+        if (typeof enabled !== 'boolean')
+            throw new Error(`Built-in extension ${name} must be a boolean`);
+    }
+    return Object.entries(builtinExtensionPackages)
+        .filter(([name]) => settings[name] !== false)
+        .map(([, packageName]) => packageName);
+}
 export const importLocalExtension = async (packageName) => {
     if (!localExtensionPackageSet.has(packageName)) {
         throw new Error(`Unknown local extension package: ${packageName}`);
     }
     return import(packageName);
 };
+export function createLocalExtensionImporter(host, importExtension = importLocalExtension, shutdownHost) {
+    return async (packageName) => {
+        if (packageName === subagentsExtensionPackage) {
+            const subagents = createSubagentsExtension(host);
+            return {
+                default: ((pi) => {
+                    subagents(pi);
+                    if (shutdownHost) {
+                        pi.on('session_shutdown', async (event) => {
+                            if (event.reason !== 'reload')
+                                await shutdownHost();
+                        });
+                    }
+                }),
+            };
+        }
+        return importExtension(packageName);
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
 //# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,uBAAuB;IACvB,uBAAuB;IACvB,yBAAyB;CACjB,CAAC;AAEX,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAEtF,MAAM,CAAC,MAAM,oBAAoB,GAA6B,KAAK,EAAE,WAAW,EAAE,EAAE;IAClF,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7B,CAAC,CAAC"}
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,GAEzB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AACnE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,yBAAyB;IACpC,OAAO,EAAE,uBAAuB;IAChC,OAAO,EAAE,uBAAuB;IAChC,SAAS,EAAE,yBAAyB;CAC5B,CAAC;AACX,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAK9E,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAEtF,MAAM,UAAU,+BAA+B,CAAC,QAAiB;IAC/D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAEhF,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,wBAAwB,EAAE,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC;QAC3G,IAAI,OAAO,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,oBAAoB,CAAC,CAAC;IACpG,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC;SAC5C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC;SAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAA6B,KAAK,EAAE,WAAW,EAAE,EAAE;IAClF,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAC1C,IAAkB,EAClB,kBAA4C,oBAAoB,EAChE,YAAkC;IAElC,OAAO,KAAK,EAAE,WAAW,EAAE,EAAE;QAC3B,IAAI,WAAW,KAAK,yBAAyB,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;YACjD,OAAO;gBACL,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE;oBACf,SAAS,CAAC,EAAE,CAAC,CAAC;oBACd,IAAI,YAAY,EAAE,CAAC;wBACjB,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;4BACxC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gCAAE,MAAM,YAAY,EAAE,CAAC;wBACtD,CAAC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC,CAAuD;aACzD,CAAC;QACJ,CAAC;QACD,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/index.d.ts

@@ -2,9 +2,14 @@ export { runLocalFelan } from './application.js';
 export type { RunLocalFelanOptions } from './application.js';
 export { runCli } from './cli-main.js';
 export type { CliDependencies } from './cli-main.js';
-export { importLocalExtension, localExtensionPackages } from './extensions.js';
-export { createLocalFelanRuntime, createLocalModelRuntime, createLocalSessionHost, createLocalSessionRuntimeFactory, getLocalAgentDir, } from './runtime.js';
-export type { CreateLocalFelanRuntimeOptions, CreateLocalSessionRuntimeFactoryOptions, } from './runtime.js';
-export { createLocalSettingsManager } from './settings.js';
+export { builtinExtensionPackages, importLocalExtension, localExtensionPackages, resolveBuiltinExtensionPackages, } from './extensions.js';
+export type { BuiltinExtensionName, BuiltinExtensionSettings } from './extensions.js';
+export { createLocalFelanRuntime, createLocalModelRuntime, createLocalSessionRuntimeFactory, getLocalAgentDir, getLocalSkillPaths, } from './runtime.js';
+export { LocalSubagentHost } from './subagents/host.js';
+export type { CreateLocalSubagentHostOptions, LocalSubagentSettings, LocalSubagentView, } from './subagents/host.js';
+export type { CreateLocalFelanRuntimeOptions, CreateLocalSessionRuntimeFactoryOptions, LocalFelanRuntime, } from './runtime.js';
+export { createLocalSettingsManager, getFelanSettings } from './settings.js';
+export type { FelanSettings } from './settings.js';
+export { LOCAL_APPEND_SYSTEM_PROMPT_FILENAME, loadLocalAppendSystemPrompt, } from './system-prompt.js';
 export { FELAN_VERSION } from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,gCAAgC,EAChC,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,8BAA8B,EAC9B,uCAAuC,GACxC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,8BAA8B,EAC9B,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,8BAA8B,EAC9B,uCAAuC,EACvC,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,7 +1,9 @@
 export { runLocalFelan } from './application.js';
 export { runCli } from './cli-main.js';
-export { importLocalExtension, localExtensionPackages } from './extensions.js';
-export { createLocalFelanRuntime, createLocalModelRuntime, createLocalSessionHost, createLocalSessionRuntimeFactory, getLocalAgentDir, } from './runtime.js';
-export { createLocalSettingsManager } from './settings.js';
+export { builtinExtensionPackages, importLocalExtension, localExtensionPackages, resolveBuiltinExtensionPackages, } from './extensions.js';
+export { createLocalFelanRuntime, createLocalModelRuntime, createLocalSessionRuntimeFactory, getLocalAgentDir, getLocalSkillPaths, } from './runtime.js';
+export { LocalSubagentHost } from './subagents/host.js';
+export { createLocalSettingsManager, getFelanSettings } from './settings.js';
+export { LOCAL_APPEND_SYSTEM_PROMPT_FILENAME, loadLocalAppendSystemPrompt, } from './system-prompt.js';
 export { FELAN_VERSION } from './version.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,gCAAgC,EAChC,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAKtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAWxD,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EACL,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtime.d.ts

@@ -1,10 +1,18 @@
-import { ModelRuntime, SessionManager, type AgentRuntime, type AgentSessionHost, type CreateAgentSessionRuntimeFactory, type ExtensionPackageImporter } from '@felan-ai/agent-core';
+import { ModelRuntime, SessionManager, type AgentRuntime, type CreateAgentSessionRuntimeFactory, type ExtensionPackageImporter } from '@felan-ai/agent-core';
+import { type AgentSessionRuntime } from '@earendil-works/pi-coding-agent';
+import { LocalSubagentHost, type LocalSubagentSettings } from './subagents/host.js';
+export type LocalFelanRuntime = AgentSessionRuntime & {
+    readonly localSubagentHost: LocalSubagentHost;
+    subscribeLocalSubagentHost(listener: (host: LocalSubagentHost) => void): () => void;
+};
 export interface CreateLocalSessionRuntimeFactoryOptions {
     readonly agentDir: string;
     readonly modelRuntime: ModelRuntime;
     readonly extensionPackages?: readonly string[];
     readonly importExtension?: ExtensionPackageImporter;
     readonly runtimeFactory?: (cwd: string) => AgentRuntime;
+    readonly skillPaths?: readonly string[];
+    readonly subagentSettings?: LocalSubagentSettings;
 }
 export interface CreateLocalFelanRuntimeOptions {
     readonly cwd?: string;
@@ -14,10 +22,12 @@ export interface CreateLocalFelanRuntimeOptions {
     readonly modelRuntime?: ModelRuntime;
     readonly sessionDir?: string;
     readonly runtimeFactory?: (cwd: string) => AgentRuntime;
+    readonly skillPaths?: readonly string[];
+    readonly subagentSettings?: LocalSubagentSettings;
 }
 export declare function getLocalAgentDir(): string;
+export declare function getLocalSkillPaths(cwd: string, homeDir?: string): readonly string[];
 export declare function createLocalSessionRuntimeFactory(options: CreateLocalSessionRuntimeFactoryOptions): CreateAgentSessionRuntimeFactory;
-export declare function createLocalSessionHost(options: CreateLocalSessionRuntimeFactoryOptions, cwd: string): AgentSessionHost;
 export declare function createLocalModelRuntime(agentDir: string): Promise<ModelRuntime>;
-export declare function createLocalFelanRuntime(options?: CreateLocalFelanRuntimeOptions): Promise<import("@earendil-works/pi-coding-agent").AgentSessionRuntime>;
+export declare function createLocalFelanRuntime(options?: CreateLocalFelanRuntimeOptions): Promise<LocalFelanRuntime>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,YAAY,EACZ,cAAc,EAId,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,gCAAgC,EACrC,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;CACzD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;CACzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,uCAAuC,GAC/C,gCAAgC,CAyClC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uCAAuC,EAChD,GAAG,EAAE,MAAM,GACV,gBAAgB,CA2GlB;AAED,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAKrF;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,8BAAmC,0EAuB7C"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,YAAY,EACZ,cAAc,EAGd,KAAK,YAAY,EAEjB,KAAK,gCAAgC,EACrC,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAQzC,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAe7B,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG;IACpD,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,0BAA0B,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACrF,CAAC;AAEF,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CACnD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CACnD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAkB,GAAG,SAAS,MAAM,EAAE,CAK9F;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,uCAAuC,GAC/C,gCAAgC,CA4ElC;AAED,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAKrF;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,iBAAiB,CAAC,CAyB5B"}