@corenel/harness 0.7.5 → 0.9.0

package/dist/tools/project.d.ts

@@ -0,0 +1,11 @@
+import type { AgentTool, ToolContext } from '@corenel/protocol';
+/** Folder → name for every project in the workspace. */
+export declare function findProjects(ctx: ToolContext): Promise<{
+    root: string;
+    name: string;
+}[]>;
+/** The app's slug rule, kept identical so a project made here and one made in
+ * the rail land in the same folder for the same name. */
+export declare function projectSlug(name: string): string;
+export declare const startProjectTool: AgentTool;
+//# sourceMappingURL=project.d.ts.map

package/dist/tools/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../tools/project.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQhE,wDAAwD;AACxD,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAgB9F;AAED;yDACyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAWD,eAAO,MAAM,gBAAgB,EAAE,SA6F9B,CAAC"}

package/dist/tools/project.js

@@ -0,0 +1,133 @@
+import { stateDirName, flattenFiles } from '@corenel/protocol';
+const manifestSuffix = () => `${stateDirName()}/craft/project.json`;
+/** Folder → name for every project in the workspace. */
+export async function findProjects(ctx) {
+    const files = ctx.files;
+    if (!files)
+        return [];
+    const suffix = manifestSuffix();
+    const nodes = await files.list().catch(() => []);
+    const out = [];
+    for (const node of flattenFiles(nodes)) {
+        const p = node.path;
+        const root = p === suffix ? '' : p.endsWith(`/${suffix}`) ? p.slice(0, -(suffix.length + 1)) : null;
+        if (root === null)
+            continue;
+        try {
+            const m = JSON.parse(await files.read(p));
+            if (m && m.version === 1 && typeof m.name === 'string')
+                out.push({ root, name: m.name });
+        }
+        catch { /* an unreadable manifest is not a project */ }
+    }
+    return out;
+}
+/** The app's slug rule, kept identical so a project made here and one made in
+ * the rail land in the same folder for the same name. */
+export function projectSlug(name) {
+    const s = name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 64);
+    return s || 'project';
+}
+/** First free folder for this name — `notes`, then `notes-2`, … */
+async function freeRoot(ctx, name) {
+    const files = ctx.files;
+    const base = projectSlug(name);
+    let root = base;
+    for (let i = 2; files && (await files.stat(root)) !== null; i++)
+        root = `${base}-${i}`;
+    return root;
+}
+export const startProjectTool = {
+    name: 'start_project',
+    /* DECLARED, like ask_user's, and for the same reason: its whole effect is to
+     * put a choice in front of someone who is already there, and the write it
+     * may then make is the thing they just chose. A permission prompt on top of
+     * the choice is two dialogs for one decision. */
+    permission: 'allow',
+    noOffload: true,
+    description: 'Use when the person asks for a DOCUMENT (a memo, report, deck, spreadsheet, diagram, page) and the system '
+        + 'context says no project is open. Documents live inside a project, where they are versioned and shown beside '
+        + 'the conversation; a file written outside one is invisible in this surface. Propose a short project name '
+        + 'derived from what they asked for — the person confirms it, picks an existing project instead, or declines. '
+        + 'This call WAITS for their answer and returns the folder to write into, or that they declined. Write the '
+        + 'document inside that folder with the ordinary file tools. Do NOT use this for ordinary code or repository '
+        + 'files, which belong where they already are.',
+    parameters: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Proposed project name, 2-4 words, derived from the request.' },
+            reason: { type: 'string', description: 'One short line: what is about to be written into it.' },
+        },
+        required: ['name'],
+    },
+    async run(args, ctx) {
+        const files = ctx.files;
+        if (!files)
+            return 'start_project is unavailable: no file workspace is connected.';
+        if (!ctx.ask)
+            return 'start_project is unavailable in this environment (nobody can be asked).';
+        if (!files.writable)
+            return 'This workspace is read-only, so no project can be created in it.';
+        const proposed = (typeof args.name === 'string' ? args.name : '').trim() || 'Untitled project';
+        const existing = await findProjects(ctx);
+        /* The proposal FIRST, so the one-tap path is the first thing under the
+         * cursor, then up to three existing projects. Three is the cap because
+         * ask_user takes 2-4 options and the proposal owns one of them; a long
+         * list here would be a project picker, which is the rail's job. */
+        const createLabel = `Create "${proposed}"`;
+        const options = [
+            { label: createLabel, description: typeof args.reason === 'string' && args.reason ? args.reason : 'A new project for this work.' },
+            ...existing.slice(0, 3).map((p) => ({ label: p.name, description: `Put it in the existing project at ${p.root || 'the workspace root'}.` })),
+        ];
+        if (options.length < 2)
+            options.push({ label: 'Not now', description: 'Write nothing; the document has nowhere to live yet.' });
+        /* TWO questions in one card when the conversation can come along.
+         *
+         * The chat that asks for a document is the chat that project is FOR, and
+         * being asked afterwards, in a separate banner, to bring along the
+         * conversation you are already in is a second decision about the same
+         * thing. Asked here it is one card: where does this go, and does this
+         * conversation go with it.
+         *
+         * Only offered when the host can actually do it (ctx.moveSessionToProject
+         * is absent on a surface with no projects), and only phrased as a question
+         * when there is something to move it INTO. */
+        const canMove = !!ctx.moveSessionToProject;
+        const questions = [
+            { header: 'Project', question: 'Documents live in a project. Where should this one go?', options },
+            ...(canMove
+                ? [{
+                        header: 'This chat',
+                        question: 'Bring this conversation into the project too?',
+                        options: [
+                            { label: 'Yes, move it', description: 'The transcript moves with the work, and this chat carries on.' },
+                            { label: 'Keep it loose', description: 'The document goes in the project; this chat stays where it is.' },
+                        ],
+                    }]
+                : []),
+        ];
+        const answers = await ctx.ask(questions);
+        const picked = answers ? answers.Project?.[0] : undefined;
+        const move = answers ? answers['This chat']?.[0] === 'Yes, move it' : false;
+        if (!picked)
+            return 'The person did not choose a project. Do not write the document; say what you were about to write and that it needs a project.';
+        if (picked === 'Not now')
+            return 'The person declined to start a project. Do not write the document.';
+        /* The move is reported back as its own sentence, appended to the answer:
+         * the model has to know where this conversation now lives before it says
+         * what it did. */
+        const moved = async (root) => (move && ctx.moveSessionToProject ? ` ${await ctx.moveSessionToProject(root)}` : '');
+        const hit = existing.find((p) => p.name === picked);
+        if (hit)
+            return `Use the existing project "${hit.name}". Write the document inside ${hit.root || 'the workspace root'}/.${await moved(hit.root)}`;
+        /* Anything else is the create option, or a name they typed themselves --
+         * ask_user lets the person write their own answer, and a typed name is a
+         * name, not an error. */
+        const name = picked === createLabel ? proposed : picked;
+        const root = await freeRoot(ctx, name);
+        const manifest = { name, createdAt: Date.now(), version: 1 };
+        await files.write(`${root}/${manifestSuffix()}`, JSON.stringify(manifest, null, 2));
+        return `Created the project "${name}" at ${root}/. Write the document inside ${root}/ with the ordinary file tools; it will be versioned and shown beside this conversation.${await moved(root)}`;
+    },
+};
+//# sourceMappingURL=project.js.map

package/dist/tools/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../tools/project.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAK/D,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,GAAG,YAAY,EAAE,qBAAqB,CAAC;AAE5E,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAgB;IACjD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,GAAG,GAAqC,EAAE,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACpB,MAAM,IAAI,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpG,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC5B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAA6B,CAAC;YACtE,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3F,CAAC;QAAC,MAAM,CAAC,CAAC,6CAA6C,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;yDACyD;AACzD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrG,OAAO,CAAC,IAAI,SAAS,CAAC;AACxB,CAAC;AAED,mEAAmE;AACnE,KAAK,UAAU,QAAQ,CAAC,GAAgB,EAAE,IAAY;IACpD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;QAAE,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,IAAI,EAAE,eAAe;IACrB;;;qDAGiD;IACjD,UAAU,EAAE,OAAO;IACnB,SAAS,EAAE,IAAI;IACf,WAAW,EACT,4GAA4G;UAC1G,8GAA8G;UAC9G,0GAA0G;UAC1G,6GAA6G;UAC7G,0GAA0G;UAC1G,4GAA4G;UAC5G,6CAA6C;IACjD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;YACpG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;SAChG;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;QACjB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK;YAAE,OAAO,+DAA+D,CAAC;QACnF,IAAI,CAAC,GAAG,CAAC,GAAG;YAAE,OAAO,yEAAyE,CAAC;QAC/F,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,OAAO,kEAAkE,CAAC;QAE/F,MAAM,QAAQ,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,kBAAkB,CAAC;QAC/F,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QAEzC;;;2EAGmE;QACnE,MAAM,WAAW,GAAG,WAAW,QAAQ,GAAG,CAAC;QAC3C,MAAM,OAAO,GAAG;YACd,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,8BAA8B,EAAE;YAClI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,qCAAqC,CAAC,CAAC,IAAI,IAAI,oBAAoB,GAAG,EAAE,CAAC,CAAC;SAC7I,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC,CAAC;QAEhI;;;;;;;;;;sDAU8C;QAC9C,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAC3C,MAAM,SAAS,GAAG;YAChB,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,wDAAwD,EAAE,OAAO,EAAE;YAClG,GAAG,CAAC,OAAO;gBACT,CAAC,CAAC,CAAC;wBACD,MAAM,EAAE,WAAW;wBACnB,QAAQ,EAAE,+CAA+C;wBACzD,OAAO,EAAE;4BACP,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,+DAA+D,EAAE;4BACvG,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gEAAgE,EAAE;yBAC1G;qBACF,CAAC;gBACF,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5E,IAAI,CAAC,MAAM;YAAE,OAAO,+HAA+H,CAAC;QACpJ,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,oEAAoE,CAAC;QAEtG;;0BAEkB;QAClB,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAmB,EAAE,CACpD,CAAC,IAAI,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEvF,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACpD,IAAI,GAAG;YAAE,OAAO,6BAA6B,GAAG,CAAC,IAAI,gCAAgC,GAAG,CAAC,IAAI,IAAI,oBAAoB,KAAK,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAElJ;;iCAEyB;QACzB,MAAM,IAAI,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAoB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9E,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpF,OAAO,wBAAwB,IAAI,QAAQ,IAAI,gCAAgC,IAAI,2FAA2F,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IACpM,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corenel/harness",
-  "version": "0.7.5",
+  "version": "0.9.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.",
@@ -29,7 +29,7 @@
   "dependencies": {
     "openai": "^4.77.0",
     "yaml": "^2.8.3",
-    "@corenel/protocol": "0.7.3"
+    "@corenel/protocol": "0.8.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"