@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/capabilities/projects.js

@@ -0,0 +1,206 @@
+/**
+ * The `projects` capability module — list, search, edit and delete the
+ * caller's projects.
+ *
+ * Reads and edits go through `Project` in `@nodetool-ai/models`, the same
+ * model methods the tRPC `projects` router calls. Deletion is different: the
+ * full delete also removes stored asset bytes and workspace files and stops
+ * live runs, and those live in the server. The host injects that operation as
+ * `run.deleteProject`, and a run without it says so.
+ *
+ * Ownership is the rule the router applies: another user's project reads as
+ * missing rather than as forbidden.
+ */
+import { listProjectsSpec, searchProjectsSpec, updateProjectSpec, deleteProjectSpec, MAX_PROJECTS_PER_CALL } from "./projects.specs.js";
+import { isNonBlankString, isString } from "../utils/type-guards.js";
+/** Rows `search_projects` reads before it filters. */
+const SEARCH_SCAN_LIMIT = 500;
+function userOf(run) {
+    const userId = run.context.userId;
+    if (!userId)
+        return { error: "No user is bound to this session." };
+    return userId;
+}
+const isError = (value) => !!value &&
+    typeof value === "object" &&
+    typeof value.error === "string";
+function clamp(value, fallback, max) {
+    const n = Math.floor(Number(value));
+    if (!Number.isFinite(n) || n < 1)
+        return fallback;
+    return Math.min(n, max);
+}
+function projectIdOf(params) {
+    const id = params["project_id"];
+    if (!isNonBlankString(id)) {
+        return { error: "project_id is required (use list_projects to find one)." };
+    }
+    return id.trim();
+}
+const notFound = (id) => ({
+    error: `Project ${id} was not found.`
+});
+function summarizeProject(project) {
+    const response = project.toResponse();
+    return {
+        id: response.id,
+        name: response.name,
+        kind: response.kind,
+        is_personal: response.isPersonal,
+        archived_at: response.archivedAt ?? undefined,
+        created_at: response.createdAt,
+        updated_at: response.updatedAt
+    };
+}
+const listProjects = {
+    spec: listProjectsSpec,
+    impl: async (run, params) => {
+        const userId = userOf(run);
+        if (isError(userId))
+            return userId;
+        const { Project } = await import("@nodetool-ai/models");
+        // The router does the same before every read, so a user who never opened
+        // the projects UI still sees their Personal project.
+        await Project.migrateToPersonal(userId);
+        const limit = clamp(params["limit"], 50, MAX_PROJECTS_PER_CALL);
+        const rows = await Project.listByUser(userId, limit, params["archived"] === true);
+        return { projects: rows.map(summarizeProject) };
+    }
+};
+const searchProjects = {
+    spec: searchProjectsSpec,
+    impl: async (run, params) => {
+        const userId = userOf(run);
+        if (isError(userId))
+            return userId;
+        const query = params["query"];
+        const words = isString(query)
+            ? query.toLowerCase().split(/\s+/).filter((word) => word !== "")
+            : [];
+        if (words.length === 0) {
+            return { error: "query is required (use list_projects to see them all)." };
+        }
+        const { Project } = await import("@nodetool-ai/models");
+        await Project.migrateToPersonal(userId);
+        const limit = clamp(params["limit"], 20, MAX_PROJECTS_PER_CALL);
+        const active = await Project.listByUser(userId, SEARCH_SCAN_LIMIT, false);
+        const archived = params["include_archived"] === false
+            ? []
+            : await Project.listByUser(userId, SEARCH_SCAN_LIMIT, true);
+        const matches = [...active, ...archived].filter((project) => {
+            const haystack = `${project.name} ${project.kind}`.toLowerCase();
+            return words.every((word) => haystack.includes(word));
+        });
+        return { projects: matches.slice(0, limit).map(summarizeProject) };
+    }
+};
+const updateProject = {
+    spec: updateProjectSpec,
+    impl: async (run, params) => {
+        const userId = userOf(run);
+        if (isError(userId))
+            return userId;
+        const id = projectIdOf(params);
+        if (isError(id))
+            return id;
+        const fields = {};
+        const name = params["name"];
+        if (name !== undefined) {
+            if (!isString(name) || name.trim() === "" || name.length > 200) {
+                return { error: "name must be 1 to 200 characters." };
+            }
+            fields.name = name;
+        }
+        const kind = params["kind"];
+        if (kind !== undefined) {
+            if (!isString(kind) || kind.length > 64) {
+                return { error: "kind must be a string of at most 64 characters." };
+            }
+            fields.kind = kind;
+        }
+        const archived = params["archived"];
+        if (archived !== undefined && typeof archived !== "boolean") {
+            return { error: "archived must be true or false." };
+        }
+        if (Object.keys(fields).length === 0 && archived === undefined) {
+            return { error: "Pass at least one of name, kind or archived." };
+        }
+        const { Project, PERSONAL_PROJECT_KIND } = await import("@nodetool-ai/models");
+        const existing = await Project.findOwned(userId, id);
+        if (!existing)
+            return notFound(id);
+        if (fields.kind !== undefined &&
+            fields.kind !== existing.kind &&
+            (existing.kind === PERSONAL_PROJECT_KIND ||
+                fields.kind === PERSONAL_PROJECT_KIND)) {
+            return {
+                error: `The "${PERSONAL_PROJECT_KIND}" kind is reserved for the Personal project and cannot be set or changed.`
+            };
+        }
+        // The model reads the 12-char prefix CodeAct hands it; write by the full id.
+        let updated = existing;
+        if (Object.keys(fields).length > 0) {
+            updated = await Project.updateOwned(userId, existing.id, fields);
+        }
+        if (updated && archived === true) {
+            updated = await Project.archiveOwned(userId, existing.id);
+        }
+        else if (updated && archived === false) {
+            updated = await Project.restoreOwned(userId, existing.id);
+        }
+        if (!updated)
+            return notFound(id);
+        return { project: summarizeProject(updated) };
+    }
+};
+const deleteProject = {
+    spec: deleteProjectSpec,
+    impl: async (run, params) => {
+        const userId = userOf(run);
+        if (isError(userId))
+            return userId;
+        const named = projectIdOf(params);
+        if (isError(named))
+            return named;
+        // The model names projects by the 12-char prefix CodeAct hands it. Resolve
+        // the row once, so the guard and the host compare and delete the full id.
+        const { Project } = await import("@nodetool-ai/models");
+        const target = await Project.findOwnedIncludingDeleted(userId, named);
+        if (!target)
+            return notFound(named);
+        const id = target.id;
+        // Deleting the run's own project would abort the conversation that asked,
+        // before it can report what happened.
+        if (isNonBlankString(run.projectId) && run.projectId.trim() === id) {
+            return {
+                error: "This conversation belongs to that project, so it cannot delete it. Delete it from another conversation or from the projects page."
+            };
+        }
+        const deleter = run.deleteProject;
+        if (!deleter) {
+            return {
+                error: "Project deletion is not available in this host. Delete the project from the projects page."
+            };
+        }
+        const outcome = await deleter(userId, id);
+        if (outcome === "personal") {
+            return { error: "The Personal project cannot be deleted." };
+        }
+        if (outcome === "not_found")
+            return notFound(id);
+        return { project_id: id, deleted: true };
+    }
+};
+/** Every project capability, in declaration order. */
+export const PROJECT_CAPABILITIES = [
+    listProjects,
+    searchProjects,
+    updateProject,
+    deleteProject
+];
+export const module = {
+    module: "projects",
+    exports: PROJECT_CAPABILITIES
+};
+export { listProjects, searchProjects, updateProject, deleteProject };
+//# sourceMappingURL=projects.js.map

package/dist/capabilities/projects.js.map

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

package/dist/capabilities/projects.specs.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The `projects` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `projects.ts`. `projects.ts` imports
+ * these back and attaches each to its implementation, so there is one spec
+ * object behind both halves.
+ */
+import type { CapabilitySpec } from "./types.js";
+import type { JsonSchema } from "@nodetool-ai/runtime";
+/** Projects one `list_projects` or `search_projects` call may return. */
+export declare const MAX_PROJECTS_PER_CALL = 100;
+export declare const LIST_PROJECTS_SCHEMA: JsonSchema;
+export declare const SEARCH_PROJECTS_SCHEMA: JsonSchema;
+export declare const UPDATE_PROJECT_SCHEMA: JsonSchema;
+export declare const DELETE_PROJECT_SCHEMA: JsonSchema;
+export declare const listProjectsSpec: CapabilitySpec;
+export declare const searchProjectsSpec: CapabilitySpec;
+export declare const updateProjectSpec: CapabilitySpec;
+export declare const deleteProjectSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const projectsSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=projects.specs.d.ts.map

package/dist/capabilities/projects.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/projects.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,oBAAoB,EAAE,UAalC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,UAmBpC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,UAsBnC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,UAMnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,cAU9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAUhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAS/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAW/B,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAKlD,CAAC"}

package/dist/capabilities/projects.specs.js

@@ -0,0 +1,118 @@
+/**
+ * The `projects` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `projects.ts`. `projects.ts` imports
+ * these back and attaches each to its implementation, so there is one spec
+ * object behind both halves.
+ */
+/** Projects one `list_projects` or `search_projects` call may return. */
+export const MAX_PROJECTS_PER_CALL = 100;
+export const LIST_PROJECTS_SCHEMA = {
+    type: "object",
+    properties: {
+        limit: {
+            type: "number",
+            description: `Max projects to return (default 50, max ${MAX_PROJECTS_PER_CALL}).`
+        },
+        archived: {
+            type: "boolean",
+            description: "List archived projects instead of active ones (default false)."
+        }
+    }
+};
+export const SEARCH_PROJECTS_SCHEMA = {
+    type: "object",
+    properties: {
+        query: {
+            type: "string",
+            description: "Words to match against the project name and kind. Every word must " +
+                "appear, case-insensitive."
+        },
+        limit: {
+            type: "number",
+            description: `Max projects to return (default 20, max ${MAX_PROJECTS_PER_CALL}).`
+        },
+        include_archived: {
+            type: "boolean",
+            description: "Also match archived projects (default true)."
+        }
+    },
+    required: ["query"]
+};
+export const UPDATE_PROJECT_SCHEMA = {
+    type: "object",
+    properties: {
+        project_id: { type: "string", description: "Project id." },
+        name: {
+            type: "string",
+            description: "New name, 1 to 200 characters."
+        },
+        kind: {
+            type: "string",
+            description: 'New free-text kind, such as "spot", "trailer" or "report". Max 64 ' +
+                "characters. The Personal project's kind cannot change."
+        },
+        archived: {
+            type: "boolean",
+            description: "true archives the project, false restores it. Archiving hides it " +
+                "from the project selector and deletes nothing."
+        }
+    },
+    required: ["project_id"]
+};
+export const DELETE_PROJECT_SCHEMA = {
+    type: "object",
+    properties: {
+        project_id: { type: "string", description: "Project id." }
+    },
+    required: ["project_id"]
+};
+export const listProjectsSpec = {
+    name: "list_projects",
+    description: "List the caller's projects, most recently updated first: id, name, " +
+        "kind, whether it is the Personal project, archive time and timestamps. " +
+        "A project groups documents that carry its id. Pass archived=true to " +
+        "list archived projects.",
+    inputSchema: LIST_PROJECTS_SCHEMA,
+    category: "read",
+    userMessage: () => "Listing projects"
+};
+export const searchProjectsSpec = {
+    name: "search_projects",
+    description: "Find the caller's projects by name or kind. Every word of the query " +
+        "must appear, case-insensitive. Archived projects match unless " +
+        "include_archived=false. Use it when the user names a project but not " +
+        "its id.",
+    inputSchema: SEARCH_PROJECTS_SCHEMA,
+    category: "read",
+    userMessage: (params) => `Searching projects for "${String(params["query"])}"`
+};
+export const updateProjectSpec = {
+    name: "update_project",
+    description: "Edit a project you own: rename it, change its kind, or archive and " +
+        "restore it. Pass at least one of name, kind or archived. A project you " +
+        "do not own is reported as missing.",
+    inputSchema: UPDATE_PROJECT_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Updating project ${String(params["project_id"])}`
+};
+export const deleteProjectSpec = {
+    name: "delete_project",
+    description: "Permanently delete a project you own, with every document, " +
+        "conversation, asset, job and workspace file in it. This cannot be " +
+        "undone. Confirm with the user first, and prefer update_project with " +
+        "archived=true when they only want it out of sight. The Personal " +
+        "project and the project this conversation belongs to cannot be deleted.",
+    inputSchema: DELETE_PROJECT_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Deleting project ${String(params["project_id"])}`
+};
+/** Every spec this module declares, in declaration order. */
+export const projectsSpecs = [
+    listProjectsSpec,
+    searchProjectsSpec,
+    updateProjectSpec,
+    deleteProjectSpec
+];
+//# sourceMappingURL=projects.specs.js.map

package/dist/capabilities/projects.specs.js.map

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

package/dist/capabilities/registry.d.ts

@@ -0,0 +1,111 @@
+/**
+ * The capability module table — the platform's own surface, one lazy loader per
+ * namespace.
+ *
+ * Same shape as `host-modules/registry.ts`, and for the same reasons: nothing
+ * sits in an entry graph, each implementation imports its heavy dependencies
+ * inside itself, and esbuild still inlines the dynamic imports into the
+ * packaged `server.mjs`.
+ *
+ * The table is first-party only. Like `SANDBOX_HOST_MODULES` pins each host id
+ * to one pack, a third-party pack can never declare a capability module.
+ *
+ * What this table does *not* carry is the other half of the answer: which of
+ * NodeTool's own API surfaces sandboxed code is deliberately kept away from,
+ * and why. That lives in `packages/websocket/src/trpc/sandbox-coverage.ts`,
+ * next to the router it classifies, and is checked against it by
+ * `tests/sandbox-api-coverage.test.ts` — so adding a capability here and
+ * leaving a surface unclassified there fails the build.
+ */
+import { type CapabilityExport, type CapabilityImpl, type CapabilityModule, type CapabilitySpec, type PermissionCategory } from "./types.js";
+/**
+ * The namespaces this build declares, in the order {@link CAPABILITY_MODULES}
+ * lists them — the module list a reviewer reads.
+ */
+export declare const DECLARED_CAPABILITY_MODULES: readonly string[];
+/**
+ * The module that owns one capability, by wire name — the namespace a guest
+ * imports it from. `undefined` for a name no module declares (a session tool,
+ * an external MCP tool), which is how a caller tells the two apart.
+ */
+export declare function capabilityModuleOf(name: string): string | undefined;
+/** Every registered capability's spec, read without loading a module. */
+export declare function listCapabilitySpecs(): readonly CapabilitySpec[];
+/** One module's specs, read without loading it. */
+export declare function capabilityModuleSpecTable(moduleName: string): readonly CapabilitySpec[];
+/**
+ * One capability's spec by wire name, synchronously. A miss means no module
+ * declares that name — the belt builders treat it as a programming error.
+ */
+export declare function capabilitySpec(name: string): CapabilitySpec | undefined;
+/**
+ * Load one capability module, at most once per process.
+ *
+ * A miss is a programming error, not a guest-reachable path: the dispatcher
+ * only asks for modules the mount resolved, and a mount only resolves modules
+ * this table lists.
+ */
+export declare function loadCapabilityModule(moduleName: string): Promise<CapabilityModule>;
+/**
+ * One capability's implementation, loading only the module that owns it.
+ *
+ * The eager spec table says which module that is, so a belt built from specs
+ * pays for one `import()` at first invoke instead of the whole table the way
+ * {@link findCapability} does.
+ */
+export declare function loadCapabilityImpl(name: string): Promise<CapabilityImpl>;
+/** Module names this process can serve. */
+export declare function listCapabilityModules(): readonly string[];
+/** Load every registered module. Used by the drift walk and by name lookup. */
+export declare function loadAllCapabilityModules(): Promise<readonly CapabilityModule[]>;
+/**
+ * Find one capability by its wire name across every registered module.
+ *
+ * This loads the whole table, which is the honest cost of a flat name space
+ * over lazily-loaded modules. Once the pack lands, a mount resolves a namespace
+ * first and calls {@link loadCapabilityModule} directly, so laziness holds on
+ * the path that matters.
+ */
+export declare function findCapability(name: string): Promise<CapabilityExport | undefined>;
+/**
+ * The permission category for a tool name: the registered spec's, else the
+ * hand-written map for a `Tool` class that is not a capability (`run_node`,
+ * the plan-builder tools, `finish_step`), else the conservative `external`.
+ *
+ * This is the one lookup a host or a test should use. `permissionCategoryFor`
+ * alone answers only the map, and the map holds only what has no spec.
+ */
+export declare function capabilityCategoryFor(name: string): PermissionCategory;
+/** Every registered capability's name → category. The snapshot a test pins. */
+export declare function capabilityCategorySnapshot(): Promise<Record<string, PermissionCategory>>;
+/**
+ * Everything wrong with one module: a key that disagrees with the module's own
+ * name, an export missing an identity, and — the one this exists for — a spec
+ * that carries no category. Exported so the drift test can prove the walk bites
+ * on a broken module instead of only on an empty table.
+ */
+export declare function capabilityModuleIssues(moduleName: string, mod: CapabilityModule): readonly string[];
+/**
+ * What the eager spec table says about one module against what the module
+ * itself exports. The two halves are meant to be one object per capability, so
+ * anything but identity is drift: a name only one half has, or a spec the
+ * module rebuilt instead of importing from its `.specs.ts` sibling.
+ *
+ * Identity, not deep equality, on purpose. A module that copies its spec would
+ * pass a field-by-field check and still be two things to keep in step.
+ */
+export declare function eagerSpecDrift(moduleName: string, mod: CapabilityModule): readonly string[];
+/**
+ * Any module whose exports fail {@link capabilityModuleIssues} — including a
+ * spec with no category, which is the failure this whole mechanism exists to
+ * catch — or {@link eagerSpecDrift}. Also flags one name exported by two
+ * modules. Always empty in a healthy build; the drift test asserts it.
+ *
+ * A declared module with no loader or a loader nobody declared cannot occur:
+ * both come from the same {@link CAPABILITY_MODULES} entry now, so there is
+ * nothing left to compare two lists for.
+ */
+export declare function capabilityModuleDrift(): Promise<readonly string[]>;
+/** Resolve eager metadata while keeping implementation loading lazy. */
+export declare function capabilityForName(name: string): CapabilityExport;
+//# sourceMappingURL=registry.d.ts.map

package/dist/capabilities/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/capabilities/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AAmPpB;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EACxB,CAAC;AAclC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,IAAI,SAAS,cAAc,EAAE,CAE/D;AAED,mDAAmD;AACnD,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,GACjB,SAAS,cAAc,EAAE,CAI3B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvE;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAczB;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED,+EAA+E;AAC/E,wBAAsB,wBAAwB,IAAI,OAAO,CACvD,SAAS,gBAAgB,EAAE,CAC5B,CAEA;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAMvC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAEtE;AAED,+EAA+E;AAC/E,wBAAsB,0BAA0B,IAAI,OAAO,CACzD,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CACnC,CAUA;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,GACpB,SAAS,MAAM,EAAE,CAiCnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,GACpB,SAAS,MAAM,EAAE,CA0BnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAmBxE;AAID,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAehE"}