@felan-ai/ext-output-style 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Felan contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,6 @@
+@felan-ai/ext-output-style
+
+Copyright (c) 2026 Felan contributors
+
+This package is original Felan code licensed under the MIT License included in
+this package. It has no third-party runtime dependencies.

package/README.md

@@ -0,0 +1,29 @@
+# @felan-ai/ext-output-style
+
+Portable output-style instructions for Felan sessions.
+
+The extension appends one clearly bounded `## Output Style` section to the
+system prompt before each model run. It accepts only the built-in `concise` and
+`explanatory` styles; arbitrary prompt text and file-backed styles are not
+supported. `concise` is the default.
+
+```ts
+import { createOutputStyleExtension } from '@felan-ai/ext-output-style';
+
+const extension = createOutputStyleExtension('explanatory');
+```
+
+The Felan TUI validates its global `outputStyle` setting and binds the selected
+style to this extension for root and child sessions.
+
+## Development
+
+Source: `packages/ext-output-style` in <https://github.com/felan-ai/felan>.
+
+```sh
+corepack enable
+pnpm install --frozen-lockfile
+pnpm --filter @felan-ai/ext-output-style build
+pnpm --filter @felan-ai/ext-output-style type-check
+pnpm --filter @felan-ai/ext-output-style test
+```

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { FelanExtension } from '@felan-ai/agent-core';
+export declare const OUTPUT_STYLES: readonly ["concise", "explanatory"];
+export type OutputStyle = typeof OUTPUT_STYLES[number];
+export declare const DEFAULT_OUTPUT_STYLE: OutputStyle;
+export declare function parseOutputStyle(value?: unknown): OutputStyle;
+export declare function formatOutputStyleSection(style: OutputStyle): string;
+export declare function createOutputStyleExtension(value?: unknown): FelanExtension;
+declare const outputStyleExtension: FelanExtension;
+export default outputStyleExtension;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,aAAa,qCAAsC,CAAC;AACjE,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,oBAAoB,EAAE,WAAuB,CAAC;AAkB3D,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,OAA8B,GAAG,WAAW,CAKnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQnE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,GAAE,OAA8B,GAAG,cAAc,CAShG;AAED,QAAA,MAAM,oBAAoB,gBAA+B,CAAC;AAE1D,eAAe,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+export const OUTPUT_STYLES = ['concise', 'explanatory'];
+export const DEFAULT_OUTPUT_STYLE = 'concise';
+const OUTPUT_STYLE_START = '<output_style>';
+const OUTPUT_STYLE_END = '</output_style>';
+const STYLE_INSTRUCTIONS = {
+    concise: [
+        'Keep responses concise and direct. Lead with the outcome or next action.',
+        'Use headings and bullets only when they make the response easier to scan.',
+        'Do not omit necessary caveats, verification results, or blockers for brevity.',
+    ],
+    explanatory: [
+        'Explain the reasoning and important tradeoffs behind recommendations and changes.',
+        'Provide enough context for the user to understand how the result works and how to verify it.',
+        'Keep explanations relevant to the request and avoid repeating the same point.',
+    ],
+};
+export function parseOutputStyle(value = DEFAULT_OUTPUT_STYLE) {
+    if (typeof value === 'string' && OUTPUT_STYLES.includes(value)) {
+        return value;
+    }
+    throw new Error(`outputStyle must be one of: ${OUTPUT_STYLES.join(', ')}`);
+}
+export function formatOutputStyleSection(style) {
+    return [
+        '## Output Style',
+        '',
+        OUTPUT_STYLE_START,
+        ...STYLE_INSTRUCTIONS[style].map((instruction) => `- ${instruction}`),
+        OUTPUT_STYLE_END,
+    ].join('\n');
+}
+export function createOutputStyleExtension(value = DEFAULT_OUTPUT_STYLE) {
+    const style = parseOutputStyle(value);
+    const section = formatOutputStyleSection(style);
+    return (pi) => {
+        pi.on('before_agent_start', (event) => {
+            return { systemPrompt: `${event.systemPrompt}\n\n${section}` };
+        });
+    };
+}
+const outputStyleExtension = createOutputStyleExtension();
+export default outputStyleExtension;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,aAAa,CAAU,CAAC;AAGjE,MAAM,CAAC,MAAM,oBAAoB,GAAgB,SAAS,CAAC;AAE3D,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAC5C,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAE3C,MAAM,kBAAkB,GAAqD;IAC3E,OAAO,EAAE;QACP,0EAA0E;QAC1E,2EAA2E;QAC3E,+EAA+E;KAChF;IACD,WAAW,EAAE;QACX,mFAAmF;QACnF,8FAA8F;QAC9F,+EAA+E;KAChF;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,QAAiB,oBAAoB;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAoB,CAAC,EAAE,CAAC;QAC9E,OAAO,KAAoB,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAkB;IACzD,OAAO;QACL,iBAAiB;QACjB,EAAE;QACF,kBAAkB;QAClB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,KAAK,WAAW,EAAE,CAAC;QACrE,gBAAgB;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAiB,oBAAoB;IAC9E,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEhD,OAAO,CAAC,EAAE,EAAE,EAAE;QACZ,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE;YACpC,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,YAAY,OAAO,OAAO,EAAE,EAAE,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAG,0BAA0B,EAAE,CAAC;AAE1D,eAAe,oBAAoB,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@felan-ai/ext-output-style",
+  "version": "0.0.0",
+  "description": "Portable output-style system prompt extension for Felan",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/felan-ai/felan.git",
+    "directory": "packages/ext-output-style"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@felan-ai/agent-core": "^0.4.0"
+  },
+  "devDependencies": {
+    "@felan-ai/agent-core": "0.4.9"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}