@shrkcrft/mcp-server 0.1.0-alpha.15 → 0.1.0-alpha.17

package/dist/tools/get-graph-search.tool.js

@@ -1,4 +1,5 @@
 import { GraphQueryApi, GraphStore } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 const NEXT = 'shrk graph index';
 export const getGraphSearchTool = {
     name: 'get_graph_search',
@@ -11,6 +12,7 @@ export const getGraphSearchTool = {
             kind: { type: 'string', enum: ['file', 'symbol', 'package'] },
             limit: { type: 'number' },
             exact: { type: 'boolean' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         required: ['query'],
         additionalProperties: false,
@@ -53,15 +55,14 @@ export const getGraphSearchTool = {
             if (p)
                 matches.push(p.node);
         }
-        return {
-            data: {
-                schema: 'sharkcraft.graph-search/v1',
-                query,
-                kind: args.kind ?? 'any',
-                total: Math.min(matches.length, limit),
-                matches: matches.slice(0, limit).map(summarise),
-            },
+        const data = {
+            schema: 'sharkcraft.graph-search/v1',
+            query,
+            kind: args.kind ?? 'any',
+            total: Math.min(matches.length, limit),
+            matches: matches.slice(0, limit).map(summarise),
         };
+        return { data: formatObjectArrays(data, input) };
     },
 };
 function summarise(n) {

package/dist/tools/get-graph-unresolved.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-graph-unresolved.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-unresolved.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AASpE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAsEpC,CAAC"}
+{"version":3,"file":"get-graph-unresolved.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-graph-unresolved.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAUpE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAyEpC,CAAC"}

package/dist/tools/get-graph-unresolved.tool.js

@@ -1,4 +1,5 @@
 import { EdgeKind, GraphStore } from '@shrkcrft/graph';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 const NEXT = 'shrk graph index';
 /**
  * Read-only MCP mirror of `shrk graph unresolved`. Returns every
@@ -10,12 +11,13 @@ const NEXT = 'shrk graph index';
  */
 export const getGraphUnresolvedTool = {
     name: 'get_graph_unresolved',
-    description: 'List every unresolved import in the code graph, grouped by source file. Sorted by unresolved-count desc. Read-only.',
+    description: 'List every unresolved import in the code graph, grouped by source file. Sorted by unresolved-count desc. Pass `format:"table"` for a token-efficient columnar encoding of the file list. Read-only.',
     cliCommand: 'graph unresolved',
     inputSchema: {
         type: 'object',
         properties: {
             limit: { type: 'number' },
+            ...FORMAT_INPUT_PROPERTY,
         },
         additionalProperties: false,
     },
@@ -68,14 +70,16 @@ export const getGraphUnresolvedTool = {
             return a.path.localeCompare(b.path);
         });
         const totalEdges = list.reduce((n, g) => n + g.unresolved.length, 0);
-        return {
-            data: {
-                schema: 'sharkcraft.graph-unresolved/v1',
-                totalEdges,
-                totalFiles: list.length,
-                truncated: list.length > limit,
-                files: list.slice(0, limit),
-            },
+        const data = {
+            schema: 'sharkcraft.graph-unresolved/v1',
+            totalEdges,
+            totalFiles: list.length,
+            truncated: list.length > limit,
+            files: list.slice(0, limit),
         };
+        // `format:"table"` columnar-encodes the top-level `files` array (one row per
+        // source file); scalars (schema/totalEdges/…) and each row's inner
+        // `unresolved` string array are left untouched by the helper.
+        return { data: formatObjectArrays(data, input) };
     },
 };

package/dist/tools/get-knowledge-graph.tool.d.ts

@@ -1,3 +1,10 @@
 import type { IToolDefinition } from '../server/tool-definition.js';
+/**
+ * The knowledge graph is the largest single payload shrk emits — hundreds of
+ * homogeneous node/edge objects. `format:"table"` returns the same data in
+ * columnar form (schema hoisted once, keys deduped) which is still valid JSON
+ * but a fraction of the tokens. `format:"json"` (default) keeps the explicit
+ * node/edge arrays for back-compat.
+ */
 export declare const getKnowledgeGraphTool: IToolDefinition;
 //# sourceMappingURL=get-knowledge-graph.tool.d.ts.map

package/dist/tools/get-knowledge-graph.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-knowledge-graph.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-knowledge-graph.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,qBAAqB,EAAE,eASnC,CAAC"}
+{"version":3,"file":"get-knowledge-graph.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-knowledge-graph.tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,eA8DnC,CAAC"}

package/dist/tools/get-knowledge-graph.tool.js

@@ -1,10 +1,69 @@
 import { buildKnowledgeGraph } from '@shrkcrft/inspector';
+import { compactArrayToColumnar, estimateTokens } from '@shrkcrft/compress';
+import { wantsTable } from "../server/columnar-format.js";
+import { fitArrayToBudget } from "../server/fit-array-to-budget.js";
+/**
+ * The knowledge graph is the largest single payload shrk emits — hundreds of
+ * homogeneous node/edge objects. `format:"table"` returns the same data in
+ * columnar form (schema hoisted once, keys deduped) which is still valid JSON
+ * but a fraction of the tokens. `format:"json"` (default) keeps the explicit
+ * node/edge arrays for back-compat.
+ */
 export const getKnowledgeGraphTool = {
     name: 'get_knowledge_graph',
-    description: 'Return the full SharkCraft knowledge graph: nodes (knowledge/rules/paths/templates/pipelines/presets/packs/boundaries) and edges (related-template, preset-references, pipeline-step-references, …). Read-only.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'Return the full SharkCraft knowledge graph: nodes (knowledge/rules/paths/templates/pipelines/presets/packs/boundaries) and edges (related-template, preset-references, pipeline-step-references, …). Pass `format:"table"` for a token-efficient columnar encoding (still valid JSON) — recommended for large graphs. Read-only.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            format: {
+                type: 'string',
+                enum: ['json', 'table'],
+                description: 'json (default): explicit node/edge object arrays. table: columnar encoding (schema hoisted, keys deduped) — fewer tokens for large graphs.',
+            },
+            maxTokens: {
+                type: 'integer',
+                minimum: 1,
+                description: 'Token budget for the table. When set and the lossless columnar form still exceeds it, falls back to the lossy SmartCrusher row-sampler (representative rows kept; full original cached — retrieve via the returned ccrKey).',
+            },
+        },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const graph = buildKnowledgeGraph(ctx.inspection);
+        const asTable = wantsTable(input);
+        const maxTokens = typeof input.maxTokens === 'number' && input.maxTokens > 0 ? Math.floor(input.maxTokens) : undefined;
+        const nodesTable = asTable ? compactArrayToColumnar(graph.nodes) : null;
+        const edgesTable = asTable ? compactArrayToColumnar(graph.edges) : null;
+        // Only advertise `table` when at least one array actually compacted — a tiny
+        // graph (e.g. edges:[]) stays the plain JSON form rather than a mislabelled
+        // "table" whose fields are bare arrays.
+        if (nodesTable || edgesTable) {
+            // P5.2: with no budget, keep the lossless columnar form (unchanged). With
+            // a budget, fit each array — sampling + CCR when it's still over.
+            const nodes = maxTokens
+                ? fitArrayToBudget(graph.nodes, maxTokens, ctx.ccrStore)
+                : { value: nodesTable ?? graph.nodes };
+            const edges = maxTokens
+                ? fitArrayToBudget(graph.edges, maxTokens, ctx.ccrStore)
+                : { value: edgesTable ?? graph.edges };
+            const ccrKeys = [nodes.ccrKey, edges.ccrKey].filter((k) => Boolean(k));
+            const before = estimateTokens(JSON.stringify({ nodes: graph.nodes, edges: graph.edges }));
+            const after = estimateTokens(JSON.stringify({ nodes: nodes.value, edges: edges.value }));
+            return {
+                data: {
+                    format: 'table',
+                    legend: 'Columnar tables: _table.cols are column names; each _table.rows[i] is one record aligned to cols; _table.absent lists [row,col] positions whose key was absent. Reconstruct objects by zipping cols with each row, skipping absent positions. If a column appears in _table.dict, its row cells are integer indices into dict[<col>] (deref to the real value). A field may be a plain array when it was too small to compact. A _table.sample block means rows were dropped to fit a budget — retrieve the full original via ccrKey.',
+                    nodes: nodes.value,
+                    edges: edges.value,
+                    tokenEstimate: { before, after, saved: Math.max(0, before - after) },
+                    ...(ccrKeys.length > 0
+                        ? { ccrKeys, retrieveWith: `retrieve_original { "key": "${ccrKeys[0]}" }` }
+                        : {}),
+                },
+            };
+        }
+        // Default (and tiny-graph) path: the original bare `{ nodes, edges }` shape,
+        // byte-identical to pre-compression clients (no extra `format` key).
         return { data: { nodes: graph.nodes, edges: graph.edges } };
     },
 };

package/dist/tools/get-relevant-context.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-relevant-context.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-relevant-context.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE,eAAO,MAAM,sBAAsB,EAAE,eAqDpC,CAAC"}
+{"version":3,"file":"get-relevant-context.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-relevant-context.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAKpE,eAAO,MAAM,sBAAsB,EAAE,eA6EpC,CAAC"}

package/dist/tools/get-relevant-context.tool.js

@@ -1,5 +1,6 @@
 import { buildContext } from '@shrkcrft/context';
 import { buildProjectOverview, renderOverviewText } from '@shrkcrft/inspector';
+import { compressMarkdown } from '@shrkcrft/compress';
 export const getRelevantContextTool = {
     name: 'get_relevant_context',
     description: 'Build a token-budgeted, AI-ready context for a task — relevant rules/paths/templates/etc. **Prefer `prepare_agent_task` for first task grounding** (it returns this plus action hints + safety + next-command). Use this when you only need the context body. Read-only.',
@@ -17,6 +18,10 @@ export const getRelevantContextTool = {
             includeRules: { type: 'boolean' },
             includePaths: { type: 'boolean' },
             includeDocs: { type: 'boolean' },
+            compact: {
+                type: 'boolean',
+                description: 'When true, the markdown body is run through the deterministic markdown compressor (headers/leads/structure kept, prose thinned). Reversible: the original is cached and a `<<ccr:KEY>>` marker emitted — call retrieve_original to get it back.',
+            },
         },
         required: ['task'],
         additionalProperties: false,
@@ -37,18 +42,37 @@ export const getRelevantContextTool = {
             includeDocs: input.includeDocs,
             projectOverview: renderOverviewText(overview),
         });
+        const sections = result.sections.map((s) => ({
+            title: s.title,
+            tokens: s.tokens,
+            truncated: s.truncated ?? false,
+            entryIds: s.entryIds,
+        }));
+        if (input.compact === true) {
+            const c = compressMarkdown(result.body, ctx.ccrStore ? { store: ctx.ccrStore } : {});
+            return {
+                text: c.compressed,
+                data: {
+                    totalTokens: result.totalTokens,
+                    maxTokens: result.maxTokens,
+                    omittedSections: result.omittedSections,
+                    sections,
+                    compaction: {
+                        strategy: c.strategy,
+                        tokensBefore: c.savings.before,
+                        tokensAfter: c.savings.after,
+                        ccrKey: c.ccrKey ?? null,
+                    },
+                },
+            };
+        }
         return {
             text: result.body,
             data: {
                 totalTokens: result.totalTokens,
                 maxTokens: result.maxTokens,
                 omittedSections: result.omittedSections,
-                sections: result.sections.map((s) => ({
-                    title: s.title,
-                    tokens: s.tokens,
-                    truncated: s.truncated ?? false,
-                    entryIds: s.entryIds,
-                })),
+                sections,
             },
         };
     },

package/dist/tools/get-task-packet.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-task-packet.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-task-packet.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,eA8C/B,CAAC"}
+{"version":3,"file":"get-task-packet.tool.d.ts","sourceRoot":"","sources":["../../src/tools/get-task-packet.tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,iBAAiB,EAAE,eAiD/B,CAAC"}

package/dist/tools/get-task-packet.tool.js

@@ -1,13 +1,15 @@
 import { buildTaskPacket } from '@shrkcrft/inspector';
+import { FORMAT_INPUT_PROPERTY, formatObjectArrays } from "../server/columnar-format.js";
 export const getTaskPacketTool = {
     name: 'get_task_packet',
-    description: 'Full machine task packet (project overview, detected profiles, recommended pipelines, relevant rules/paths/templates, action hints, recommended CLI/MCP, forbidden actions, verification commands, human-review checkpoints, token-budgeted context body). **Prefer `prepare_agent_task` for first task grounding** — it returns the curated agent bundle plus next-safe-action. Read-only.',
+    description: 'Full machine task packet (project overview, detected profiles, recommended pipelines, relevant rules/paths/templates, action hints, recommended CLI/MCP, forbidden actions, verification commands, human-review checkpoints, token-budgeted context body). Pass `format:"table"` for a token-efficient columnar encoding of the structured lists. **Prefer `prepare_agent_task` for first task grounding** — it returns the curated agent bundle plus next-safe-action. Read-only.',
     inputSchema: {
         type: 'object',
         properties: {
             task: { type: 'string' },
             maxTokens: { type: 'number', minimum: 100, maximum: 20000 },
             scope: { type: 'array', items: { type: 'string' } },
+            ...FORMAT_INPUT_PROPERTY,
         },
         required: ['task'],
         additionalProperties: false,
@@ -22,27 +24,29 @@ export const getTaskPacketTool = {
             maxTokens,
             ...(scope ? { scope } : {}),
         });
-        return {
-            data: {
-                task: packet.task,
-                detectedProfiles: packet.detectedProfiles,
-                recommendedPipelines: packet.recommendedPipelines,
-                presetRecommendations: packet.presetRecommendations.map((r) => ({
-                    presetId: r.preset.id,
-                    confidence: r.confidence,
-                    score: r.score,
-                })),
-                relevantRules: packet.relevantRules.map((r) => ({ id: r.id, title: r.title })),
-                relevantPaths: packet.relevantPaths.map((p) => ({ id: p.id, title: p.title })),
-                relevantTemplates: packet.relevantTemplates.map((t) => ({ id: t.id, name: t.name })),
-                recommendedMcpTools: packet.recommendedMcpTools,
-                recommendedCliCommands: packet.recommendedCliCommands,
-                forbiddenActions: packet.forbiddenActions,
-                verificationCommands: packet.verificationCommands,
-                humanReviewPoints: packet.humanReviewPoints,
-                tokenEstimate: packet.tokenEstimate,
-                context: packet.context,
-            },
+        const data = {
+            task: packet.task,
+            detectedProfiles: packet.detectedProfiles,
+            recommendedPipelines: packet.recommendedPipelines,
+            presetRecommendations: packet.presetRecommendations.map((r) => ({
+                presetId: r.preset.id,
+                confidence: r.confidence,
+                score: r.score,
+            })),
+            relevantRules: packet.relevantRules.map((r) => ({ id: r.id, title: r.title })),
+            relevantPaths: packet.relevantPaths.map((p) => ({ id: p.id, title: p.title })),
+            relevantTemplates: packet.relevantTemplates.map((t) => ({ id: t.id, name: t.name })),
+            recommendedMcpTools: packet.recommendedMcpTools,
+            recommendedCliCommands: packet.recommendedCliCommands,
+            forbiddenActions: packet.forbiddenActions,
+            verificationCommands: packet.verificationCommands,
+            humanReviewPoints: packet.humanReviewPoints,
+            tokenEstimate: packet.tokenEstimate,
+            context: packet.context,
         };
+        // `format:"table"` columnar-encodes the structured object-array fields
+        // (relevantRules/Paths/Templates, presetRecommendations, …); scalars,
+        // string arrays, and the markdown context body are left untouched.
+        return { data: formatObjectArrays(data, input) };
     },
 };

package/dist/tools/list-boundary-rules.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-boundary-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-boundary-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,qBAAqB,EAAE,eAoBnC,CAAC"}
+{"version":3,"file":"list-boundary-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-boundary-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,qBAAqB,EAAE,eAuBnC,CAAC"}

package/dist/tools/list-boundary-rules.tool.js

@@ -1,20 +1,24 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listBoundaryRulesTool = {
     name: 'list_boundary_rules',
-    description: 'List every configured boundary rule (local + pack-contributed). Returns id, title, severity, from/forbidden patterns, source.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        return {
-            data: ctx.inspection.boundaryRegistry.list().map((r) => ({
-                id: r.id,
-                title: r.title,
-                description: r.description,
-                severity: r.severity ?? 'error',
-                from: r.from,
-                forbiddenImports: r.forbiddenImports ?? [],
-                allowedImports: r.allowedImports ?? [],
-                tags: r.tags ?? [],
-                source: ctx.inspection.boundarySources.get(r.id) ?? null,
-            })),
-        };
+    description: 'List every configured boundary rule (local + pack-contributed). Returns id, title, severity, from/forbidden patterns, source. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const rows = ctx.inspection.boundaryRegistry.list().map((r) => ({
+            id: r.id,
+            title: r.title,
+            description: r.description,
+            severity: r.severity ?? 'error',
+            from: r.from,
+            forbiddenImports: r.forbiddenImports ?? [],
+            allowedImports: r.allowedImports ?? [],
+            tags: r.tags ?? [],
+            source: ctx.inspection.boundarySources.get(r.id) ?? null,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-knowledge.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-knowledge.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-knowledge.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,eA8C/B,CAAC"}
+{"version":3,"file":"list-knowledge.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-knowledge.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,iBAAiB,EAAE,eA8C/B,CAAC"}

package/dist/tools/list-knowledge.tool.js

@@ -1,6 +1,7 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listKnowledgeTool = {
     name: 'list_knowledge',
-    description: 'Lists available knowledge entries (id, title, type, tags, scope, priority, appliesWhen). Filterable.',
+    description: 'Lists available knowledge entries (id, title, type, tags, scope, priority, appliesWhen). Filterable. Pass `format:"table"` for a token-efficient columnar payload.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -10,6 +11,7 @@ export const listKnowledgeTool = {
             tags: { type: 'array', items: { type: 'string' } },
             appliesWhen: { type: 'array', items: { type: 'string' } },
             limit: { type: 'integer', minimum: 1 },
+            ...FORMAT_INPUT_PROPERTY,
         },
         additionalProperties: false,
     },
@@ -30,17 +32,16 @@ export const listKnowledgeTool = {
             entries = entries.filter((e) => appliesWhen.some((a) => e.appliesWhen.includes(a)));
         }
         entries = entries.slice(0, limit);
-        return {
-            data: entries.map((e) => ({
-                id: e.id,
-                title: e.title,
-                type: e.type,
-                priority: e.priority,
-                scope: e.scope,
-                tags: e.tags,
-                appliesWhen: e.appliesWhen,
-                summary: e.summary,
-            })),
-        };
+        const rows = entries.map((e) => ({
+            id: e.id,
+            title: e.title,
+            type: e.type,
+            priority: e.priority,
+            scope: e.scope,
+            tags: e.tags,
+            appliesWhen: e.appliesWhen,
+            summary: e.summary,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-packs.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-packs.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-packs.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,eAmB3B,CAAC"}
+{"version":3,"file":"list-packs.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-packs.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,aAAa,EAAE,eAsB3B,CAAC"}

package/dist/tools/list-packs.tool.js

@@ -1,19 +1,23 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listPacksTool = {
     name: 'list_packs',
-    description: 'List discovered SharkCraft packs (third-party npm packages that ship knowledge / templates / pipelines). Each entry includes both declared file counts and resolved object counts after dedup.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
-        return {
-            data: ctx.inspection.packs.discoveredPacks.map((p) => ({
-                packageName: p.packageName,
-                packageVersion: p.packageVersion,
-                valid: p.valid,
-                contributionCounts: p.contributionCounts,
-                resolvedCounts: p.resolvedCounts,
-                signatureStatus: p.signatureStatus,
-                signatureMessage: p.signatureMessage,
-                loadError: p.loadError,
-            })),
-        };
+    description: 'List discovered SharkCraft packs (third-party npm packages that ship knowledge / templates / pipelines). Each entry includes both declared file counts and resolved object counts after dedup. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const rows = ctx.inspection.packs.discoveredPacks.map((p) => ({
+            packageName: p.packageName,
+            packageVersion: p.packageVersion,
+            valid: p.valid,
+            contributionCounts: p.contributionCounts,
+            resolvedCounts: p.resolvedCounts,
+            signatureStatus: p.signatureStatus,
+            signatureMessage: p.signatureMessage,
+            loadError: p.loadError,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-path-conventions.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-path-conventions.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-path-conventions.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,uBAAuB,EAAE,eAmBrC,CAAC"}
+{"version":3,"file":"list-path-conventions.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-path-conventions.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,uBAAuB,EAAE,eAsBrC,CAAC"}

package/dist/tools/list-path-conventions.tool.js

@@ -1,20 +1,24 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listPathConventionsTool = {
     name: 'list_path_conventions',
-    description: 'List known path conventions.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'List known path conventions. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const paths = ctx.inspection.pathService.list();
-        return {
-            data: paths.map((p) => ({
-                id: p.id,
-                title: p.title,
-                path: p.metadata?.path ?? '',
-                priority: p.priority,
-                tags: p.tags,
-                scope: p.scope,
-                appliesWhen: p.appliesWhen,
-                description: p.metadata?.description ?? p.summary,
-            })),
-        };
+        const rows = paths.map((p) => ({
+            id: p.id,
+            title: p.title,
+            path: p.metadata?.path ?? '',
+            priority: p.priority,
+            tags: p.tags,
+            scope: p.scope,
+            appliesWhen: p.appliesWhen,
+            description: p.metadata?.description ?? p.summary,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-pipelines.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-pipelines.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-pipelines.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,eAkB/B,CAAC"}
+{"version":3,"file":"list-pipelines.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-pipelines.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,iBAAiB,EAAE,eAqB/B,CAAC"}

package/dist/tools/list-pipelines.tool.js

@@ -1,19 +1,23 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listPipelinesTool = {
     name: 'list_pipelines',
-    description: 'List available SharkCraft AI development pipelines (declarative agent workflows).',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'List available SharkCraft AI development pipelines (declarative agent workflows). Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const list = ctx.inspection.pipelineRegistry.list();
-        return {
-            data: list.map((p) => ({
-                id: p.id,
-                title: p.title,
-                description: p.description,
-                tags: p.tags ?? [],
-                scope: p.scope ?? [],
-                appliesWhen: p.appliesWhen ?? [],
-                stepCount: p.steps.length,
-            })),
-        };
+        const rows = list.map((p) => ({
+            id: p.id,
+            title: p.title,
+            description: p.description,
+            tags: p.tags ?? [],
+            scope: p.scope ?? [],
+            appliesWhen: p.appliesWhen ?? [],
+            stepCount: p.steps.length,
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-presets.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-presets.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-presets.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,eAAe,EAAE,eA0B7B,CAAC"}
+{"version":3,"file":"list-presets.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-presets.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,eAAe,EAAE,eA6B7B,CAAC"}

package/dist/tools/list-presets.tool.js

@@ -1,26 +1,30 @@
+import { FORMAT_INPUT_PROPERTY, formatRows } from "../server/columnar-format.js";
 export const listPresetsTool = {
     name: 'list_presets',
-    description: 'List all SharkCraft presets (built-in + pack-contributed). A preset is a reusable project setup (knowledge / rules / paths / templates / pipelines / docs) that can be applied via the CLI.',
-    inputSchema: { type: 'object', properties: {}, additionalProperties: false },
-    async handler(_input, ctx) {
+    description: 'List all SharkCraft presets (built-in + pack-contributed). A preset is a reusable project setup (knowledge / rules / paths / templates / pipelines / docs) that can be applied via the CLI. Pass `format:"table"` for a token-efficient columnar payload.',
+    inputSchema: {
+        type: 'object',
+        properties: { ...FORMAT_INPUT_PROPERTY },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
         const presets = ctx.inspection.presetRegistry.list();
-        return {
-            data: presets.map((p) => ({
-                id: p.id,
-                title: p.title,
-                description: p.description,
-                tags: p.tags ?? [],
-                appliesTo: p.appliesTo ?? [],
-                weight: p.weight ?? 5,
-                source: ctx.inspection.presetSources.get(p.id) ?? null,
-                counts: {
-                    knowledge: p.includes.knowledge?.length ?? 0,
-                    rules: p.includes.rules?.length ?? 0,
-                    paths: p.includes.paths?.length ?? 0,
-                    templates: p.includes.templates?.length ?? 0,
-                    pipelines: p.includes.pipelines?.length ?? 0,
-                },
-            })),
-        };
+        const rows = presets.map((p) => ({
+            id: p.id,
+            title: p.title,
+            description: p.description,
+            tags: p.tags ?? [],
+            appliesTo: p.appliesTo ?? [],
+            weight: p.weight ?? 5,
+            source: ctx.inspection.presetSources.get(p.id) ?? null,
+            counts: {
+                knowledge: p.includes.knowledge?.length ?? 0,
+                rules: p.includes.rules?.length ?? 0,
+                paths: p.includes.paths?.length ?? 0,
+                templates: p.includes.templates?.length ?? 0,
+                pipelines: p.includes.pipelines?.length ?? 0,
+            },
+        }));
+        return { data: formatRows(rows, input) };
     },
 };

package/dist/tools/list-rules.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,eAkB3B,CAAC"}
+{"version":3,"file":"list-rules.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-rules.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,eAAO,MAAM,aAAa,EAAE,eAqB3B,CAAC"}