@bodhi-ventures/aiocs 0.1.2 → 0.3.0

package/dist/mcp-server.js

@@ -2,31 +2,51 @@
 import {
   AIOCS_ERROR_CODES,
   AiocsError,
+  answerWorkspace,
   backfillEmbeddings,
+  bindWorkspaceSources,
   clearEmbeddings,
+  compileWorkspaceArtifacts,
+  createWorkspace,
   diffSnapshotsForSource,
   exportCatalogBackup,
   fetchSources,
+  generateWorkspaceArtifactOutput,
   getDoctorReport,
   getEmbeddingStatus,
+  getWorkspaceStatus,
   importCatalogBackup,
+  ingestWorkspaceRawInput,
   initManagedSources,
   linkProjectSources,
+  lintWorkspaceArtifacts,
   listSnapshotsForSource,
   listSources,
+  listWorkspaceArtifacts,
+  listWorkspaceRawInputsRecord,
+  listWorkspaceRecords,
   packageDescription,
   packageName,
   packageVersion,
   refreshDueSources,
+  removeWorkspaceRawInput,
   runEmbeddingWorker,
+  runQueuedWorkspaceCompiles,
   runSourceCanaries,
   searchCatalog,
+  searchWorkspaceCatalog,
+  searchWorkspaceRawInputCatalog,
   showChunk,
+  showWorkspaceArtifact,
+  showWorkspaceRawInput,
+  syncWorkspaceToObsidianVault,
   toAiocsError,
+  unbindWorkspaceSources,
   unlinkProjectSources,
+  updateWorkspaceSettings,
   upsertSourceFromSpecFile,
   verifyCoverage
-} from "./chunk-CZ6C4YUX.js";
+} from "./chunk-GX6CZOO7.js";
 
 // src/mcp-server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -50,6 +70,7 @@ var doctorReportSchema = z.object({
 });
 var sourceSchema = z.object({
   id: z.string(),
+  kind: z.enum(["web", "git"]),
   label: z.string(),
   specPath: z.string().nullable(),
   nextDueAt: z.string(),
@@ -77,6 +98,9 @@ var searchResultSchema = z.object({
   pageTitle: z.string(),
   sectionTitle: z.string(),
   markdown: z.string(),
+  pageKind: z.enum(["document", "file"]),
+  filePath: z.string().nullable(),
+  language: z.string().nullable(),
   score: z.number().optional(),
   signals: z.array(z.enum(["lexical", "vector"])).optional()
 });
@@ -123,7 +147,8 @@ var canaryResultSchema = z.object({
     failCount: z.number().int().nonnegative()
   }),
   checks: z.array(z.object({
-    url: z.string(),
+    url: z.string().optional(),
+    path: z.string().optional(),
     status: z.enum(["pass", "fail"]),
     title: z.string().optional(),
     markdownLength: z.number().int().nonnegative().optional(),
@@ -142,16 +167,25 @@ var snapshotDiffSchema = z.object({
   }),
   addedPages: z.array(z.object({
     url: z.string(),
-    title: z.string()
+    title: z.string(),
+    pageKind: z.enum(["document", "file"]),
+    filePath: z.string().nullable(),
+    language: z.string().nullable()
   })),
   removedPages: z.array(z.object({
     url: z.string(),
-    title: z.string()
+    title: z.string(),
+    pageKind: z.enum(["document", "file"]),
+    filePath: z.string().nullable(),
+    language: z.string().nullable()
   })),
   changedPages: z.array(z.object({
     url: z.string(),
     beforeTitle: z.string(),
     afterTitle: z.string(),
+    pageKind: z.enum(["document", "file"]),
+    filePath: z.string().nullable(),
+    language: z.string().nullable(),
     lineSummary: z.object({
       addedLineCount: z.number().int().nonnegative(),
       removedLineCount: z.number().int().nonnegative()
@@ -185,6 +219,204 @@ var embeddingStatusSchema = z.object({
     coverageRatio: z.number()
   }))
 });
+var workspaceSchema = z.object({
+  id: z.string(),
+  label: z.string(),
+  purpose: z.string().nullable(),
+  autoCompileEnabled: z.boolean(),
+  compilerProfile: z.object({
+    provider: z.literal("lmstudio"),
+    model: z.string(),
+    temperature: z.number(),
+    topP: z.number(),
+    maxInputChars: z.number().int().positive(),
+    maxOutputTokens: z.number().int().positive(),
+    concurrency: z.number().int().positive()
+  }),
+  defaultOutputFormats: z.array(z.enum(["report", "slides", "summary"])),
+  bindingCount: z.number().int().nonnegative(),
+  artifactCount: z.number().int().nonnegative(),
+  lastCompileRunId: z.string().nullable(),
+  lastCompileStatus: z.enum(["success", "failed"]).nullable(),
+  lastCompiledAt: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
+var workspaceCompileJobSchema = z.object({
+  workspaceId: z.string(),
+  status: z.enum(["pending", "running", "succeeded", "failed"]),
+  requestedSourceIds: z.array(z.string()),
+  requestedRawInputIds: z.array(z.string()),
+  requestedFingerprint: z.string().nullable(),
+  attemptCount: z.number().int().nonnegative(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+  claimedAt: z.string().nullable(),
+  completedAt: z.string().nullable(),
+  errorMessage: z.string().nullable()
+});
+var workspaceRawInputSchema = z.object({
+  id: z.string(),
+  workspaceId: z.string(),
+  kind: z.enum(["markdown-dir", "pdf", "image", "csv", "json", "jsonl"]),
+  label: z.string(),
+  sourcePath: z.string(),
+  storagePath: z.string(),
+  extractedTextPath: z.string().nullable(),
+  contentHash: z.string(),
+  metadata: z.record(z.string(), z.unknown()),
+  chunkCount: z.number().int().nonnegative(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
+var workspaceSyncTargetSchema = z.object({
+  workspaceId: z.string(),
+  kind: z.enum(["obsidian"]),
+  targetPath: z.string(),
+  exportSubdir: z.string(),
+  lastSyncedAt: z.string().nullable(),
+  lastSyncStatus: z.enum(["success", "failed"]).nullable(),
+  lastErrorMessage: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
+var workspaceQuestionRunSchema = z.object({
+  id: z.string(),
+  workspaceId: z.string(),
+  question: z.string(),
+  format: z.enum(["report", "slides", "summary", "note"]),
+  artifactPath: z.string(),
+  status: z.enum(["success", "failed"]),
+  errorMessage: z.string().nullable(),
+  createdAt: z.string(),
+  completedAt: z.string()
+});
+var workspaceArtifactRawInputProvenanceSchema = z.object({
+  workspaceId: z.string(),
+  path: z.string(),
+  rawInputId: z.string(),
+  chunkIds: z.array(z.number().int().nonnegative())
+});
+var workspaceArtifactLinkSchema = z.object({
+  workspaceId: z.string(),
+  fromPath: z.string(),
+  toPath: z.string(),
+  relationKind: z.enum(["explicit_link", "derived_from", "mentions", "related_to", "expands", "index_entry", "summary_of", "concept_of", "output_depends_on"]),
+  anchorText: z.string().nullable(),
+  source: z.enum(["compiler", "deterministic"]),
+  broken: z.boolean(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
+var workspaceHealthSchema = z.object({
+  status: z.enum(["healthy", "degraded"]),
+  staleArtifactCount: z.number().int().nonnegative(),
+  pendingCompileJobs: z.number().int().nonnegative(),
+  failedCompileJobs: z.number().int().nonnegative(),
+  brokenLinkCount: z.number().int().nonnegative(),
+  orphanArtifactCount: z.number().int().nonnegative(),
+  rawInputCount: z.number().int().nonnegative(),
+  lintFindingCount: z.number().int().nonnegative(),
+  duplicateConceptCandidateCount: z.number().int().nonnegative(),
+  missingArticleCandidateCount: z.number().int().nonnegative(),
+  followUpQuestionCount: z.number().int().nonnegative()
+});
+var workspaceBindingSchema = z.object({
+  workspaceId: z.string(),
+  sourceId: z.string(),
+  createdAt: z.string()
+});
+var workspaceArtifactSchema = z.object({
+  workspaceId: z.string(),
+  path: z.string(),
+  kind: z.enum(["concept", "summary", "report", "slides", "image", "index", "note"]),
+  contentHash: z.string(),
+  compilerMetadata: z.record(z.string(), z.unknown()),
+  stale: z.boolean(),
+  chunkCount: z.number().int().nonnegative(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
+var workspaceArtifactProvenanceSchema = z.object({
+  workspaceId: z.string(),
+  path: z.string(),
+  sourceId: z.string(),
+  snapshotId: z.string(),
+  chunkIds: z.array(z.number().int().nonnegative())
+});
+var workspaceLintSchema = z.object({
+  workspaceId: z.string(),
+  summary: z.object({
+    status: z.enum(["pass", "warn"]),
+    findingCount: z.number().int().nonnegative(),
+    staleArtifactCount: z.number().int().nonnegative(),
+    missingProvenanceCount: z.number().int().nonnegative(),
+    missingArtifactCount: z.number().int().nonnegative(),
+    brokenLinkCount: z.number().int().nonnegative(),
+    orphanArtifactCount: z.number().int().nonnegative(),
+    suggestedConceptCount: z.number().int().nonnegative(),
+    duplicateConceptCandidateCount: z.number().int().nonnegative(),
+    missingArticleCandidateCount: z.number().int().nonnegative(),
+    followUpQuestionCount: z.number().int().nonnegative()
+  }),
+  findings: z.array(z.object({
+    kind: z.enum([
+      "stale-artifact",
+      "missing-provenance",
+      "missing-artifact",
+      "broken-artifact-link",
+      "orphan-artifact",
+      "suggested-concept",
+      "duplicate-concept-candidate",
+      "missing-article-candidate",
+      "follow-up-question-suggestion"
+    ]),
+    severity: z.literal("warn"),
+    summary: z.string(),
+    artifactPath: z.string().optional(),
+    sourceId: z.string().optional(),
+    rawInputId: z.string().optional(),
+    relatedArtifactPaths: z.array(z.string()).optional()
+  })),
+  suggestionsArtifactPath: z.string().nullable()
+});
+var workspaceRawInputSearchResultSchema = z.object({
+  rawInputId: z.string(),
+  kind: z.enum(["markdown-dir", "pdf", "image", "csv", "json", "jsonl"]),
+  label: z.string(),
+  sectionTitle: z.string(),
+  markdown: z.string(),
+  filePath: z.string().nullable(),
+  score: z.number()
+});
+var workspaceSearchResultSchema = z.union([
+  z.object({
+    kind: z.literal("source"),
+    scope: z.literal("source"),
+    chunkId: z.number().int().nonnegative(),
+    sourceId: z.string(),
+    snapshotId: z.string(),
+    pageUrl: z.string(),
+    pageTitle: z.string(),
+    sectionTitle: z.string(),
+    markdown: z.string(),
+    pageKind: z.enum(["document", "file"]),
+    filePath: z.string().nullable(),
+    language: z.string().nullable(),
+    score: z.number(),
+    signals: z.array(z.enum(["lexical", "vector"]))
+  }),
+  z.object({
+    kind: z.literal("derived"),
+    scope: z.literal("derived"),
+    artifactPath: z.string(),
+    artifactKind: z.string(),
+    sectionTitle: z.string(),
+    markdown: z.string(),
+    stale: z.boolean(),
+    score: z.number()
+  })
+]);
 var server = new McpServer({
   name: packageName,
   version: packageVersion,
@@ -251,11 +483,89 @@ var toolHandlers = {
   }),
   project_link: async (args = {}) => linkProjectSources(args.projectPath, args.sourceIds),
   project_unlink: async (args = {}) => unlinkProjectSources(args.projectPath, args.sourceIds ?? []),
+  workspace_create: async (args = {}) => createWorkspace({
+    workspaceId: args.workspaceId,
+    label: args.label,
+    ...typeof args.purpose === "string" ? { purpose: args.purpose } : {},
+    ...typeof args.autoCompileEnabled === "boolean" ? { autoCompileEnabled: args.autoCompileEnabled } : {},
+    ...Array.isArray(args.defaultOutputFormats) ? { defaultOutputFormats: args.defaultOutputFormats } : {}
+  }),
+  workspace_list: async () => listWorkspaceRecords(),
+  workspace_update: async (args = {}) => updateWorkspaceSettings({
+    workspaceId: args.workspaceId,
+    autoCompileEnabled: args.autoCompileEnabled
+  }),
+  workspace_bind: async (args = {}) => bindWorkspaceSources({
+    workspaceId: args.workspaceId,
+    sourceIds: args.sourceIds
+  }),
+  workspace_unbind: async (args = {}) => unbindWorkspaceSources({
+    workspaceId: args.workspaceId,
+    ...Array.isArray(args.sourceIds) ? { sourceIds: args.sourceIds } : {}
+  }),
+  workspace_compile: async (args = {}) => compileWorkspaceArtifacts(args.workspaceId),
+  workspace_queue_run: async (args = {}) => runQueuedWorkspaceCompiles({
+    ...typeof args.maxJobs === "number" ? { maxJobs: args.maxJobs } : {}
+  }),
+  workspace_status: async (args = {}) => getWorkspaceStatus(args.workspaceId),
+  workspace_search: async (args = {}) => searchWorkspaceCatalog(
+    args.workspaceId,
+    args.query,
+    {
+      ...typeof args.scope === "string" ? { scope: args.scope } : {},
+      ...Array.isArray(args.pathPatterns) ? { path: args.pathPatterns } : {},
+      ...Array.isArray(args.languages) ? { language: args.languages } : {},
+      ...typeof args.mode === "string" ? { mode: args.mode } : {},
+      ...typeof args.limit === "number" ? { limit: args.limit } : {},
+      ...typeof args.offset === "number" ? { offset: args.offset } : {}
+    }
+  ),
+  workspace_ingest_add: async (args = {}) => ingestWorkspaceRawInput({
+    workspaceId: args.workspaceId,
+    kind: args.kind,
+    sourcePath: args.path,
+    ...typeof args.label === "string" ? { label: args.label } : {}
+  }),
+  workspace_ingest_list: async (args = {}) => listWorkspaceRawInputsRecord(args.workspaceId),
+  workspace_ingest_show: async (args = {}) => showWorkspaceRawInput(args.workspaceId, args.rawInputId),
+  workspace_ingest_search: async (args = {}) => searchWorkspaceRawInputCatalog({
+    workspaceId: args.workspaceId,
+    query: args.query,
+    ...Array.isArray(args.kinds) ? { kinds: args.kinds } : {},
+    ...typeof args.limit === "number" ? { limit: args.limit } : {},
+    ...typeof args.offset === "number" ? { offset: args.offset } : {}
+  }),
+  workspace_ingest_remove: async (args = {}) => removeWorkspaceRawInput({
+    workspaceId: args.workspaceId,
+    rawInputId: args.rawInputId
+  }),
+  workspace_artifact_list: async (args = {}) => listWorkspaceArtifacts(args.workspaceId),
+  workspace_artifact_show: async (args = {}) => showWorkspaceArtifact(args.workspaceId, args.artifactPath),
+  workspace_lint: async (args = {}) => lintWorkspaceArtifacts(args.workspaceId),
+  workspace_output: async (args = {}) => generateWorkspaceArtifactOutput({
+    workspaceId: args.workspaceId,
+    format: args.format,
+    ...typeof args.name === "string" ? { name: args.name } : {},
+    ...typeof args.prompt === "string" ? { prompt: args.prompt } : {}
+  }),
+  workspace_answer: async (args = {}) => answerWorkspace({
+    workspaceId: args.workspaceId,
+    question: args.question,
+    format: args.format,
+    ...typeof args.name === "string" ? { name: args.name } : {}
+  }),
+  workspace_sync_obsidian: async (args = {}) => syncWorkspaceToObsidianVault({
+    workspaceId: args.workspaceId,
+    vaultPath: args.vaultPath,
+    ...typeof args.exportSubdir === "string" ? { exportSubdir: args.exportSubdir } : {}
+  }),
   search: async (args = {}) => searchCatalog(args.query, {
     source: args.sourceIds ?? [],
     ...typeof args.snapshotId === "string" ? { snapshot: args.snapshotId } : {},
     ...typeof args.all === "boolean" ? { all: args.all } : {},
     ...typeof args.project === "string" ? { project: args.project } : {},
+    ...Array.isArray(args.pathPatterns) ? { path: args.pathPatterns } : {},
+    ...Array.isArray(args.languages) ? { language: args.languages } : {},
     ...typeof args.mode === "string" ? { mode: args.mode } : {},
     ...typeof args.limit === "number" ? { limit: args.limit } : {},
     ...typeof args.offset === "number" ? { offset: args.offset } : {}
@@ -496,6 +806,397 @@ registerAiocsTool(
     })
   }
 );
+registerAiocsTool(
+  "workspace_create",
+  {
+    title: "Workspace create",
+    description: "Create or update a research workspace with the default LM Studio compiler profile.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      label: z.string(),
+      purpose: z.string().optional(),
+      autoCompileEnabled: z.boolean().optional(),
+      defaultOutputFormats: z.array(z.enum(["report", "slides", "summary"])).optional()
+    }),
+    outputSchema: z.object({
+      workspace: workspaceSchema
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_update",
+  {
+    title: "Workspace update",
+    description: "Update workspace settings such as automatic recompilation.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      autoCompileEnabled: z.boolean()
+    }),
+    outputSchema: z.object({
+      workspace: workspaceSchema
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_list",
+  {
+    title: "Workspace list",
+    description: "List all research workspaces in the local aiocs catalog.",
+    outputSchema: z.object({
+      workspaces: z.array(workspaceSchema)
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_bind",
+  {
+    title: "Workspace bind",
+    description: "Bind one or more existing aiocs sources to a research workspace.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      sourceIds: z.array(z.string()).min(1)
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      sourceIds: z.array(z.string())
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_unbind",
+  {
+    title: "Workspace unbind",
+    description: "Unbind one or more sources from a research workspace.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      sourceIds: z.array(z.string()).optional()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      sourceIds: z.array(z.string())
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_compile",
+  {
+    title: "Workspace compile",
+    description: "Compile or refresh derived workspace wiki artifacts from bound canonical sources.",
+    inputSchema: z.object({
+      workspaceId: z.string()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      skipped: z.boolean(),
+      sourceFingerprint: z.string(),
+      changedSourceIds: z.array(z.string()),
+      changedRawInputIds: z.array(z.string()),
+      updatedArtifactPaths: z.array(z.string()),
+      artifactCount: z.number().int().nonnegative(),
+      compileRunId: z.string().nullable()
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_status",
+  {
+    title: "Workspace status",
+    description: "Show workspace metadata, bindings, artifacts, graph summary, and recent compile runs.",
+    inputSchema: z.object({
+      workspaceId: z.string()
+    }),
+    outputSchema: z.object({
+      workspace: workspaceSchema,
+      bindings: z.array(workspaceBindingSchema),
+      artifacts: z.array(workspaceArtifactSchema),
+      compileJob: workspaceCompileJobSchema.nullable(),
+      compileRuns: z.array(z.object({
+        runId: z.string(),
+        workspaceId: z.string(),
+        status: z.enum(["success", "failed"]),
+        sourceFingerprint: z.string(),
+        artifactCount: z.number().int().nonnegative(),
+        errorMessage: z.string().nullable(),
+        startedAt: z.string(),
+        finishedAt: z.string()
+      })),
+      rawInputs: z.array(workspaceRawInputSchema),
+      syncTargets: z.array(workspaceSyncTargetSchema),
+      questionRuns: z.array(workspaceQuestionRunSchema),
+      links: z.array(workspaceArtifactLinkSchema),
+      graph: z.object({
+        linkCount: z.number().int().nonnegative(),
+        brokenLinkCount: z.number().int().nonnegative(),
+        orphanArtifactCount: z.number().int().nonnegative(),
+        backlinkCount: z.number().int().nonnegative(),
+        relationCounts: z.object({
+          explicit_link: z.number().int().nonnegative(),
+          derived_from: z.number().int().nonnegative(),
+          mentions: z.number().int().nonnegative(),
+          related_to: z.number().int().nonnegative(),
+          expands: z.number().int().nonnegative(),
+          index_entry: z.number().int().nonnegative(),
+          summary_of: z.number().int().nonnegative(),
+          concept_of: z.number().int().nonnegative(),
+          output_depends_on: z.number().int().nonnegative()
+        }),
+        mostLinkedArtifacts: z.array(z.object({
+          artifactPath: z.string(),
+          incomingCount: z.number().int().nonnegative(),
+          outgoingCount: z.number().int().nonnegative()
+        }))
+      }),
+      lintSummary: workspaceLintSchema.shape.summary,
+      health: workspaceHealthSchema
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_queue_run",
+  {
+    title: "Workspace queue run",
+    description: "Process queued workspace compile jobs.",
+    inputSchema: z.object({
+      maxJobs: z.number().int().positive().optional()
+    }),
+    outputSchema: z.object({
+      processedJobs: z.number().int().nonnegative(),
+      succeededJobs: z.array(z.object({
+        workspaceId: z.string(),
+        sourceFingerprint: z.string(),
+        changedSourceIds: z.array(z.string()),
+        changedRawInputIds: z.array(z.string())
+      })),
+      failedJobs: z.array(z.object({
+        workspaceId: z.string(),
+        errorMessage: z.string()
+      }))
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_search",
+  {
+    title: "Workspace search",
+    description: "Search canonical source evidence, derived artifacts, or both within a research workspace.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      query: z.string(),
+      scope: z.enum(["source", "derived", "mixed"]).optional(),
+      pathPatterns: z.array(z.string()).optional(),
+      languages: z.array(z.string()).optional(),
+      mode: z.enum(["auto", "lexical", "hybrid", "semantic"]).optional(),
+      limit: z.number().int().positive().optional(),
+      offset: z.number().int().nonnegative().optional()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      query: z.string(),
+      scope: z.enum(["source", "derived", "mixed"]),
+      limit: z.number().int().positive(),
+      offset: z.number().int().nonnegative(),
+      hasMore: z.boolean(),
+      modeRequested: z.enum(["auto", "lexical", "hybrid", "semantic"]),
+      modeUsed: z.union([z.enum(["auto", "lexical", "hybrid", "semantic"]), z.literal("derived")]),
+      total: z.number().int().nonnegative(),
+      results: z.array(workspaceSearchResultSchema)
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_ingest_add",
+  {
+    title: "Workspace ingest add",
+    description: "Ingest a local markdown directory, PDF, image, CSV, JSON, or JSONL file into a research workspace as raw evidence.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      kind: z.enum(["markdown-dir", "pdf", "image", "csv", "json", "jsonl"]),
+      path: z.string(),
+      label: z.string().optional()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      rawInput: workspaceRawInputSchema
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_ingest_list",
+  {
+    title: "Workspace ingest list",
+    description: "List raw inputs ingested into a workspace.",
+    inputSchema: z.object({
+      workspaceId: z.string()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      rawInputs: z.array(workspaceRawInputSchema)
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_ingest_show",
+  {
+    title: "Workspace ingest show",
+    description: "Show one raw input together with its searchable chunks.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      rawInputId: z.string()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      rawInput: workspaceRawInputSchema,
+      chunks: z.array(z.object({
+        id: z.number().int().nonnegative(),
+        workspace_id: z.string(),
+        raw_input_id: z.string(),
+        section_title: z.string(),
+        markdown: z.string(),
+        file_path: z.string().nullable(),
+        score: z.number()
+      }))
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_ingest_search",
+  {
+    title: "Workspace ingest search",
+    description: "Search workspace-scoped raw input chunks directly, including structured dataset inputs.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      query: z.string(),
+      kinds: z.array(z.enum(["markdown-dir", "pdf", "image", "csv", "json", "jsonl"])).optional(),
+      limit: z.number().int().positive().optional(),
+      offset: z.number().int().nonnegative().optional()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      query: z.string(),
+      total: z.number().int().nonnegative(),
+      limit: z.number().int().positive(),
+      offset: z.number().int().nonnegative(),
+      hasMore: z.boolean(),
+      results: z.array(workspaceRawInputSearchResultSchema)
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_ingest_remove",
+  {
+    title: "Workspace ingest remove",
+    description: "Remove one raw input and its derived artifacts from a workspace.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      rawInputId: z.string()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      rawInputId: z.string(),
+      deleted: z.boolean()
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_artifact_list",
+  {
+    title: "Workspace artifact list",
+    description: "List derived artifacts recorded for a workspace.",
+    inputSchema: z.object({
+      workspaceId: z.string()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      artifacts: z.array(workspaceArtifactSchema)
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_artifact_show",
+  {
+    title: "Workspace artifact show",
+    description: "Read a workspace artifact file together with its provenance metadata.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      artifactPath: z.string()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      artifact: workspaceArtifactSchema,
+      content: z.string(),
+      provenance: z.array(workspaceArtifactProvenanceSchema),
+      rawInputProvenance: z.array(workspaceArtifactRawInputProvenanceSchema)
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_lint",
+  {
+    title: "Workspace lint",
+    description: "Lint a workspace for stale artifacts, graph issues, and deterministic suggestion candidates.",
+    inputSchema: z.object({
+      workspaceId: z.string()
+    }),
+    outputSchema: workspaceLintSchema
+  }
+);
+registerAiocsTool(
+  "workspace_output",
+  {
+    title: "Workspace output",
+    description: "Generate a report, slide deck, or summary artifact from a compiled workspace.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      format: z.enum(["report", "slides", "summary"]),
+      name: z.string().optional(),
+      prompt: z.string().optional()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      format: z.enum(["report", "slides", "summary"]),
+      path: z.string(),
+      artifactCount: z.number().int().nonnegative()
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_answer",
+  {
+    title: "Workspace answer",
+    description: "Answer a question against a compiled workspace and save the result as a derived artifact.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      question: z.string(),
+      format: z.enum(["report", "slides", "summary", "note"]),
+      name: z.string().optional()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      format: z.enum(["report", "slides", "summary", "note"]),
+      path: z.string(),
+      artifactCount: z.number().int().nonnegative(),
+      questionRun: workspaceQuestionRunSchema
+    })
+  }
+);
+registerAiocsTool(
+  "workspace_sync_obsidian",
+  {
+    title: "Workspace sync Obsidian",
+    description: "Sync a workspace tree into an Obsidian vault target.",
+    inputSchema: z.object({
+      workspaceId: z.string(),
+      vaultPath: z.string(),
+      exportSubdir: z.string().optional()
+    }),
+    outputSchema: z.object({
+      workspaceId: z.string(),
+      vaultPath: z.string(),
+      targetPath: z.string(),
+      exportSubdir: z.string()
+    })
+  }
+);
 registerAiocsTool(
   "search",
   {
@@ -507,6 +1208,8 @@ registerAiocsTool(
       snapshotId: z.string().optional(),
       all: z.boolean().optional(),
       project: z.string().optional(),
+      pathPatterns: z.array(z.string()).optional(),
+      languages: z.array(z.string()).optional(),
       mode: z.enum(["auto", "lexical", "hybrid", "semantic"]).optional(),
       limit: z.number().int().positive().optional(),
       offset: z.number().int().nonnegative().optional()