kontexted 0.1.5

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

@@ -0,0 +1,66 @@
+import type { SkillDefinition, SkillProvider } from '../skill-init/providers/base.js';
+/**
+ * Options for initializing a skill
+ */
+export interface InitSkillOptions {
+    /** The skill to initialize */
+    skill: SkillDefinition;
+    /** The provider to use */
+    provider: SkillProvider;
+    /** Base directory (defaults to current working directory) */
+    basePath?: string;
+}
+/**
+ * Result of initializing a skill
+ */
+export interface InitSkillResult {
+    /** Path where the skill was written */
+    path: string;
+    /** Whether the skill was newly created or overwritten */
+    created: boolean;
+    /** Name of the skill */
+    name: string;
+}
+/**
+ * Creates a directory (and parent directories) if it doesn't exist.
+ * Uses `fs/promises` with `mkdir` and `recursive: true`.
+ *
+ * @param dirPath - The directory path to ensure exists
+ * @returns Promise that resolves when the directory is ready
+ * @throws Error if the directory cannot be created
+ */
+export declare function ensureDirectory(dirPath: string): Promise<void>;
+/**
+ * Checks if a file exists at the given path.
+ *
+ * @param filePath - The file path to check
+ * @returns Promise that resolves to true if the file exists, false otherwise
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Writes content to a file, creating parent directories if needed.
+ *
+ * @param filePath - The path of the file to write
+ * @param content - The content to write to the file
+ * @returns Promise that resolves when the file has been written
+ * @throws Error if the file cannot be written
+ */
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+/**
+ * Validates a skill definition and returns an array of error messages.
+ * Returns an empty array if the skill is valid.
+ *
+ * @param skill - The skill definition to validate
+ * @param provider - The skill provider to use for name validation
+ * @returns Array of error messages (empty if valid)
+ */
+export declare function validateSkill(skill: SkillDefinition, provider: SkillProvider): string[];
+/**
+ * Initializes a skill by creating the necessary directory structure
+ * and writing the skill file.
+ *
+ * @param options - The options for initializing the skill
+ * @returns Promise that resolves to the initialization result
+ * @throws Error if validation fails or if the skill cannot be written
+ */
+export declare function initSkill(options: InitSkillOptions): Promise<InitSkillResult>;

package/dist/skill-init/utils.js

@@ -0,0 +1,122 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+/**
+ * Creates a directory (and parent directories) if it doesn't exist.
+ * Uses `fs/promises` with `mkdir` and `recursive: true`.
+ *
+ * @param dirPath - The directory path to ensure exists
+ * @returns Promise that resolves when the directory is ready
+ * @throws Error if the directory cannot be created
+ */
+export async function ensureDirectory(dirPath) {
+    try {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to create directory "${dirPath}": ${error.message}`);
+        }
+        throw new Error(`Failed to create directory "${dirPath}": Unknown error`);
+    }
+}
+/**
+ * Checks if a file exists at the given path.
+ *
+ * @param filePath - The file path to check
+ * @returns Promise that resolves to true if the file exists, false otherwise
+ */
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Writes content to a file, creating parent directories if needed.
+ *
+ * @param filePath - The path of the file to write
+ * @param content - The content to write to the file
+ * @returns Promise that resolves when the file has been written
+ * @throws Error if the file cannot be written
+ */
+export async function writeFile(filePath, content) {
+    const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
+    const dirPath = path.dirname(absolutePath);
+    // Ensure parent directory exists
+    await ensureDirectory(dirPath);
+    try {
+        await fs.writeFile(absolutePath, content, 'utf-8');
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to write file "${absolutePath}": ${error.message}`);
+        }
+        throw new Error(`Failed to write file "${absolutePath}": Unknown error`);
+    }
+}
+/**
+ * Validates a skill definition and returns an array of error messages.
+ * Returns an empty array if the skill is valid.
+ *
+ * @param skill - The skill definition to validate
+ * @param provider - The skill provider to use for name validation
+ * @returns Array of error messages (empty if valid)
+ */
+export function validateSkill(skill, provider) {
+    const errors = [];
+    // Validate skill name using provider rules
+    if (!skill.name || skill.name.trim().length === 0) {
+        errors.push('Skill name is required');
+    }
+    else if (!provider.validateSkillName(skill.name)) {
+        errors.push(`Invalid skill name "${skill.name}". Names must match provider rules (lowercase alphanumeric with hyphens).`);
+    }
+    // Validate description length
+    if (!skill.description || skill.description.trim().length === 0) {
+        errors.push('Skill description is required');
+    }
+    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');
+    }
+    return errors;
+}
+/**
+ * Initializes a skill by creating the necessary directory structure
+ * and writing the skill file.
+ *
+ * @param options - The options for initializing the skill
+ * @returns Promise that resolves to the initialization result
+ * @throws Error if validation fails or if the skill cannot be written
+ */
+export async function initSkill(options) {
+    const { skill, provider } = 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')}`);
+    }
+    // Get the skill path from the provider
+    const relativeSkillPath = provider.getSkillPath(skill.name);
+    const absoluteSkillPath = path.isAbsolute(relativeSkillPath)
+        ? relativeSkillPath
+        : path.resolve(basePath, relativeSkillPath);
+    // Check if file already exists
+    const alreadyExists = await fileExists(absoluteSkillPath);
+    // Generate the skill content
+    const skillContent = provider.generateSkillContent(skill);
+    // Write the skill file
+    await writeFile(absoluteSkillPath, skillContent);
+    return {
+        path: absoluteSkillPath,
+        created: !alreadyExists,
+        name: skill.name,
+    };
+}

package/dist/types/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Type definitions for Kontexted CLI
+ */
+/** OAuth token data */
+export interface OAuthTokens {
+    access_token: string;
+    token_type: string;
+    refresh_token?: string;
+    expires_in?: number;
+    expires_at?: number;
+    scope?: string;
+    id_token?: string;
+}
+/** OAuth client information - matches SDK's OAuthClientInformationMixed */
+export interface OAuthClientInfo {
+    client_id: string;
+    client_secret?: string;
+    client_id_issued_at?: number;
+    client_secret_expires_at?: number;
+    redirect_uris?: URL[];
+    token_endpoint_auth_method?: string;
+    grant_types?: string[];
+    response_types?: string[];
+    client_name?: string;
+    client_uri?: URL;
+    logo_uri?: string;
+    scope?: string;
+    contacts?: string[];
+    tos_uri?: string;
+    policy_uri?: string;
+    jwks_uri?: URL;
+    jwks?: unknown;
+    software_id?: string;
+    software_version?: string;
+    software_statement?: string;
+}
+/** OAuth state stored in profile */
+export interface OAuthState {
+    clientInformation?: OAuthClientInfo;
+    tokens?: OAuthTokens;
+    codeVerifier?: string;
+    redirectUrl?: string;
+    clientMetadata?: Record<string, unknown>;
+    serverUrl?: string;
+}
+/** Stored profile configuration */
+export interface Profile {
+    serverUrl: string;
+    workspace: string;
+    write: boolean;
+    oauth: OAuthState;
+}
+/** Configuration file structure */
+export interface Config {
+    profiles: Record<string, Profile>;
+}
+/** MCP Tool from server */
+export interface McpTool {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+/** MCP Tool list response */
+export interface McpToolList {
+    tools: McpTool[];
+}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+/**
+ * Type definitions for Kontexted CLI
+ */
+export {};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "kontexted",
+  "version": "0.1.5",
+  "description": "CLI tool for Kontexted - MCP proxy, workspaces management, and local server",
+  "type": "module",
+  "bin": {
+    "kontexted": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f && node -e \"const fs=require('fs'),path=require('path');const src='dist/index.js';const content=fs.readFileSync(src,'utf8');fs.writeFileSync(src,'#!/usr/bin/env node\\n'+content);fs.chmodSync(src,0o755);console.log('Added shebang and set executable');\"",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "kontexted",
+    "mcp",
+    "cli",
+    "notes",
+    "workspace"
+  ],
+  "author": "Kontexted",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "commander": "^12.1.0",
+    "yargs": "^17.7.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/yargs": "^17.0.35",
+    "tsc-alias": "^1.8.10",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.0"
+  },
+  "optionalDependencies": {
+    "@kontexted/darwin-arm64": "0.1.5",
+    "@kontexted/linux-x64": "0.1.5",
+    "@kontexted/windows-x64": "0.1.5"
+  }
+}