kontexted 0.1.10 → 0.1.12

package/dist/commands/skill.js

@@ -1,6 +1,6 @@
 import * as readline from "readline";
 import { readConfig, writeConfig } from "../lib/config.js";
-import { getProfile } from "../lib/profile.js";
+import { getProfile, listProfiles } from "../lib/profile.js";
 import { ApiClient } from "../lib/api-client.js";
 import { ensureValidTokens } from "../lib/oauth.js";
 import { getProvider, allTemplates } from "../skill-init/index.js";
@@ -117,6 +117,51 @@ async function createApiClient(alias) {
 function displayResult(result) {
     console.log(JSON.stringify(result, null, 2));
 }
+/**
+ * Interactive profile selection for skill init
+ * Returns { alias, hasWrite } or null if user chose generic
+ */
+async function selectProfile(profiles) {
+    // Build choices array
+    const choices = profiles.map(({ alias, profile }) => ({
+        alias,
+        hasWrite: profile.write,
+        label: `${alias} (write: ${profile.write ? '✓' : '✗'})`,
+    }));
+    // Add option to skip
+    choices.push({
+        alias: '',
+        hasWrite: false,
+        label: '[Skip - use generic template]',
+    });
+    console.log('\nSelect a profile to embed in kontexted-cli skill:\n');
+    choices.forEach((choice, index) => {
+        const marker = index === 0 ? '❯' : ' ';
+        console.log(`  ${marker} ${index + 1}. ${choice.label}`);
+    });
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question('\nEnter selection (1-' + choices.length + '): ', (answer) => {
+            rl.close();
+            const selection = parseInt(answer.trim(), 10);
+            if (isNaN(selection) || selection < 1 || selection > choices.length) {
+                console.log('Invalid selection, using generic template.');
+                resolve(null);
+                return;
+            }
+            const chosen = choices[selection - 1];
+            if (!chosen.alias) {
+                // User chose "Skip - use generic"
+                resolve(null);
+                return;
+            }
+            resolve({ alias: chosen.alias, hasWrite: chosen.hasWrite });
+        });
+    });
+}
 /**
  * Register the skill command and its subcommands
  */
@@ -279,6 +324,7 @@ export function registerSkillCommand(program) {
         .description("Initialize AI agent skills for the current project")
         .option("--provider <name>", "Provider to use (default: opencode)", "opencode")
         .option("--all", "Generate all available skills without prompting", false)
+        .option("--no-prompt", "Skip profile selection, use generic template", false)
         .action(async (options) => {
         try {
             // Get the provider
@@ -291,6 +337,28 @@ export function registerSkillCommand(program) {
                 console.error(`Available providers: ${["opencode"].join(", ")}`);
                 process.exit(1);
             }
+            // Resolve alias and write permissions through interactive selection
+            let alias;
+            let hasWrite = false;
+            if (!options.noPrompt) {
+                const config = await readConfig();
+                const profiles = listProfiles(config);
+                if (profiles.length > 0) {
+                    const selection = await selectProfile(profiles);
+                    if (selection) {
+                        alias = selection.alias;
+                        hasWrite = selection.hasWrite;
+                        console.log(`\nUsing profile: ${alias} (write: ${hasWrite})\n`);
+                    }
+                    else {
+                        console.log('\nUsing generic template (no alias)\n');
+                    }
+                }
+                else {
+                    console.log('No profiles found. Using generic template.\n');
+                    console.log('To create a profile, run: kontexted login --alias <name> --url <url> --workspace <slug>\n');
+                }
+            }
             // Show what will be generated
             console.log(`This will generate the following skills for ${provider.name}:`);
             for (const template of allTemplates) {
@@ -321,6 +389,8 @@ export function registerSkillCommand(program) {
                 const result = await initSkill({
                     skill: template,
                     provider,
+                    alias,
+                    hasWrite,
                 });
                 const status = result.created ? "Created" : "Updated";
                 console.log(`✓ ${status} ${result.path}`);

package/dist/skill-init/providers/base.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Options passed to skill content generator functions
+ */
+export interface SkillContentOptions {
+    /** Profile alias to substitute in commands */
+    alias?: string;
+    /** Whether the profile has write permissions */
+    hasWrite: boolean;
+}
 /**
  * Definition of a skill to be generated
  */
@@ -6,8 +15,15 @@ export interface SkillDefinition {
     name: string;
     /** Short description (1-1024 characters) */
     description: string;
-    /** The full skill content (markdown) */
-    content: string;
+    /** Static content string OR content generator function that receives options */
+    content: string | ((options: SkillContentOptions) => string);
+}
+/**
+ * Options for skill content generation
+ */
+export interface GenerateContentOptions {
+    /** Optional alias to include in frontmatter */
+    alias?: string;
 }
 /**
  * Provider interface for different AI agent platforms
@@ -22,5 +38,5 @@ export interface SkillProvider {
     /** Validate skill name according to provider rules */
     validateSkillName(name: string): boolean;
     /** Generate the complete skill file content including frontmatter */
-    generateSkillContent(skill: SkillDefinition): string;
+    generateSkillContent(skill: SkillDefinition, resolvedContent: string, options?: GenerateContentOptions): string;
 }

package/dist/skill-init/providers/opencode.js

@@ -33,16 +33,23 @@ export const opencodeProvider = {
     },
     /**
      * Generate the complete skill file content including frontmatter
-     * @param skill - The skill definition to generate content for
+     * @param skill - The skill definition (for name and description)
+     * @param resolvedContent - The resolved content string (after generator function if applicable)
+     * @param options - Optional metadata to include in frontmatter
      * @returns The complete markdown content with frontmatter
      */
-    generateSkillContent(skill) {
-        const frontmatter = `---
-name: ${skill.name}
-description: ${skill.description}
----`;
+    generateSkillContent(skill, resolvedContent, options) {
+        const frontmatterLines = [
+            `name: ${skill.name}`,
+            `description: ${skill.description}`,
+        ];
+        // Add alias to frontmatter if provided
+        if (options?.alias) {
+            frontmatterLines.push(`alias: ${options.alias}`);
+        }
+        const frontmatter = `---\n${frontmatterLines.join('\n')}\n---`;
         return `${frontmatter}
 
-${skill.content}`;
+${resolvedContent}`;
     }
 };

package/dist/skill-init/templates/kontexted-cli.js

@@ -1,24 +1,28 @@
-export const kontextedCliSkill = {
-    name: 'kontexted-cli',
-    description: 'Access and manage Kontexted workspaces, search notes, retrieve content, and create/update notes and folders through the kontexted CLI. Use when the user needs to explore workspace structure, find specific notes, read note content, or modify workspace content using profile aliases.',
-    content: String.raw `# Kontexted CLI Skill Commands
+/**
+ * Generate kontexted-cli skill content based on profile settings
+ */
+function generateKontextedCliContent(options) {
+    const { alias, hasWrite } = options;
+    // Use actual alias or generic placeholder
+    const a = alias || '<profile>';
+    return String.raw `# Kontexted CLI Skill Commands
 
-## Read Commands (No --write flag needed)
+## Read Commands
 
 \`\`\`
-kontexted skill workspace-tree --alias <profile>                    # Get workspace folder/note structure
-kontexted skill search-notes --alias <profile> --query "<text>"    # Search notes
-kontexted skill note-by-id --alias <profile> --note-id <id>        # Get specific note
+kontexted skill workspace-tree --alias ${a}
+kontexted skill search-notes --alias ${a} --query "<text>" [--limit <n>]
+kontexted skill note-by-id --alias ${a} --note-id <id>
 \`\`\`
-
-## Write Commands (Require write-enabled profile)
+${hasWrite ? `
+## Write Commands
 
 \`\`\`
-kontexted skill create-folder --alias <profile> --name <name> --display-name "<displayName>" [--parent-id <id>]
-kontexted skill create-note --alias <profile> --name <name> --title "<title>" [--folder-id <id>] [--content "<content>"]
-kontexted skill update-note-content --alias <profile> --note-id <id> --content "<content>"
+kontexted skill create-folder --alias ${a} --name <name> --display-name "<displayName>" [--parent-id <id>]
+kontexted skill create-note --alias ${a} --name <name> --title "<title>" [--folder-id <id>] [--content "<content>"]
+kontexted skill update-note-content --alias ${a} --note-id <id> --content "<content>"
 \`\`\`
-
+` : ''}
 ## Prerequisites
 
 Before using the kontexted CLI skill commands, ensure:
@@ -26,9 +30,9 @@ Before using the kontexted CLI skill commands, ensure:
 1. **kontexted CLI is installed** - Install via npm or your preferred package manager
 2. **User has authenticated** - User must have run \`kontexted login\` with a profile alias
 3. **Profile has a workspace configured** - The profile alias must be associated with an active workspace
-4. **Write operations require write-enabled profile** - To use write commands, the profile must have been created with \`kontexted login --write\`
+${hasWrite ? `4. **Write operations enabled** - This profile has write access enabled` : ''}
 
-All commands require the \`--alias\` parameter to specify which profile to use. The profile must already be set up and authenticated.
+All commands require the \`--alias\` parameter. ${alias ? `This skill is configured for the \`${alias}\` profile.` : 'The profile must already be set up and authenticated.'}
 
 ## Available Tools
 
@@ -39,7 +43,7 @@ All commands require the \`--alias\` parameter to specify which profile to use.
 Get the complete folder and note structure of a workspace.
 
 \`\`\`bash
-kontexted skill workspace-tree --alias <profile>
+kontexted skill workspace-tree --alias ${a}
 \`\`\`
 
 **Options:**
@@ -57,7 +61,7 @@ kontexted skill workspace-tree --alias <profile>
 Search for notes containing specific text content.
 
 \`\`\`bash
-kontexted skill search-notes --alias <profile> --query "<text>" [--limit <n>]
+kontexted skill search-notes --alias ${a} --query "<text>" [--limit <n>]
 \`\`\`
 
 **Options:**
@@ -77,7 +81,7 @@ kontexted skill search-notes --alias <profile> --query "<text>" [--limit <n>]
 Retrieve the complete content of a specific note by its ID.
 
 \`\`\`bash
-kontexted skill note-by-id --alias <profile> --note-id <id>
+kontexted skill note-by-id --alias ${a} --note-id <id>
 \`\`\`
 
 **Options:**
@@ -90,7 +94,7 @@ kontexted skill note-by-id --alias <profile> --note-id <id>
 - When you have a specific note ID and need its content
 - After finding a note via search or workspace tree exploration
 - When the user asks to read a specific note
-
+${hasWrite ? `
 ### Write Tools
 
 #### create-folder
@@ -98,7 +102,7 @@ kontexted skill note-by-id --alias <profile> --note-id <id>
 Create a new folder in the workspace. Optionally nest under a parent folder.
 
 \`\`\`bash
-kontexted skill create-folder --alias <profile> --name <name> --display-name "<displayName>" [--parent-id <parentPublicId>]
+kontexted skill create-folder --alias ${a} --name <name> --display-name "<displayName>" [--parent-id <parentPublicId>]
 \`\`\`
 
 **Options:**
@@ -123,7 +127,7 @@ kontexted skill create-folder --alias <profile> --name <name> --display-name "<d
 Create a new note in the workspace. Optionally place in a folder.
 
 \`\`\`bash
-kontexted skill create-note --alias <profile> --name <name> --title "<title>" [--folder-id <folderPublicId>] [--content "<content>"]
+kontexted skill create-note --alias ${a} --name <name> --title "<title>" [--folder-id <folderPublicId>] [--content "<content>"]
 \`\`\`
 
 **Options:**
@@ -149,7 +153,7 @@ kontexted skill create-note --alias <profile> --name <name> --title "<title>" [-
 Update the content of an existing note. This creates a revision for history.
 
 \`\`\`bash
-kontexted skill update-note-content --alias <profile> --note-id <notePublicId> --content "<content>"
+kontexted skill update-note-content --alias ${a} --note-id <notePublicId> --content "<content>"
 \`\`\`
 
 **Options:**
@@ -172,7 +176,7 @@ kontexted skill update-note-content --alias <profile> --note-id <notePublicId> -
 **Error cases:**
 - **"Note not found"** - Verify the note ID
 - **"Invalid note public ID"** - Check the ID format
-
+` : ''}
 ## Typical Workflow
 
 The skill commands work best when combined in a logical sequence:
@@ -182,7 +186,7 @@ The skill commands work best when combined in a logical sequence:
 1. **Explore** - Use \`workspace-tree\` to understand workspace structure
 2. **Search** - Use \`search-notes\` to find relevant notes by content
 3. **Read** - Use \`note-by-id\` to retrieve full content of specific notes
-
+${hasWrite ? `
 ### Write Workflow
 
 1. **Create structure** - Use \`create-folder\` to organize content
@@ -192,91 +196,76 @@ The skill commands work best when combined in a logical sequence:
 **Example write workflow:**
 \`\`\`bash
 # Create a folder for project documentation
-kontexted skill create-folder --alias work --name "project-docs" --display-name "Project Documentation"
+kontexted skill create-folder --alias ${a} --name "project-docs" --display-name "Project Documentation"
 
 # Create a note in that folder (use the returned publicId)
-kontexted skill create-note --alias work --name "requirements" --title "Requirements" --folder-id "FOLDER_PUBLIC_ID"
+kontexted skill create-note --alias ${a} --name "requirements" --title "Requirements" --folder-id "FOLDER_PUBLIC_ID"
 
 # Update the note content
-kontexted skill update-note-content --alias work --note-id "NOTE_PUBLIC_ID" --content "# Requirements\n\n- Feature A\n- Feature B"
+kontexted skill update-note-content --alias ${a} --note-id "NOTE_PUBLIC_ID" --content "# Requirements\n\n- Feature A\n- Feature B"
 \`\`\`
-
+` : ''}
 ## Example Usage
 
 ### Exploring a workspace
 
 \`\`\`bash
-# Get the complete structure of a personal workspace
-kontexted skill workspace-tree --alias personal
+kontexted skill workspace-tree --alias ${a}
 \`\`\`
 
 ### Searching for content
 
 \`\`\`bash
-# Find notes about meeting notes
-kontexted skill search-notes --alias work --query "meeting notes"
-
-# Limit results to 3 notes
-kontexted skill search-notes --alias work --query "todo" --limit 3
+kontexted skill search-notes --alias ${a} --query "meeting notes"
+kontexted skill search-notes --alias ${a} --query "todo" --limit 3
 \`\`\`
 
 ### Reading specific notes
 
 \`\`\`bash
-# Get content of a note when you have its ID
-kontexted skill note-by-id --alias work --note-id "note-uuid-123"
+kontexted skill note-by-id --alias ${a} --note-id "note-uuid-123"
 \`\`\`
-
+${hasWrite ? `
 ### Creating a folder structure
 
 \`\`\`bash
-# Create a root-level folder
-kontexted skill create-folder --alias work --name "meetings" --display-name "Meeting Notes"
-
-# Create a nested folder (use the returned publicId as parent-id)
-kontexted skill create-folder --alias work --name "2024" --display-name "2024 Meetings" --parent-id "PARENT_FOLDER_ID"
+kontexted skill create-folder --alias ${a} --name "meetings" --display-name "Meeting Notes"
+kontexted skill create-folder --alias ${a} --name "2024" --display-name "2024 Meetings" --parent-id "PARENT_FOLDER_ID"
 \`\`\`
 
 ### Creating and populating a note
 
 \`\`\`bash
-# Create a note with initial content
-kontexted skill create-note --alias work --name "todo" --title "Todo List" --content "# Todo\n\n- [ ] Task 1\n- [ ] Task 2"
-
-# Later, update the note content
-kontexted skill update-note-content --alias work --note-id "NOTE_ID" --content "# Todo\n\n- [x] Task 1\n- [ ] Task 2\n- [ ] Task 3"
+kontexted skill create-note --alias ${a} --name "todo" --title "Todo List" --content "# Todo\n\n- [ ] Task 1\n- [ ] Task 2"
+kontexted skill update-note-content --alias ${a} --note-id "NOTE_ID" --content "# Todo\n\n- [x] Task 1\n- [ ] Task 2\n- [ ] Task 3"
 \`\`\`
 
 ### Combining read and write operations
 
 \`\`\`bash
-# Task: Find a note and update it
-# Step 1: Search for the note
-kontexted skill search-notes --alias work --query "meeting notes"
-
-# Step 2: Update the found note
-kontexted skill update-note-content --alias work --note-id "FOUND_NOTE_ID" --content "Updated content here"
+kontexted skill search-notes --alias ${a} --query "meeting notes"
+kontexted skill update-note-content --alias ${a} --note-id "FOUND_NOTE_ID" --content "Updated content here"
 \`\`\`
-
+` : ''}
 ## Error Handling
 
 ### Authentication errors
 
-If you encounter authentication errors:
-
 1. **"Profile not found"** - The specified alias doesn't exist. Ask the user to run \`kontexted login --alias <profile>\` first.
-
-2. **"Not authenticated"** - The profile exists but isn't authenticated. Ask the user to re-authenticate with \`kontexted login --alias <profile>\`.
-
-3. **"No workspace configured"** - The profile is authenticated but has no workspace. Ask the user to set up a workspace with \`kontexted workspace set --alias <profile>\`.
-
+2. **"Not authenticated"** - The profile exists but isn't authenticated. Ask the user to re-authenticate.
+3. **"No workspace configured"** - The profile is authenticated but has no workspace. Ask the user to set up a workspace.
+${hasWrite ? `
 ### Write operation errors
 
-1. **"Write operations not enabled for this profile"** - Re-login with \`kontexted login --alias <alias> --write\` to enable write access
+1. **"Write operations not enabled for this profile"** - Re-login with \`kontexted login --alias ${a} --write\` to enable write access
 2. **"Folder with this name already exists"** - Use a unique name or check existing folders
 3. **"Note with this name already exists"** - Use a unique name or check existing notes
 4. **"Parent folder not found"** - Verify the parent folder ID exists
 5. **"Note not found"** - Verify the note ID is correct
+` : `
+### Write operation errors
+
+Write commands are not available for this profile. To enable write access, run \`kontexted login --alias <profile> --write\` and regenerate the skill.`}
 
 ### Other errors
 
@@ -284,8 +273,6 @@ If you encounter authentication errors:
 - **"Workspace not accessible"** - The workspace exists but the user lacks access permissions
 - **"Connection error"** - Network issues. Retry the command or check the user's connection
 
-When errors occur, report them clearly to the user so they can take appropriate action. The kontexted CLI handles most errors with descriptive messages.
-
 ## Output Format
 
 All commands return JSON output that is easy to parse:
@@ -294,12 +281,16 @@ All commands return JSON output that is easy to parse:
 - \`workspace-tree\`: Returns nested object with folders and notes
 - \`search-notes\`: Returns array of matching notes with ID, title, and snippets
 - \`note-by-id\`: Returns complete note object with body and metadata
-
+${hasWrite ? `
 ### Write commands
 - \`create-folder\`: Returns \`{ folder: { publicId, name, displayName, parentPublicId } }\`
 - \`create-note\`: Returns \`{ note: { publicId, name, title, folderPublicId, content } }\`
 - \`update-note-content\`: Returns \`{ note: { publicId, revisionId, updatedAt } }\`
-
-Use this structured output to provide clear responses to users about workspace contents and note information.
-`
+` : ''}
+`;
+}
+export const kontextedCliSkill = {
+    name: 'kontexted-cli',
+    description: 'Access and manage Kontexted workspaces, search notes, retrieve content, and create/update notes and folders through the kontexted CLI. Use when the user needs to explore workspace structure, find specific notes, read note content, or modify workspace content using profile aliases.',
+    content: generateKontextedCliContent,
 };

package/dist/skill-init/utils.d.ts

@@ -9,6 +9,10 @@ export interface InitSkillOptions {
     provider: SkillProvider;
     /** Base directory (defaults to current working directory) */
     basePath?: string;
+    /** Profile alias to embed in skill content */
+    alias?: string;
+    /** Whether the profile has write permissions */
+    hasWrite?: boolean;
 }
 /**
  * Result of initializing a skill

package/dist/skill-init/utils.js

@@ -81,9 +81,11 @@ export function validateSkill(skill, provider) {
     else if (skill.description.length < 1 || skill.description.length > 1024) {
         errors.push(`Skill description must be between 1 and 1024 characters (currently ${skill.description.length})`);
     }
-    // Validate content is not empty
-    if (!skill.content || skill.content.trim().length === 0) {
-        errors.push('Skill content is required and cannot be empty');
+    // Validate content is not empty (skip for generator functions)
+    if (typeof skill.content === 'string') {
+        if (!skill.content || skill.content.trim().length === 0) {
+            errors.push('Skill content is required and cannot be empty');
+        }
     }
     return errors;
 }
@@ -96,13 +98,21 @@ export function validateSkill(skill, provider) {
  * @throws Error if validation fails or if the skill cannot be written
  */
 export async function initSkill(options) {
-    const { skill, provider } = options;
+    const { skill, provider, alias, hasWrite = false } = options;
     const basePath = options.basePath || process.cwd();
     // Validate the skill definition
     const validationErrors = validateSkill(skill, provider);
     if (validationErrors.length > 0) {
         throw new Error(`Skill validation failed:\n${validationErrors.join('\n')}`);
     }
+    // Resolve content - handle both static string and generator function
+    let resolvedContent;
+    if (typeof skill.content === 'function') {
+        resolvedContent = skill.content({ alias, hasWrite });
+    }
+    else {
+        resolvedContent = skill.content;
+    }
     // Get the skill path from the provider
     const relativeSkillPath = provider.getSkillPath(skill.name);
     const absoluteSkillPath = path.isAbsolute(relativeSkillPath)
@@ -110,8 +120,8 @@ export async function initSkill(options) {
         : path.resolve(basePath, relativeSkillPath);
     // Check if file already exists
     const alreadyExists = await fileExists(absoluteSkillPath);
-    // Generate the skill content
-    const skillContent = provider.generateSkillContent(skill);
+    // Generate the skill content with resolved content and metadata
+    const skillContent = provider.generateSkillContent(skill, resolvedContent, { alias });
     // Write the skill file
     await writeFile(absoluteSkillPath, skillContent);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kontexted",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "CLI tool for Kontexted - MCP proxy, workspaces management, and local server",
   "type": "module",
   "bin": {
@@ -43,8 +43,8 @@
     "typescript": "^5.6.0"
   },
   "optionalDependencies": {
-    "@kontexted/darwin-arm64": "0.1.10",
-    "@kontexted/linux-x64": "0.1.10",
-    "@kontexted/windows-x64": "0.1.10"
+    "@kontexted/darwin-arm64": "0.1.12",
+    "@kontexted/linux-x64": "0.1.12",
+    "@kontexted/windows-x64": "0.1.12"
   }
 }