studiograph 1.3.48-next.21 → 1.3.48-next.210

package/dist/agent/tools/folder-tools.js

@@ -0,0 +1,249 @@
+/**
+ * Folder Management Tools for the Studiograph Agent
+ *
+ * Five tools that let the agent operate on the folder layout within a repo:
+ *   - list_folders     — read the folder tree of a repo
+ *   - create_subfolder — create a new subfolder inside an existing repo
+ *                        (distinct from graph-tools' `create_folder`, which
+ *                        creates a brand-new top-level repo)
+ *   - rename_folder    — rename / move within the same repo
+ *   - move_entity      — relocate an entry to a different folder within the
+ *                        same repo (distinct from graph-tools'
+ *                        `transfer_entity`, which moves across repos)
+ *   - delete_folder    — remove a folder (recursive opt-in, blast-radius reported)
+ *
+ * The system prompt restraint rule applies to all of these:
+ * never reorganize/rename/delete without explicit user request.
+ */
+import { Type as T } from 'typebox';
+import * as access from '../../services/access-control.js';
+import { wrapToolResult } from './graph-tools.js';
+function canAccessRepo(repoName, workspaceManager, getCurrentUser, authService) {
+    const user = getCurrentUser();
+    if (!user)
+        return true;
+    if (!authService)
+        return true;
+    return access.hasRepoAccess(user, repoName, workspaceManager, authService);
+}
+export function createFolderTools(workspaceManager, gitUser, onMutation, getCurrentUser, authService, 
+/**
+ * Same activity hook as createGraphTools. Currently accepted but not wrapped
+ * around individual folder ops — folder mutations are rare relative to entity
+ * mutations, and the chip wouldn't have time to render before completing.
+ * Param exists so the orchestrator can pass a single callback symmetrically.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_onAgentActivity) {
+    const getUser = getCurrentUser ?? (() => null);
+    const authSvc = authService ?? null;
+    function effectiveGitUser() {
+        const user = getUser();
+        if (user?.handle) {
+            return {
+                id: user.handle,
+                name: user.displayName ?? user.handle,
+                email: `${user.handle}@studiograph.local`,
+            };
+        }
+        return gitUser;
+    }
+    function resolveRepoOrFail(repoName) {
+        if (!canAccessRepo(repoName, workspaceManager, getUser, authSvc)) {
+            return { error: `Folder "${repoName}" not found` };
+        }
+        try {
+            return { graph: workspaceManager.getGraph(repoName) };
+        }
+        catch (err) {
+            return { error: err?.message ?? `Could not open folder "${repoName}"` };
+        }
+    }
+    return [
+        // ── list_folders ────────────────────────────────────────────────
+        {
+            name: 'list_folders',
+            label: 'List Folders',
+            description: 'List every nested folder inside a repo, returning repo-relative POSIX paths and any explicit display_name override. Empty array means the repo has no subfolders. Use this BEFORE creating a new folder to avoid duplicating an existing one.',
+            parameters: T.Object({
+                repo: T.String({ description: 'Folder name to inspect' }),
+            }),
+            execute: async (_toolCallId, params) => {
+                try {
+                    const resolved = resolveRepoOrFail(params.repo);
+                    if ('error' in resolved)
+                        return wrapToolResult({ success: false, error: resolved.error });
+                    const folders = resolved.graph.listFolders().map((f) => {
+                        const entry = { path: f.path };
+                        if (f.display_name)
+                            entry.display_name = f.display_name;
+                        return entry;
+                    });
+                    return wrapToolResult({
+                        success: true,
+                        repo: params.repo,
+                        folders,
+                        message: folders.length === 0
+                            ? `Folder "${params.repo}" has no subfolders.`
+                            : `Found ${folders.length} subfolder${folders.length === 1 ? '' : 's'} in "${params.repo}".`,
+                    });
+                }
+                catch (err) {
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : 'Unknown error' });
+                }
+            },
+        },
+        // ── create_subfolder ─────────────────────────────────────────────
+        // Distinct from graph-tools' `create_folder`, which creates a new
+        // top-level shared repo. This one nests inside an existing repo.
+        {
+            name: 'create_subfolder',
+            label: 'Create Subfolder',
+            description: 'Create a new subfolder inside an existing repo. Path is repo-relative POSIX (e.g. "clients/acme"). Parent segments are auto-created. Pass display_name to override the title-cased fallback (use when the user wants casing the folder name can\'t express, e.g. "HR" or "Schema_OS"). For creating a brand-new top-level shared folder, use create_folder instead. Confirm with the user before calling — folders shape how the user organises their work.',
+            parameters: T.Object({
+                repo: T.String({ description: 'Folder name to create the subfolder inside' }),
+                path: T.String({ description: 'Repo-relative POSIX path of the new subfolder (e.g. "clients/acme")' }),
+                display_name: T.Optional(T.String({ description: 'Optional human-readable label. Omit when the title-cased folder name is the right display.' })),
+            }),
+            execute: async (_toolCallId, params) => {
+                try {
+                    const resolved = resolveRepoOrFail(params.repo);
+                    if ('error' in resolved)
+                        return wrapToolResult({ success: false, error: resolved.error });
+                    const actor = effectiveGitUser();
+                    await resolved.graph.createFolder(params.path, undefined, actor, {
+                        displayName: params.display_name,
+                    });
+                    // entityType "_folder" is the existing sentinel (see graph-tools'
+                    // create_folder) that tells the client this is a folder-tree
+                    // mutation, not an entry mutation — the realtime handler maps it
+                    // to refreshRepoAfterFolderMutation so the sidebar + folder list
+                    // view pick up the new subfolder without a manual reload.
+                    onMutation?.({ action: 'created', repo: params.repo, entityType: '_folder', entityId: params.path });
+                    return wrapToolResult({
+                        success: true,
+                        repo: params.repo,
+                        path: params.path,
+                        message: `Created folder ${params.repo}/${params.path}. Auto-committed.`,
+                    });
+                }
+                catch (err) {
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : 'Unknown error' });
+                }
+            },
+        },
+        // ── rename_folder ────────────────────────────────────────────────
+        {
+            name: 'rename_folder',
+            label: 'Rename Folder',
+            description: 'Rename or move a subfolder within the same repo, optionally updating its display_name in the same commit. To update only the display_name without moving, set `to` equal to `from`. ALL descendant entries follow when the path changes — their on-disk paths change. NEVER call this without explicit user instruction. Surface what will move ("Rename clients/acme → clients/acme-corp and update path of N entries?") and wait for confirmation.',
+            parameters: T.Object({
+                repo: T.String({ description: 'Folder name containing the subfolder' }),
+                from: T.String({ description: 'Current repo-relative path of the subfolder' }),
+                to: T.String({ description: 'New repo-relative path of the subfolder. Pass the same value as `from` to update display_name only.' }),
+                display_name: T.Optional(T.String({ description: 'New human-readable label. Pass empty string to clear the override and revert to the title-cased folder name.' })),
+            }),
+            execute: async (_toolCallId, params) => {
+                try {
+                    const resolved = resolveRepoOrFail(params.repo);
+                    if ('error' in resolved)
+                        return wrapToolResult({ success: false, error: resolved.error });
+                    const actor = effectiveGitUser();
+                    await resolved.graph.renameFolder(params.from, params.to, undefined, actor, {
+                        displayName: params.display_name === undefined ? undefined : params.display_name,
+                    });
+                    onMutation?.({ action: 'updated', repo: params.repo, entityType: '_folder', entityId: params.to });
+                    return wrapToolResult({
+                        success: true,
+                        repo: params.repo,
+                        from: params.from,
+                        to: params.to,
+                        message: `Renamed ${params.repo}/${params.from} → ${params.repo}/${params.to}. Auto-committed.`,
+                    });
+                }
+                catch (err) {
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : 'Unknown error' });
+                }
+            },
+        },
+        // ── move_entity ──────────────────────────────────────────────────
+        {
+            name: 'move_entity',
+            label: 'Move Entry',
+            description: 'Move an entry to a different folder within the SAME repo. Only the entry\'s folder_path changes — its id and type are preserved. For cross-repo moves the user should use the bulk-move dialog (no agent tool yet).',
+            parameters: T.Object({
+                repo: T.String({ description: 'Folder name containing the entry' }),
+                entityType: T.String({ description: 'Entity type of the entry being moved' }),
+                entityId: T.String({ description: 'ID of the entry being moved' }),
+                folder_path: T.String({ description: 'Target repo-relative folder path. Empty string = repo root.' }),
+            }),
+            execute: async (_toolCallId, params) => {
+                try {
+                    const resolved = resolveRepoOrFail(params.repo);
+                    if ('error' in resolved)
+                        return wrapToolResult({ success: false, error: resolved.error });
+                    const actor = effectiveGitUser();
+                    const moved = await resolved.graph.move(params.entityType, params.entityId, params.folder_path, undefined, actor);
+                    onMutation?.({ action: 'updated', repo: params.repo, entityType: params.entityType, entityId: params.entityId });
+                    return wrapToolResult({
+                        success: true,
+                        repo: params.repo,
+                        entityType: params.entityType,
+                        entityId: params.entityId,
+                        folder_path: params.folder_path,
+                        path: moved.path,
+                        message: `Moved ${params.entityType}/${params.entityId} to ${params.repo}/${params.folder_path || '(root)'}. Auto-committed.`,
+                    });
+                }
+                catch (err) {
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : 'Unknown error' });
+                }
+            },
+        },
+        // ── delete_folder ────────────────────────────────────────────────
+        {
+            name: 'delete_folder',
+            label: 'Delete Folder',
+            description: 'Delete a subfolder. Defaults to non-recursive — if the folder has entries or subfolders the call FAILS with a blast_radius payload (entriesDeleted, subfoldersDeleted) so you can present the impact to the user. Re-invoke with recursive: true ONLY after explicit user confirmation. NEVER pass recursive: true on the first attempt.',
+            parameters: T.Object({
+                repo: T.String({ description: 'Folder name containing the subfolder to delete' }),
+                path: T.String({ description: 'Repo-relative path of the subfolder to delete' }),
+                recursive: T.Optional(T.Boolean({ description: 'Set to true ONLY after the user has confirmed the blast radius. Defaults to false.' })),
+            }),
+            execute: async (_toolCallId, params) => {
+                try {
+                    const resolved = resolveRepoOrFail(params.repo);
+                    if ('error' in resolved)
+                        return wrapToolResult({ success: false, error: resolved.error });
+                    const actor = effectiveGitUser();
+                    const result = await resolved.graph.deleteFolder(params.path, {
+                        recursive: params.recursive === true,
+                        user: actor,
+                    });
+                    onMutation?.({ action: 'deleted', repo: params.repo, entityType: '_folder', entityId: params.path });
+                    return wrapToolResult({
+                        success: true,
+                        repo: params.repo,
+                        path: params.path,
+                        entriesDeleted: result.entriesDeleted,
+                        subfoldersDeleted: result.subfoldersDeleted,
+                        message: `Deleted folder ${params.repo}/${params.path}${result.entriesDeleted > 0 || result.subfoldersDeleted > 0 ? ` (${result.entriesDeleted} entries, ${result.subfoldersDeleted} subfolders)` : ''}. Auto-committed.`,
+                    });
+                }
+                catch (err) {
+                    // Surface the blast radius so the agent can ask the user before retrying recursively.
+                    if (err?.code === 'FOLDER_NOT_EMPTY' && err.blastRadius) {
+                        return wrapToolResult({
+                            success: false,
+                            code: 'FOLDER_NOT_EMPTY',
+                            blast_radius: err.blastRadius,
+                            message: `Folder ${params.repo}/${params.path} is not empty: ${err.blastRadius.entriesDeleted} entries, ${err.blastRadius.subfoldersDeleted} subfolders. Confirm with the user before re-invoking with recursive: true.`,
+                        });
+                    }
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : 'Unknown error' });
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=folder-tools.js.map

package/dist/agent/tools/folder-tools.js.map

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

package/dist/agent/tools/fs-tools.d.ts

@@ -4,12 +4,13 @@
  * Gives the agent read/write access to local files outside the workspace
  * (e.g. Obsidian vaults, project docs, config files).
  */
+import { Type as T } from 'typebox';
 import { type AuthUser } from '../../services/auth-service.js';
 export declare function createFsTools(getCurrentUser?: () => AuthUser | null): ({
     name: string;
     description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        path: import("@sinclair/typebox").TString;
+    parameters: T.TObject<{
+        path: T.TString;
     }>;
     execute: (_toolCallId: string, params: {
         path: string;
@@ -23,9 +24,9 @@ export declare function createFsTools(getCurrentUser?: () => AuthUser | null): (
 } | {
     name: string;
     description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        path: import("@sinclair/typebox").TString;
-        content: import("@sinclair/typebox").TString;
+    parameters: T.TObject<{
+        path: T.TString;
+        content: T.TString;
     }>;
     execute: (_toolCallId: string, params: {
         path: string;

package/dist/agent/tools/fs-tools.js

@@ -6,9 +6,9 @@
  */
 import { readFileSync, writeFileSync, mkdirSync, readdirSync, statSync, existsSync } from 'fs';
 import { join, resolve, dirname } from 'path';
-import { Type as T } from '@sinclair/typebox';
+import { Type as T } from 'typebox';
 import { wrapToolResult } from './graph-tools.js';
-import { isAdminOrOwner } from '../../services/auth-service.js';
+import { isWorkspaceOwner } from '../../services/auth-service.js';
 export function createFsTools(getCurrentUser) {
     const getUser = getCurrentUser ?? (() => null);
     return [
@@ -74,7 +74,7 @@ export function createFsTools(getCurrentUser) {
         },
         {
             name: 'write_file',
-            description: 'Write content to a file on the local filesystem (admin only). Creates parent directories if needed. ' +
+            description: 'Write content to a file on the local filesystem (workspace owner only). Creates parent directories if needed. ' +
                 'Overwrites the file if it already exists. Use for creating or updating docs, configs, or any file outside the workspace.',
             parameters: T.Object({
                 path: T.String({ description: 'Absolute path or ~/relative path to the file' }),
@@ -83,8 +83,8 @@ export function createFsTools(getCurrentUser) {
             execute: async (_toolCallId, params) => {
                 try {
                     const user = getUser();
-                    if (user && !isAdminOrOwner(user.role)) {
-                        return wrapToolResult({ success: false, error: 'This operation requires admin access.' });
+                    if (user && !isWorkspaceOwner(user.role)) {
+                        return wrapToolResult({ success: false, error: 'This operation requires workspace owner access.' });
                     }
                     const resolved = resolvePath(params.path);
                     mkdirSync(dirname(resolved), { recursive: true });

package/dist/agent/tools/fs-tools.js.map

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

package/dist/agent/tools/graph-tools.d.ts

@@ -7,9 +7,12 @@
  * - Manage wikilinks
  * - Upload assets
  */
+import { Type as T } from 'typebox';
 import { WorkspaceManager } from '../../core/workspace-manager.js';
 import { type AuthUser } from '../../services/auth-service.js';
 import type { AuthService } from '../../services/auth-service.js';
+import type { CommentService } from '../../services/comment-service.js';
+import type { ChatSessionService } from '../../services/chat-session-service.js';
 /**
  * Helper to wrap tool results in AgentToolResult format
  */
@@ -28,16 +31,49 @@ export interface MutationEvent {
     repo: string;
     entityType: string;
     entityId: string;
+    /**
+     * The mutation changed free-standing ASSETS in `repo` (not just an entry) —
+     * e.g. promoting a chat image into the library. The transport should emit a
+     * `repo_sync` so asset-only views (the asset manager) refresh; the default
+     * `entity_change` broadcast doesn't cover assets (they aren't entities).
+     */
+    repoSync?: boolean;
 }
 export declare function createGraphTools(workspaceManager: WorkspaceManager, gitUser: {
     id: string;
     name: string;
     email: string;
-}, workspacePath?: string, onHighlight?: (ids: string[]) => void, onMutation?: (m: MutationEvent) => void, getCurrentUser?: () => AuthUser | null, authService?: AuthService | null): ({
+}, workspacePath?: string, onHighlight?: (ids: string[]) => void, onMutation?: (m: MutationEvent) => void, getCurrentUser?: () => AuthUser | null, authService?: AuthService | null, 
+/**
+ * Called at the start (`enter`) and end (`leave`) of any mutation tool
+ * call. Surfaces the active-agent chip in the sidebar via the WS hub. The
+ * orchestrator wires this through to wsHub.handleAgentActivity.
+ */
+onAgentActivity?: (action: 'enter' | 'leave' | 'heartbeat', repo: string) => void, 
+/**
+ * Optional CommentService. When supplied, the generic read tools
+ * (`get_entity`, `list_entities`, `get_related`) dispatch the virtual
+ * `comment` entity type through the shared adapter — exactly as the MCP
+ * surface does. A graceful no-op when absent (stdio / tests), so comments
+ * simply don't appear rather than erroring.
+ */
+commentService?: CommentService | null, 
+/**
+ * Optional ChatSessionService. When supplied (web chat), enables
+ * `save_file_to_assets` to promote a conversation-scratch image into the
+ * curated asset library. A graceful no-op when absent (stdio / tests).
+ */
+chatSessionService?: ChatSessionService | null, 
+/**
+ * Resolves the active turn's RAW client session id. Lets `save_file_to_assets`
+ * scope "this image" to the current conversation's scratch images rather than
+ * the user's other chats. Returns null outside a web chat turn.
+ */
+getActiveSessionId?: () => string | null | undefined): ({
     name: string;
     label: string;
     description: string;
-    parameters: import("@sinclair/typebox").TObject<{}>;
+    parameters: T.TObject<{}>;
     execute: (toolCallId: string, params: any) => Promise<{
         content: {
             type: "text";
@@ -49,15 +85,13 @@ export declare function createGraphTools(workspaceManager: WorkspaceManager, git
     name: string;
     label: string;
     description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        name: import("@sinclair/typebox").TString;
-        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        private: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    parameters: T.TObject<{
+        name: T.TString;
+        description: T.TOptional<T.TString>;
     }>;
     execute: (toolCallId: string, params: {
         name: string;
         description?: string;
-        private?: boolean;
     }) => Promise<{
         content: {
             type: "text";
@@ -69,9 +103,9 @@ export declare function createGraphTools(workspaceManager: WorkspaceManager, git
     name: string;
     label: string;
     description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        repo: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        entityType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    parameters: T.TObject<{
+        repo: T.TOptional<T.TString>;
+        entityType: T.TOptional<T.TString>;
     }>;
     execute: (toolCallId: string, params: {
         repo?: string;
@@ -87,8 +121,8 @@ export declare function createGraphTools(workspaceManager: WorkspaceManager, git
     name: string;
     label: string;
     description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        entityIds: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    parameters: T.TObject<{
+        entityIds: T.TArray<T.TString>;
     }>;
     execute: (_toolCallId: string, params: {
         entityIds: string[];
@@ -103,66 +137,8 @@ export declare function createGraphTools(workspaceManager: WorkspaceManager, git
     name: string;
     label: string;
     description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        name: import("@sinclair/typebox").TString;
-        selectedType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        groupBy: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    }>;
-    execute: (_toolCallId: string, params: {
-        name: string;
-        selectedType?: string;
-        groupBy?: string;
-    }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        details: any;
-    }>;
-} | {
-    name: string;
-    label: string;
-    description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        id: import("@sinclair/typebox").TNumber;
-        name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        selectedType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        groupBy: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    }>;
-    execute: (_toolCallId: string, params: {
-        id: number;
-        name?: string;
-        selectedType?: string;
-        groupBy?: string;
-    }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        details: any;
-    }>;
-} | {
-    name: string;
-    label: string;
-    description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        id: import("@sinclair/typebox").TNumber;
-    }>;
-    execute: (_toolCallId: string, params: {
-        id: number;
-    }) => Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        details: any;
-    }>;
-} | {
-    name: string;
-    label: string;
-    description: string;
-    parameters: import("@sinclair/typebox").TObject<{
-        content: import("@sinclair/typebox").TString;
+    parameters: T.TObject<{
+        content: T.TString;
     }>;
     execute: (_toolCallId: string, params: {
         content: string;