@robota-sdk/agent-preset 3.0.0-beta.75

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Robota 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/README.md

@@ -0,0 +1,60 @@
+# Agent Preset
+
+Preset contract and resolver for the Robota SDK. A preset is a named, pre-tuned bundle of
+`agent-framework` option overrides (persona, model/effort, permission posture, command-module
+selection, execution capabilities, autonomy). This package owns the `IPreset` contract, the
+built-in `default` preset, and the `resolvePreset` precedence merger.
+
+## Installation
+
+```bash
+npm install @robota-sdk/agent-preset
+```
+
+## Public API
+
+```typescript
+import {
+  resolvePreset,
+  listPresets,
+  getPreset,
+  defaultPreset,
+  DEFAULT_AGENT_NAME,
+} from '@robota-sdk/agent-preset';
+import type {
+  IPreset,
+  TResolvedPresetOptions,
+  IPresetSummary,
+  IResolvePresetContext,
+} from '@robota-sdk/agent-preset';
+
+// Resolve a preset into framework option overrides.
+// Precedence (low → high): preset < cliOverrides < explicit.
+const options = resolvePreset('default', {
+  cliOverrides: { model: 'some-model' },
+  explicit: { temperature: 0.2 },
+});
+
+// Discover presets for UX.
+const summaries = listPresets(); // [{ id: 'default', title, description }, ...]
+```
+
+The `default` preset carries no overrides, so resolving it is a pure no-op that reproduces the
+standard agent behaviour (no regression).
+
+## Dependency Position
+
+```
+agent-framework        ← neutral assembly + option-type SSOT
+    ↑
+agent-preset           ← this package (preset contract + resolver)
+    ↑
+agent-cli              ← consumes resolvePreset / listPresets
+```
+
+This package depends only on `@robota-sdk/agent-framework` and must not re-export it.
+
+## Links
+
+- [npm](https://www.npmjs.com/package/@robota-sdk/agent-preset)
+- [GitHub](https://github.com/woojubb/robota)

package/dist/node/index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("node:fs"),t=require("node:os"),n=require("node:path");const r={id:`default`,title:`Default`,description:`Neutral baseline preset — no overrides; reproduces the standard agent behaviour.`},i={id:`autonomous-builder`,title:`Autonomous Builder`,description:`Proactive, self-verifying builder posture — high effort, acts first, dispatches parallel subagents (persona inspired by the documented Fable 5 work-style; original English wording).`,effort:`high`,autonomy:`act-first`,enableParallelSubagents:!0,selfVerification:!0,persona:[`You are a proactive, high-autonomy builder. When you have enough to proceed, proceed and`,`complete the task — act rather than stop to ask. Keep going through the points where a more`,`hesitant assistant would pause for confirmation, and only check in when something is genuinely`,`ambiguous or risky.`,``,`Stay inside the scope of the task. Do the simplest thing that works; do not refactor, add`,`abstractions, or expand scope beyond what was asked. Handle the adjacent detail that the task`,`plainly needs, but resist turning a focused change into a sweeping one.`,``,`After making changes, verify your own work — run the tests, re-read the goal, and confirm the`,`result actually matches what was requested before you call it done.`,``,`Ground your claims in evidence. Before reporting progress, check each claim against an actual`,`tool result from this session; if something is not yet verified, say so plainly rather than`,`implying it is finished.`,``,`Be warm and honest without being sycophantic — tell people what is useful, not just what they`,`want to hear. Stay even-handed and let your conclusions follow from the evidence. When you get`,`something wrong, own it directly, correct it, and move on.`,``,`Lead with the outcome. Report results plainly instead of narrating each step, keep formatting`,`light, and stay concise.`].join(`
+`)},a={id:`careful-reviewer`,title:`Careful Reviewer`,description:`Conservative, ask-first reviewing posture — reads and plans before changing, prompts on write/exec, self-verifies, runs focused (no parallel subagents) at high effort.`,effort:`high`,autonomy:`ask-first`,enableParallelSubagents:!1,selfVerification:!0,persona:[`You are a careful, review-oriented assistant. Read and analyse before you change anything —`,`understand the surrounding code and context first, then lay out a short plan for the change and`,`wait for confirmation before you write or run things that have side effects.`,``,`When you propose a change, explain why — the reasoning behind it and the trade-offs against the`,`alternatives you considered, so the choice can be reviewed rather than taken on trust.`,``,`Stay conservative in scope. Make the change that was asked for and the detail it plainly needs;`,`do not widen the blast radius with unrequested refactors or rewrites.`,``,`Ground your claims in evidence. Before reporting progress or completion, check each claim against`,`an actual tool result from this session; if something is not yet verified, say so plainly rather`,`than implying it is done.`,``,`Be warm and honest without being sycophantic — tell people what is useful, not just what they`,`want to hear. Stay even-handed and let your conclusions follow from the evidence. When you get`,`something wrong, own it directly, correct it, and move on.`].join(`
+`)},o={id:`neutral-executor`,title:`Neutral Executor`,description:`Thin, steerable executor — follows instructions literally, minimal editorialising, strict scope, terse output; balanced autonomy, no parallel subagents, no self-verification, medium effort for predictable scripted use (neutral-alignment work-style; original English wording).`,effort:`medium`,autonomy:`balanced`,enableParallelSubagents:!1,selfVerification:!1,persona:[`Follow the system and user instructions literally. Do what was asked, the way it was asked, and`,`defer to the given instructions over your own preferences.`,``,`Editorialise as little as possible. Skip unrequested commentary, caveats, and asides — give the`,`result, not a narration of it.`,``,`Stay strictly in scope. Make only the change that was requested and the detail it plainly needs;`,`do not add adjacent refactors, comments, or features that were not asked for.`,``,`Keep output terse. Prefer the shortest response that fully answers, so the result is predictable`,`and easy to consume in a script or pipeline.`].join(`
+`)},s={"ask-first":`default`,balanced:`default`,"act-first":`acceptEdits`},c=[r,i,a,o],l=[];function u(){return[...c,...l]}function d(e){let t=new Set(c.map(e=>e.id)),n=[],r=[];for(let i of e){if(t.has(i.id)){r.push({id:i.id,reason:`collides with built-in preset`});continue}if(l.some(e=>e.id===i.id)){r.push({id:i.id,reason:`duplicate preset id`});continue}l.push(i),n.push(i.id)}return{registered:n,rejected:r}}function f(){l.length=0}function p(){return u().map(({id:e,title:t,description:n})=>({id:e,title:t,description:n}))}function m(e){return u().find(t=>t.id===e)}function h(e){let{id:t,title:n,description:r,...i}=e;return i}function g(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>e!==void 0))}function _(e,t){return t?{...e,...g(t)}:e}function v(e,t={}){let n=m(e);if(!n){let t=u().map(e=>e.id).join(`, `);throw Error(`Unknown preset: "${e}". Available presets: ${t}.`)}let r=h(n);return r=_(r,t.cliOverrides),r=_(r,t.explicit),y(r)}function y(e){return e.permissionMode===void 0?e.defaultPermissionMode===void 0?e.autonomy===void 0?e:{...e,permissionMode:s[e.autonomy]}:{...e,permissionMode:e.defaultPermissionMode}:e}const b=[`low`,`medium`,`high`,`xhigh`,`max`],x=[`ask-first`,`act-first`,`balanced`],S=[`plan`,`default`,`acceptEdits`,`bypassPermissions`],C=[`safe`,`moderate`,`full`];function w(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function T(e){return Array.isArray(e)&&e.every(e=>typeof e==`string`)}function E(e,t){let n=[[`persona`,e.persona,e=>t.persona=e],[`systemPrompt`,e.systemPrompt,e=>t.systemPrompt=e],[`appendSystemPrompt`,e.appendSystemPrompt,e=>t.appendSystemPrompt=e],[`agentName`,e.agentName,e=>t.agentName=e],[`model`,e.model,e=>t.model=e],[`language`,e.language,e=>t.language=e]];for(let[e,t,r]of n)if(t!==void 0){if(typeof t!=`string`)return`${e}: expected a string`;r(t)}}function D(e,t){let n=[[`temperature`,e.temperature,e=>t.temperature=e],[`maxOutputTokens`,e.maxOutputTokens,e=>t.maxOutputTokens=e]];for(let[e,t,r]of n)if(t!==void 0){if(typeof t!=`number`||Number.isNaN(t))return`${e}: expected a number`;r(t)}let r=[[`enableParallelSubagents`,e.enableParallelSubagents,e=>t.enableParallelSubagents=e],[`selfVerification`,e.selfVerification,e=>t.selfVerification=e]];for(let[e,t,n]of r)if(t!==void 0){if(typeof t!=`boolean`)return`${e}: expected a boolean`;n(t)}}function O(e,t){if(e.effort!==void 0){if(!b.includes(e.effort))return`effort: expected one of ${b.join(`, `)}`;t.effort=e.effort}if(e.autonomy!==void 0){if(!x.includes(e.autonomy))return`autonomy: expected one of ${x.join(`, `)}`;t.autonomy=e.autonomy}let n=[[`permissionMode`,e.permissionMode,e=>t.permissionMode=e],[`defaultPermissionMode`,e.defaultPermissionMode,e=>t.defaultPermissionMode=e]];for(let[e,t,r]of n)if(t!==void 0){if(!S.includes(t))return`${e}: expected one of ${S.join(`, `)}`;r(t)}if(e.defaultTrustLevel!==void 0){if(!C.includes(e.defaultTrustLevel))return`defaultTrustLevel: expected one of ${C.join(`, `)}`;t.defaultTrustLevel=e.defaultTrustLevel}}function k(e,t){let n=[[`allowedTools`,e.allowedTools,e=>t.allowedTools=e],[`deniedTools`,e.deniedTools,e=>t.deniedTools=e],[`enabledCommandModules`,e.enabledCommandModules,e=>t.enabledCommandModules=e],[`disabledCommandModules`,e.disabledCommandModules,e=>t.disabledCommandModules=e]];for(let[e,t,r]of n)if(t!==void 0){if(!T(t))return`${e}: expected an array of strings`;r(t)}}function A(e){if(!w(e))return{ok:!1,error:`preset: expected a non-null object`};let t=[[`id`,e.id],[`title`,e.title],[`description`,e.description]];for(let[e,n]of t)if(typeof n!=`string`||n.length===0)return{ok:!1,error:`${e}: expected a non-empty string`};let n={},r=E(e,n)??D(e,n)??O(e,n)??k(e,n);return r===void 0?{ok:!0,preset:{id:e.id,title:e.title,description:e.description,...n}}:{ok:!1,error:r}}function j(){return(0,n.join)((0,t.homedir)(),`.robota`,`presets`)}function M(t){if(!(0,e.existsSync)(t))return{loaded:[],errors:[]};let r=[],i=[],a=new Map,o=(0,e.readdirSync)(t).filter(e=>e.endsWith(`.json`));for(let s of o){let o=(0,n.join)(t,s),c;try{c=JSON.parse((0,e.readFileSync)(o,`utf8`))}catch(e){r.push({file:s,error:e instanceof Error?e.message:String(e)});continue}let l=A(c);if(!l.ok){r.push({file:s,error:l.error});continue}i.push(l.preset),a.set(l.preset.id,s)}let s=d(i);for(let e of s.rejected)r.push({file:a.get(e.id)??e.id,error:e.reason});return{loaded:s.registered,errors:r}}function N(e){return M(e?.dir??j())}exports.DEFAULT_AGENT_NAME=`robota-cli`,exports.autonomousBuilderPreset=i,exports.clearExternalPresets=f,exports.defaultExternalPresetDir=j,exports.defaultPreset=r,exports.getPreset=m,exports.listPresets=p,exports.loadExternalPresets=N,exports.loadExternalPresetsFromDir=M,exports.registerExternalPresets=d,exports.resolvePreset=v,exports.validateExternalPreset=A;

package/dist/node/index.d.ts

@@ -0,0 +1,204 @@
+import { ICreateSessionOptions } from "@robota-sdk/agent-framework";
+
+//#region src/preset-types.d.ts
+/**
+ * Effort dial passed through to the model invocation (mechanism, not persona text).
+ * `'xhigh'` corresponds to the long-running ("ultra") tier; `'high'` is the neutral default.
+ *
+ * Reuses the framework's `ICreateSessionOptions['effort']` channel (which is the
+ * `agent-core` `TModelEffort` SSOT) so a resolved preset effort threads straight to the
+ * provider invocation seam (PRESET-008) without introducing a parallel union.
+ */
+type TPresetEffort = NonNullable<ICreateSessionOptions['effort']>;
+/**
+ * Behavioural autonomy posture. Drives the permission posture
+ * (`permissionMode` / `defaultTrustLevel`) — it is a mechanism mapping, not a display label.
+ */
+type TPresetAutonomy = 'ask-first' | 'balanced' | 'act-first';
+/** Default trust level applied when the preset opts into a coarse permission posture. */
+type TPresetTrustLevel = 'safe' | 'moderate' | 'full';
+/**
+ * Permission mode reused from the framework option SSOT (`ICreateSessionOptions`).
+ * Reusing the indexed access keeps a single source of truth for the permission-mode union.
+ */
+type TPresetPermissionMode = ICreateSessionOptions['permissionMode'];
+/**
+ * The framework-facing option subset a preset resolves into. Every field maps to an
+ * existing `agent-framework` session/assembly seam; presets never introduce new option types.
+ */
+interface TResolvedPresetOptions {
+  /**
+   * Portable persona/behaviour block (tone, refusal philosophy, output style, proactivity).
+   * Composed by the framework as a `source: 'persona'` system-prompt section (priority 5) —
+   * never runtime/tool/product-identity text. Empty/undefined adds no section (no regression).
+   */
+  persona?: string;
+  systemPrompt?: string;
+  appendSystemPrompt?: string;
+  agentName?: string;
+  model?: string;
+  language?: string;
+  effort?: TPresetEffort;
+  temperature?: number;
+  maxOutputTokens?: number;
+  /**
+   * Resolved framework permission-mode seam. The end value the assembly applies.
+   * Populated either directly, from `defaultPermissionMode`, or from the
+   * `autonomy` mapping (precedence: explicit `permissionMode` > `defaultPermissionMode`
+   * > `autonomy` mapping).
+   */
+  permissionMode?: TPresetPermissionMode;
+  /**
+   * Coarse permission posture declared by a preset. When set (and no explicit
+   * `permissionMode`), {@link resolvePreset} promotes it to `permissionMode`.
+   */
+  defaultPermissionMode?: TPresetPermissionMode;
+  defaultTrustLevel?: TPresetTrustLevel;
+  allowedTools?: readonly string[];
+  deniedTools?: readonly string[];
+  enabledCommandModules?: readonly string[];
+  disabledCommandModules?: readonly string[];
+  enableParallelSubagents?: boolean;
+  selfVerification?: boolean;
+  autonomy?: TPresetAutonomy;
+}
+/**
+ * A named, pre-tuned bundle of framework option overrides plus display identity.
+ * Extends `TResolvedPresetOptions` (type SSOT) and adds the identity triple.
+ */
+interface IPreset extends TResolvedPresetOptions {
+  id: string;
+  title: string;
+  description: string;
+}
+//#endregion
+//#region src/presets/default.d.ts
+/**
+ * The neutral baseline preset. It carries NO option overrides so that resolving it is a
+ * pure no-op — applying `default` reproduces the standard agent behaviour exactly (no regression).
+ * The default agent identity is owned by `DEFAULT_AGENT_NAME` in `resolve-preset.ts`, not here,
+ * so that this preset stays a true identity element under merging.
+ */
+declare const defaultPreset: IPreset;
+//#endregion
+//#region src/presets/autonomous-builder.d.ts
+/**
+ * The first opinionated built-in preset: an autonomous, self-verifying builder posture.
+ *
+ * It both ships a portable persona block AND sets the framework/executor mechanism flags
+ * (`effort`, `autonomy`, `enableParallelSubagents`, `selfVerification`) so the style is backed
+ * by real, observable behaviour rather than persona text alone. The identifier is generic; the
+ * sourcing footnote in `description` is the only place a work-style attribution appears.
+ *
+ * For long-running tasks the effort dial may be raised to a higher tier; `'high'` is the
+ * neutral default carried here.
+ */
+declare const autonomousBuilderPreset: IPreset;
+//#endregion
+//#region src/resolve-preset.d.ts
+/**
+ * Default agent identity. Owned by `agent-preset` (not baked into `defaultPreset`, which must stay
+ * a no-op). Consumers apply this when no preset and no explicit override supplies an `agentName`.
+ */
+declare const DEFAULT_AGENT_NAME = "robota-cli";
+/** Lightweight `{ id, title, description }` view of a preset for discovery/UX. */
+interface IPresetSummary {
+  id: string;
+  title: string;
+  description: string;
+}
+/** Outcome of {@link registerExternalPresets}: which ids registered and which were rejected. */
+interface IPresetRegistrationResult {
+  registered: readonly string[];
+  rejected: readonly {
+    id: string;
+    reason: string;
+  }[];
+}
+/**
+ * Register user-authored external presets into the module-level registry.
+ *
+ * Conflict policy: an external preset whose id matches a BUILT-IN preset is rejected
+ * (`'collides with built-in preset'`) — built-ins always win. An external preset whose id
+ * matches an already-registered external preset is rejected (`'duplicate preset id'`) — first
+ * registration wins. All other presets are appended and counted as registered.
+ *
+ * @returns the ids that registered and the `{ id, reason }` of each rejection.
+ */
+declare function registerExternalPresets(presets: readonly IPreset[]): IPresetRegistrationResult;
+/**
+ * Remove every registered external preset, leaving only the built-ins.
+ * Used at startup before a fresh re-load and for test isolation.
+ */
+declare function clearExternalPresets(): void;
+/**
+ * Override layers for {@link resolvePreset}, in increasing precedence.
+ * `cliOverrides` model CLI flags; `explicit` models programmatic/SDK options.
+ */
+interface IResolvePresetContext {
+  cliOverrides?: TResolvedPresetOptions;
+  explicit?: TResolvedPresetOptions;
+}
+/** Return the `{ id, title, description }` summary of every registered preset. */
+declare function listPresets(): readonly IPresetSummary[];
+/** Look up a registered preset by id, or `undefined` if none matches. */
+declare function getPreset(id: string): IPreset | undefined;
+/**
+ * Resolve a preset id into framework option overrides.
+ *
+ * Precedence LOW → HIGH: preset options < `context.cliOverrides` < `context.explicit`
+ * (later layers win; `undefined` values are skipped). For the no-op `'default'` preset the
+ * result equals the merged overrides, guaranteeing no regression.
+ *
+ * @throws Error when `id` does not match a registered preset.
+ */
+declare function resolvePreset(id: string, context?: IResolvePresetContext): TResolvedPresetOptions;
+//#endregion
+//#region src/load-external-presets.d.ts
+/** Outcome of an external-preset load: which ids loaded and per-file load/validation errors. */
+interface IExternalPresetLoadResult {
+  loaded: readonly string[];
+  errors: readonly {
+    file: string;
+    error: string;
+  }[];
+}
+/** Conventional external-preset directory: `~/.robota/presets`. */
+declare function defaultExternalPresetDir(): string;
+/**
+ * Load, validate, and register every `*.json` external preset from `dir`.
+ *
+ * A missing directory yields an empty result (no error). Each file is JSON-parsed and validated;
+ * a parse or validation failure is recorded as a per-file error and skipped — the remaining files
+ * still load. Validated presets are registered via {@link registerExternalPresets}; registry
+ * rejections (built-in id collision or duplicate id) are folded into `errors` against their file.
+ */
+declare function loadExternalPresetsFromDir(dir: string): IExternalPresetLoadResult;
+/**
+ * Load external presets from the conventional directory (or `options.dir` when given).
+ * Thin wrapper over {@link loadExternalPresetsFromDir}.
+ */
+declare function loadExternalPresets(options?: {
+  dir?: string;
+}): IExternalPresetLoadResult;
+//#endregion
+//#region src/preset-validation.d.ts
+/** Result of {@link validateExternalPreset}: the validated preset, or a single error message. */
+type TPresetValidationResult = {
+  ok: true;
+  preset: IPreset;
+} | {
+  ok: false;
+  error: string;
+};
+/**
+ * Manually validate an unknown value as an {@link IPreset} (no schema library).
+ *
+ * Required fields: non-empty `id`, `title`, `description` strings. Every other field is
+ * optional and is validated only when present; an unrecognised field is dropped (the built
+ * preset carries the recognised fields only, never unknown keys). On the first failed check
+ * returns `{ ok: false, error: '<field>: <reason>' }`.
+ */
+declare function validateExternalPreset(value: unknown): TPresetValidationResult;
+//#endregion
+export { DEFAULT_AGENT_NAME, type IExternalPresetLoadResult, type IPreset, type IPresetRegistrationResult, type IPresetSummary, type IResolvePresetContext, type TPresetAutonomy, type TPresetEffort, type TPresetPermissionMode, type TPresetTrustLevel, type TPresetValidationResult, type TResolvedPresetOptions, autonomousBuilderPreset, clearExternalPresets, defaultExternalPresetDir, defaultPreset, getPreset, listPresets, loadExternalPresets, loadExternalPresetsFromDir, registerExternalPresets, resolvePreset, validateExternalPreset };

package/dist/node/index.js

@@ -0,0 +1,4 @@
+import{existsSync as e,readFileSync as t,readdirSync as n}from"node:fs";import{homedir as r}from"node:os";import{join as i}from"node:path";const a={id:`default`,title:`Default`,description:`Neutral baseline preset — no overrides; reproduces the standard agent behaviour.`},o={id:`autonomous-builder`,title:`Autonomous Builder`,description:`Proactive, self-verifying builder posture — high effort, acts first, dispatches parallel subagents (persona inspired by the documented Fable 5 work-style; original English wording).`,effort:`high`,autonomy:`act-first`,enableParallelSubagents:!0,selfVerification:!0,persona:[`You are a proactive, high-autonomy builder. When you have enough to proceed, proceed and`,`complete the task — act rather than stop to ask. Keep going through the points where a more`,`hesitant assistant would pause for confirmation, and only check in when something is genuinely`,`ambiguous or risky.`,``,`Stay inside the scope of the task. Do the simplest thing that works; do not refactor, add`,`abstractions, or expand scope beyond what was asked. Handle the adjacent detail that the task`,`plainly needs, but resist turning a focused change into a sweeping one.`,``,`After making changes, verify your own work — run the tests, re-read the goal, and confirm the`,`result actually matches what was requested before you call it done.`,``,`Ground your claims in evidence. Before reporting progress, check each claim against an actual`,`tool result from this session; if something is not yet verified, say so plainly rather than`,`implying it is finished.`,``,`Be warm and honest without being sycophantic — tell people what is useful, not just what they`,`want to hear. Stay even-handed and let your conclusions follow from the evidence. When you get`,`something wrong, own it directly, correct it, and move on.`,``,`Lead with the outcome. Report results plainly instead of narrating each step, keep formatting`,`light, and stay concise.`].join(`
+`)},s={id:`careful-reviewer`,title:`Careful Reviewer`,description:`Conservative, ask-first reviewing posture — reads and plans before changing, prompts on write/exec, self-verifies, runs focused (no parallel subagents) at high effort.`,effort:`high`,autonomy:`ask-first`,enableParallelSubagents:!1,selfVerification:!0,persona:[`You are a careful, review-oriented assistant. Read and analyse before you change anything —`,`understand the surrounding code and context first, then lay out a short plan for the change and`,`wait for confirmation before you write or run things that have side effects.`,``,`When you propose a change, explain why — the reasoning behind it and the trade-offs against the`,`alternatives you considered, so the choice can be reviewed rather than taken on trust.`,``,`Stay conservative in scope. Make the change that was asked for and the detail it plainly needs;`,`do not widen the blast radius with unrequested refactors or rewrites.`,``,`Ground your claims in evidence. Before reporting progress or completion, check each claim against`,`an actual tool result from this session; if something is not yet verified, say so plainly rather`,`than implying it is done.`,``,`Be warm and honest without being sycophantic — tell people what is useful, not just what they`,`want to hear. Stay even-handed and let your conclusions follow from the evidence. When you get`,`something wrong, own it directly, correct it, and move on.`].join(`
+`)},c={id:`neutral-executor`,title:`Neutral Executor`,description:`Thin, steerable executor — follows instructions literally, minimal editorialising, strict scope, terse output; balanced autonomy, no parallel subagents, no self-verification, medium effort for predictable scripted use (neutral-alignment work-style; original English wording).`,effort:`medium`,autonomy:`balanced`,enableParallelSubagents:!1,selfVerification:!1,persona:[`Follow the system and user instructions literally. Do what was asked, the way it was asked, and`,`defer to the given instructions over your own preferences.`,``,`Editorialise as little as possible. Skip unrequested commentary, caveats, and asides — give the`,`result, not a narration of it.`,``,`Stay strictly in scope. Make only the change that was requested and the detail it plainly needs;`,`do not add adjacent refactors, comments, or features that were not asked for.`,``,`Keep output terse. Prefer the shortest response that fully answers, so the result is predictable`,`and easy to consume in a script or pipeline.`].join(`
+`)},l={"ask-first":`default`,balanced:`default`,"act-first":`acceptEdits`},u=`robota-cli`,d=[a,o,s,c],f=[];function p(){return[...d,...f]}function m(e){let t=new Set(d.map(e=>e.id)),n=[],r=[];for(let i of e){if(t.has(i.id)){r.push({id:i.id,reason:`collides with built-in preset`});continue}if(f.some(e=>e.id===i.id)){r.push({id:i.id,reason:`duplicate preset id`});continue}f.push(i),n.push(i.id)}return{registered:n,rejected:r}}function h(){f.length=0}function g(){return p().map(({id:e,title:t,description:n})=>({id:e,title:t,description:n}))}function _(e){return p().find(t=>t.id===e)}function v(e){let{id:t,title:n,description:r,...i}=e;return i}function y(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>e!==void 0))}function b(e,t){return t?{...e,...y(t)}:e}function x(e,t={}){let n=_(e);if(!n){let t=p().map(e=>e.id).join(`, `);throw Error(`Unknown preset: "${e}". Available presets: ${t}.`)}let r=v(n);return r=b(r,t.cliOverrides),r=b(r,t.explicit),S(r)}function S(e){return e.permissionMode===void 0?e.defaultPermissionMode===void 0?e.autonomy===void 0?e:{...e,permissionMode:l[e.autonomy]}:{...e,permissionMode:e.defaultPermissionMode}:e}const C=[`low`,`medium`,`high`,`xhigh`,`max`],w=[`ask-first`,`act-first`,`balanced`],T=[`plan`,`default`,`acceptEdits`,`bypassPermissions`],E=[`safe`,`moderate`,`full`];function D(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function O(e){return Array.isArray(e)&&e.every(e=>typeof e==`string`)}function k(e,t){let n=[[`persona`,e.persona,e=>t.persona=e],[`systemPrompt`,e.systemPrompt,e=>t.systemPrompt=e],[`appendSystemPrompt`,e.appendSystemPrompt,e=>t.appendSystemPrompt=e],[`agentName`,e.agentName,e=>t.agentName=e],[`model`,e.model,e=>t.model=e],[`language`,e.language,e=>t.language=e]];for(let[e,t,r]of n)if(t!==void 0){if(typeof t!=`string`)return`${e}: expected a string`;r(t)}}function A(e,t){let n=[[`temperature`,e.temperature,e=>t.temperature=e],[`maxOutputTokens`,e.maxOutputTokens,e=>t.maxOutputTokens=e]];for(let[e,t,r]of n)if(t!==void 0){if(typeof t!=`number`||Number.isNaN(t))return`${e}: expected a number`;r(t)}let r=[[`enableParallelSubagents`,e.enableParallelSubagents,e=>t.enableParallelSubagents=e],[`selfVerification`,e.selfVerification,e=>t.selfVerification=e]];for(let[e,t,n]of r)if(t!==void 0){if(typeof t!=`boolean`)return`${e}: expected a boolean`;n(t)}}function j(e,t){if(e.effort!==void 0){if(!C.includes(e.effort))return`effort: expected one of ${C.join(`, `)}`;t.effort=e.effort}if(e.autonomy!==void 0){if(!w.includes(e.autonomy))return`autonomy: expected one of ${w.join(`, `)}`;t.autonomy=e.autonomy}let n=[[`permissionMode`,e.permissionMode,e=>t.permissionMode=e],[`defaultPermissionMode`,e.defaultPermissionMode,e=>t.defaultPermissionMode=e]];for(let[e,t,r]of n)if(t!==void 0){if(!T.includes(t))return`${e}: expected one of ${T.join(`, `)}`;r(t)}if(e.defaultTrustLevel!==void 0){if(!E.includes(e.defaultTrustLevel))return`defaultTrustLevel: expected one of ${E.join(`, `)}`;t.defaultTrustLevel=e.defaultTrustLevel}}function M(e,t){let n=[[`allowedTools`,e.allowedTools,e=>t.allowedTools=e],[`deniedTools`,e.deniedTools,e=>t.deniedTools=e],[`enabledCommandModules`,e.enabledCommandModules,e=>t.enabledCommandModules=e],[`disabledCommandModules`,e.disabledCommandModules,e=>t.disabledCommandModules=e]];for(let[e,t,r]of n)if(t!==void 0){if(!O(t))return`${e}: expected an array of strings`;r(t)}}function N(e){if(!D(e))return{ok:!1,error:`preset: expected a non-null object`};let t=[[`id`,e.id],[`title`,e.title],[`description`,e.description]];for(let[e,n]of t)if(typeof n!=`string`||n.length===0)return{ok:!1,error:`${e}: expected a non-empty string`};let n={},r=k(e,n)??A(e,n)??j(e,n)??M(e,n);return r===void 0?{ok:!0,preset:{id:e.id,title:e.title,description:e.description,...n}}:{ok:!1,error:r}}function P(){return i(r(),`.robota`,`presets`)}function F(r){if(!e(r))return{loaded:[],errors:[]};let a=[],o=[],s=new Map,c=n(r).filter(e=>e.endsWith(`.json`));for(let e of c){let n=i(r,e),c;try{c=JSON.parse(t(n,`utf8`))}catch(t){a.push({file:e,error:t instanceof Error?t.message:String(t)});continue}let l=N(c);if(!l.ok){a.push({file:e,error:l.error});continue}o.push(l.preset),s.set(l.preset.id,e)}let l=m(o);for(let e of l.rejected)a.push({file:s.get(e.id)??e.id,error:e.reason});return{loaded:l.registered,errors:a}}function I(e){return F(e?.dir??P())}export{u as DEFAULT_AGENT_NAME,o as autonomousBuilderPreset,h as clearExternalPresets,P as defaultExternalPresetDir,a as defaultPreset,_ as getPreset,g as listPresets,I as loadExternalPresets,F as loadExternalPresetsFromDir,m as registerExternalPresets,x as resolvePreset,N as validateExternalPreset};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@robota-sdk/agent-preset",
+  "version": "3.0.0-beta.75",
+  "description": "Preset contract and resolver for the Robota SDK (IPreset, resolvePreset, listPresets, built-in presets)",
+  "type": "module",
+  "main": "dist/node/index.js",
+  "types": "dist/node/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/node/index.d.ts",
+      "source": "./src/index.ts",
+      "node": {
+        "import": "./dist/node/index.js",
+        "require": "./dist/node/index.cjs"
+      },
+      "default": {
+        "import": "./dist/node/index.js",
+        "require": "./dist/node/index.cjs"
+      }
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/woojubb/robota.git"
+  },
+  "homepage": "https://robota.io/",
+  "bugs": {
+    "url": "https://github.com/woojubb/robota/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@robota-sdk/agent-framework": "3.0.0-beta.75"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.10",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.6"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "build:js": "tsdown --no-dts",
+    "build:types": "tsdown --dts",
+    "test": "vitest run --passWithNoTests",
+    "test:coverage": "vitest run --coverage --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/ --ext .ts",
+    "clean": "rimraf dist"
+  }
+}