@kaelio/ktx 0.1.0-rc.6 → 0.1.0

package/assets/python/manifest.json

@@ -2,10 +2,10 @@
   "schemaVersion": 1,
   "distributionName": "kaelio-ktx",
   "normalizedName": "kaelio_ktx",
-  "version": "0.1.0rc6",
+  "version": "0.1.0",
   "wheel": {
-    "file": "kaelio_ktx-0.1.0rc6-py3-none-any.whl",
-    "sha256": "0515d73bf89eb1c32422eb1fab0b59b01b49a23ef7bd8749dc5114361ba17ccc",
-    "bytes": 80550
+    "file": "kaelio_ktx-0.1.0-py3-none-any.whl",
+    "sha256": "1145cf0c90879270dc335a8d0ca49a598f81e0f47a37fdf646fc6c6798fe3c8b",
+    "bytes": 80523
   }
 }

package/dist/commands/mcp-commands.js

@@ -11,6 +11,16 @@ function tokenFromOption(value) {
 function binPath() {
     return fileURLToPath(new URL('../bin.js', import.meta.url));
 }
+function formatMcpStartResultMessage(input) {
+    return [
+        input.status === 'started' ? `KTX MCP daemon started: ${input.url}` : `KTX MCP daemon already running: ${input.url}`,
+        '',
+        'KTX is ready for configured agents.',
+        'Open your agent for this KTX project and ask a data question, for example:',
+        '  "Use KTX to show me the available tables and metrics."',
+        '',
+    ].join('\n');
+}
 export function registerMcpCommands(program, context) {
     const mcp = program.command('mcp').description('Run the KTX MCP HTTP server');
     mcp
@@ -66,9 +76,7 @@ export function registerMcpCommands(program, context) {
             allowedOrigins: options.allowedOrigin,
             binPath: binPath(),
         });
-        context.io.stdout.write(result.status === 'started'
-            ? `KTX MCP daemon started: ${result.url}\n`
-            : `KTX MCP daemon already running: ${result.url}\n`);
+        context.io.stdout.write(formatMcpStartResultMessage({ status: result.status, url: result.url }));
     });
     mcp
         .command('stop')

package/dist/commands/mcp-commands.test.js

@@ -65,7 +65,36 @@ describe('registerMcpCommands', () => {
         registerMcpCommands(program, context);
         await program.parseAsync(['--project-dir', '/tmp/ktx-already', 'mcp', 'start'], { from: 'user' });
         expect(startDaemon).toHaveBeenCalledTimes(1);
-        expect(context.io.stdout.write).toHaveBeenCalledWith('KTX MCP daemon already running: http://127.0.0.1:7878/mcp\n');
+        expect(context.io.stdout.write).toHaveBeenCalledWith([
+            'KTX MCP daemon already running: http://127.0.0.1:7878/mcp',
+            '',
+            'KTX is ready for configured agents.',
+            'Open your agent for this KTX project and ask a data question, for example:',
+            '  "Use KTX to show me the available tables and metrics."',
+            '',
+        ].join('\n'));
+    });
+    it('prints a friendly next step after starting the daemon', async () => {
+        const program = new Command().exitOverride().option('--project-dir <path>');
+        const startDaemon = vi.fn().mockResolvedValue({
+            status: 'started',
+            url: 'http://127.0.0.1:7878/mcp',
+            state: {
+                schemaVersion: 1,
+                pid: 4242,
+                host: '127.0.0.1',
+                port: 7878,
+                tokenAuth: false,
+                projectDir: '/tmp/ktx-started',
+                startedAt: '2026-05-14T00:00:00.000Z',
+                logPath: '/tmp/ktx-started/.ktx/logs/mcp.log',
+            },
+        });
+        const context = makeContext({ deps: { mcp: { startDaemon } } });
+        registerMcpCommands(program, context);
+        await program.parseAsync(['--project-dir', '/tmp/ktx-started', 'mcp', 'start'], { from: 'user' });
+        expect(context.io.stdout.write).toHaveBeenCalledWith(expect.stringContaining('KTX MCP daemon started: http://127.0.0.1:7878/mcp\n\nKTX is ready for configured agents.'));
+        expect(context.io.stdout.write).toHaveBeenCalledWith(expect.stringContaining('"Use KTX to show me the available tables and metrics."'));
     });
     it('runs the stdio server with the resolved project directory', async () => {
         const program = new Command().exitOverride().option('--project-dir <path>');

package/dist/ingest.test.js

@@ -807,16 +807,9 @@ describe('runKtxIngest', () => {
                     sourceKey: 'historic-sql',
                     body: {
                         workUnits: [],
-                        finalization: {
+                        postProcessor: {
                             sourceKey: 'historic-sql',
                             status: 'success',
-                            commitSha: 'finalization-sha',
-                            touchedPaths: ['semantic-layer/warehouse/_schema/public.yaml', 'wiki/global/historic-sql-orders.md'],
-                            declaredTouchedSources: [{ connectionId: 'warehouse', sourceName: 'orders' }],
-                            derivedTouchedSources: [{ connectionId: 'warehouse', sourceName: 'orders' }],
-                            declaredChangedWikiPageKeys: ['historic-sql-orders'],
-                            derivedChangedWikiPageKeys: ['historic-sql-orders'],
-                            mismatches: [],
                             result: {
                                 tableUsageMerged: 56,
                                 staleTablesMarked: 1,
@@ -826,24 +819,7 @@ describe('runKtxIngest', () => {
                             },
                             errors: [],
                             warnings: [],
-                            actions: [
-                                ...Array.from({ length: 57 }, (_, index) => ({
-                                    target: 'sl',
-                                    type: 'updated',
-                                    key: `orders-${index}`,
-                                    detail: 'Merged usage',
-                                    targetConnectionId: 'warehouse',
-                                    rawPaths: ['tables/public/orders.json'],
-                                })),
-                                ...Array.from({ length: 35 }, (_, index) => ({
-                                    target: 'wiki',
-                                    type: 'updated',
-                                    key: `historic-sql-orders-${index}`,
-                                    detail: 'Projected pattern',
-                                    rawPaths: ['patterns/orders.json'],
-                                })),
-                            ],
-                            provenanceExclusions: [],
+                            touchedSources: [],
                         },
                     },
                 }),

package/dist/next-steps.js

@@ -29,7 +29,7 @@ function commandLines(commands, indent) {
 }
 export function formatNextStepLines(indent = '  ') {
     return [
-        `${indent}KTX context is ready for agents. Open your coding agent in this directory and ask a data question.`,
+        `${indent}KTX context is ready for agents. Open your coding agent from the KTX project directory and ask a data question.`,
         `${indent}Verify with:`,
         ...commandLines(KTX_NEXT_STEP_DIRECT_COMMANDS, indent),
     ];

package/dist/next-steps.test.js

@@ -38,8 +38,10 @@ describe('KTX demo next steps', () => {
     it('explains what the next-step commands are for', () => {
         const rendered = formatNextStepLines().join('\n');
         expect(rendered).toContain('KTX context is ready for agents.');
+        expect(rendered).toContain('KTX project directory');
         expect(rendered).toContain('ask a data question');
         expect(rendered).toContain('Verify with:');
+        expect(rendered).not.toContain('this directory');
         expect(rendered).not.toContain('Preferred route');
         expect(rendered).not.toContain('Optional MCP:');
     });

package/dist/runtime-requirements.d.ts

@@ -1,7 +1,7 @@
 import type { KtxProjectConfig } from '@ktx/context/project';
 import type { KtxRuntimeFeature } from './managed-python-runtime.js';
 import type { KtxPublicIngestPlan } from './public-ingest.js';
-type KtxRuntimeRequirementReason = 'agent-mcp' | 'query-history' | 'looker-source' | 'database-introspection' | 'local-embeddings';
+type KtxRuntimeRequirementReason = 'query-history' | 'looker-source' | 'database-introspection' | 'local-embeddings';
 interface KtxRuntimeRequirement {
     feature: KtxRuntimeFeature;
     reason: KtxRuntimeRequirementReason;
@@ -12,7 +12,6 @@ export interface KtxRuntimeRequirements {
     requirements: KtxRuntimeRequirement[];
 }
 export interface KtxProjectRuntimeRequirementOptions {
-    agents?: boolean;
     databaseIntrospectionFallback?: boolean;
     env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
 }

package/dist/runtime-requirements.js

@@ -41,13 +41,6 @@ function uniqueRequirements(requirements) {
 export function resolveProjectRuntimeRequirements(config, options = {}) {
     const env = options.env ?? process.env;
     const requirements = [];
-    if (options.agents === true) {
-        requirements.push({
-            feature: 'core',
-            reason: 'agent-mcp',
-            detail: 'Agent MCP setup uses semantic-layer query tools and SQL validation.',
-        });
-    }
     if (options.databaseIntrospectionFallback === true && !hasDaemonOverride(env)) {
         requirements.push({
             feature: 'core',

package/dist/runtime-requirements.test.js

@@ -3,9 +3,9 @@ import { buildDefaultKtxProjectConfig } from '@ktx/context/project';
 import { describe, expect, it } from 'vitest';
 import { resolveProjectRuntimeRequirements, resolvePublicIngestRuntimeRequirements, } from './runtime-requirements.js';
 describe('runtime requirement detection', () => {
-    it('requires core for agent/MCP setup', () => {
+    it('does not require runtime for agent/MCP setup alone', () => {
         const config = buildDefaultKtxProjectConfig();
-        expect(resolveProjectRuntimeRequirements(config, { agents: true }).features).toEqual(['core']);
+        expect(resolveProjectRuntimeRequirements(config).features).toEqual([]);
     });
     it('requires core for Looker source ingest unless an external daemon is configured', () => {
         const config = {

package/dist/setup-agents.d.ts

@@ -12,6 +12,7 @@ export interface KtxSetupAgentsArgs {
     scope: KtxAgentScope;
     mode: KtxAgentInstallMode;
     skipAgents: boolean;
+    showNextActions?: boolean;
 }
 export type KtxSetupAgentsResult = {
     status: 'ready';
@@ -21,6 +22,7 @@ export type KtxSetupAgentsResult = {
         scope: KtxAgentScope;
         mode: KtxAgentInstallMode;
     }>;
+    nextActions?: string;
 } | {
     status: 'skipped';
     projectDir: string;
@@ -46,7 +48,7 @@ export interface KtxAgentInstallManifest {
     entries: Array<{
         kind: 'file';
         path: string;
-        role?: 'skill' | 'rule' | 'analytics-skill' | 'claude-plugin' | 'launcher';
+        role?: 'skill' | 'rule' | 'analytics-skill' | 'claude-desktop-skill-bundle' | 'launcher';
     } | {
         kind: 'json-key';
         path: string;
@@ -54,6 +56,7 @@ export interface KtxAgentInstallManifest {
     }>;
 }
 type InstallEntry = KtxAgentInstallManifest['entries'][number];
+export declare function createAgentNextActionsLineFormatter(stdout: KtxCliIo['stdout']): (line: string) => string;
 export declare function collectClaudeDesktopForwardedEnv(source: NodeJS.ProcessEnv): Record<string, string>;
 export declare function agentInstallManifestPath(projectDir: string): string;
 export declare function plannedKtxAgentFiles(input: {
@@ -79,10 +82,15 @@ export interface KtxSetupAgentsPromptAdapter {
 export interface KtxSetupAgentsDeps {
     prompts?: KtxSetupAgentsPromptAdapter;
 }
-export declare function formatInstallSummary(installs: Array<{
+export declare function targetDisplayName(target: string): string;
+export interface InstallSummaryEntry {
+    title: string;
+    lines: string[];
+}
+export declare function formatInstallSummaryLines(installs: Array<{
     target: KtxAgentTarget;
     scope: KtxAgentScope;
     mode: KtxAgentInstallMode;
-}>, entries: InstallEntry[], projectDir: string): string;
+}>, entries: InstallEntry[], projectDir: string): InstallSummaryEntry[];
 export declare function runKtxSetupAgentsStep(args: KtxSetupAgentsArgs, io: KtxCliIo, deps?: KtxSetupAgentsDeps): Promise<KtxSetupAgentsResult>;
 export {};