@corenel/harness 0.14.0 → 0.16.0

package/dist/tools/createCrewAgent.js

@@ -0,0 +1,121 @@
+export const CREATE_CREW_AGENT_TOOL = 'create_crew_agent';
+/** Trigger types the crew loader accepts (packages/crew/store.ts TRIGGER_TYPES). */
+export const CREW_CREATE_TRIGGERS = [
+    'manual', 'file-change', 'run-complete', 'interval-while-open', 'app-init',
+    'workspace-init', 'schedule', 'continuous', 'self-directed', 'external-webhook',
+];
+/** Same rule as @corenel/crew's isValidAgentName (paths.ts), which this
+ * package does not import. */
+const NAME_RE = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+const MAX_NAME = 64;
+const MAX_LINE = 300;
+const MAX_DOC = 20000;
+const MAX_MODEL = 200;
+const str = (v) => (typeof v === 'string' ? v.trim() : '');
+/** Checks raw tool arguments. A list of problems, or the request. */
+export function checkCreateCrewArgs(args) {
+    const problems = [];
+    const name = str(args.name);
+    if (!name)
+        problems.push('name is required.');
+    else if (name.length > MAX_NAME || !NAME_RE.test(name))
+        problems.push(`name "${name}" must start with a letter or digit and use only letters, digits, - and _ (at most ${MAX_NAME}).`);
+    const description = str(args.description);
+    if (!description)
+        problems.push('description is required: one line on what the agent does.');
+    else if (description.length > MAX_LINE)
+        problems.push(`description is longer than ${MAX_LINE} characters.`);
+    const jobTitle = str(args.jobTitle);
+    if (jobTitle.length > MAX_LINE)
+        problems.push(`jobTitle is longer than ${MAX_LINE} characters.`);
+    const instructions = str(args.instructions);
+    if (!instructions)
+        problems.push('instructions are required: what the agent should do and how.');
+    const soul = str(args.soul);
+    const persona = str(args.persona);
+    for (const [k, v] of [['instructions', instructions], ['soul', soul], ['persona', persona]]) {
+        if (v.length > MAX_DOC)
+            problems.push(`${k} is longer than ${MAX_DOC} characters.`);
+    }
+    const model = str(args.model);
+    if (!model)
+        problems.push('model is required: ask the user which model this agent should use.');
+    else if (model.length > MAX_MODEL || /\s/.test(model))
+        problems.push(`model "${model}" is not a model id.`);
+    const scopeRaw = args.scope === undefined ? 'workspace' : args.scope;
+    if (scopeRaw !== 'workspace' && scopeRaw !== 'global')
+        problems.push('scope must be "workspace" or "global".');
+    const scope = scopeRaw === 'global' ? 'global' : 'workspace';
+    const triggers = [];
+    if (args.triggers !== undefined) {
+        if (!Array.isArray(args.triggers))
+            problems.push('triggers must be a list.');
+        else {
+            for (const t of args.triggers) {
+                const o = (t && typeof t === 'object' ? t : {});
+                if (typeof o.type !== 'string' || !CREW_CREATE_TRIGGERS.includes(o.type)) {
+                    problems.push(`trigger type ${JSON.stringify(o.type)} is not one of ${CREW_CREATE_TRIGGERS.join(', ')}.`);
+                    continue;
+                }
+                const config = o.config && typeof o.config === 'object' && !Array.isArray(o.config) ? o.config : undefined;
+                triggers.push({ type: o.type, ...(config ? { config } : {}) });
+            }
+        }
+    }
+    if (triggers.length === 0 && problems.length === 0)
+        triggers.push({ type: 'manual' });
+    const mayChangeFiles = args.mayChangeFiles === true;
+    if (problems.length)
+        return { ok: false, problems };
+    return { ok: true, req: { name, description, jobTitle, instructions, soul, persona, model, scope, triggers, mayChangeFiles } };
+}
+export function createCreateCrewAgentTool(creator) {
+    return {
+        name: CREATE_CREW_AGENT_TOOL,
+        description: 'Create ONE new crew agent (an installed agent the user keeps, unlike spawn_agent). Use it only after the user '
+            + 'agreed what the agent is for, its name and its model; the create-crew-agent skill walks through that. '
+            + 'Refuses a name that already exists in that scope: it never edits or replaces an agent. The new agent may read, '
+            + 'list and search files; set mayChangeFiles only when the user asked for an agent that changes files, and it '
+            + 'will still ask before each change.',
+        mutates: true,
+        parameters: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Folder-safe name: letters, digits, - and _, e.g. release-scout.' },
+                description: { type: 'string', description: 'One line on what the agent does.' },
+                jobTitle: { type: 'string', description: 'Optional role label, e.g. "Release scout".' },
+                instructions: { type: 'string', description: 'The agent\'s instructions (AGENT.md body): its job, steps, and what done looks like.' },
+                soul: { type: 'string', description: 'Optional SOUL.md: values and judgment.' },
+                persona: { type: 'string', description: 'Optional PERSONA.md: voice and tone.' },
+                model: { type: 'string', description: 'Model id the agent runs on. Required.' },
+                scope: { type: 'string', enum: ['workspace', 'global'], description: 'workspace (this project, the default) or global (every project).' },
+                triggers: {
+                    type: 'array',
+                    description: 'When it runs. Omit for manual only.',
+                    items: {
+                        type: 'object',
+                        properties: { type: { type: 'string', enum: [...CREW_CREATE_TRIGGERS] }, config: { type: 'object' } },
+                        required: ['type'],
+                    },
+                },
+                mayChangeFiles: { type: 'boolean', description: 'true only if the user wants the agent to change files; each change still asks.' },
+            },
+            required: ['name', 'description', 'instructions', 'model'],
+        },
+        async run(args) {
+            const checked = checkCreateCrewArgs(args);
+            if (!checked.ok)
+                return `Not created. Fix these and try again:\n- ${checked.problems.join('\n- ')}`;
+            try {
+                const { where } = await creator.createCrewAgent(checked.req);
+                return `Created crew agent "${checked.req.name}" (${checked.req.scope}) at ${where}. It runs on ${checked.req.model}`
+                    + `${checked.req.triggers.every((t) => t.type === 'manual') ? ', manually' : `, on ${checked.req.triggers.map((t) => t.type).join(', ')}`}. `
+                    + 'The user can open it on the Crew page to adjust anything.';
+            }
+            catch (e) {
+                return `Not created: ${e instanceof Error ? e.message : String(e)}`;
+            }
+        },
+    };
+}
+//# sourceMappingURL=createCrewAgent.js.map

package/dist/tools/createCrewAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCrewAgent.js","sourceRoot":"","sources":["../../tools/createCrewAgent.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corenel/harness",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "license": "Elastic-2.0",
   "type": "module",
   "description": "Corenel — host-agnostic agent harness (kernel). The app resolves it via the `corenel` path alias (bypasses these exports entirely); vitest aliases it to source too. Everything else — node consumers like @corenel/cli, @corenel/term, @corenel/sidecar — resolves it through this workspace package via the exports map below, which points at dist/ unconditionally (not just at publish) so in-repo and published resolution are identical: a bundle that treats @corenel/harness as external (see packages/term/build.mjs) must see the SAME module instance node sees when it later resolves this package at runtime, and plain node cannot execute the raw .ts sources at all. Run `pnpm build` here (or let a dependent's prebuild do it) before relying on this package outside the app/vitest. NOTE: @xyflow/react and dagre are NOT dependencies here at all — this package has no .tsx files and imports neither. `react` IS a real (small) runtime dependency: `todos.ts` uses `useSyncExternalStore`. It is declared below as an OPTIONAL peer, not a hard dependency, so node-only consumers (cli/term/sidecar) aren't forced to install react; node consumers hoist it today only because something else in the tree happens to pull it in. Do not add @xyflow/react or dagre as dependencies/peers without testing a packed install end to end — an earlier attempt at that (before this package had any .tsx files) failed npm's peer resolution with ERESOLVE.",
@@ -33,7 +33,7 @@
   "dependencies": {
     "openai": "^4.77.0",
     "yaml": "^2.8.3",
-    "@corenel/protocol": "0.13.0"
+    "@corenel/protocol": "0.15.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"