capman 0.1.0

package/dist/generator.js

@@ -0,0 +1,224 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate = generate;
+exports.loadConfig = loadConfig;
+exports.writeManifest = writeManifest;
+exports.readManifest = readManifest;
+exports.validate = validate;
+exports.generateStarterConfig = generateStarterConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const schema_1 = require("./schema");
+const logger_1 = require("./logger");
+function generate(config) {
+    return {
+        version: require('../package.json').version,
+        app: config.app,
+        generatedAt: new Date().toISOString(),
+        capabilities: config.capabilities,
+    };
+}
+function loadConfig(configPath) {
+    const candidates = configPath
+        ? [configPath]
+        : ['capman.config.js', 'capman.config.json'];
+    // If a specific path was given but doesn't exist — clear error
+    if (configPath) {
+        const resolved = path.resolve(process.cwd(), configPath);
+        if (!fs.existsSync(resolved)) {
+            throw new Error(`Config file not found at: ${resolved}\n` +
+                `Check the path and try again.`);
+        }
+    }
+    for (const candidate of candidates) {
+        const resolved = path.resolve(process.cwd(), candidate);
+        if (fs.existsSync(resolved)) {
+            let raw;
+            // Catch syntax errors in config file
+            try {
+                const mod = require(resolved);
+                raw = mod.default ?? mod;
+            }
+            catch (err) {
+                throw new Error(`Failed to load config at ${resolved}:\n` +
+                    `  ${err instanceof Error ? err.message : String(err)}\n\n` +
+                    `Check your config file for syntax errors.`);
+            }
+            // Catch invalid config structure
+            const check = (0, schema_1.validateConfig)(raw);
+            if (!check.valid) {
+                throw new Error(`Invalid capman config at ${resolved}:\n` +
+                    check.errors.map(e => `  • ${e}`).join('\n') + '\n\n' +
+                    `Run: node bin/capman.js init  to see a valid example config.`);
+            }
+            return raw;
+        }
+    }
+    // No config found at all
+    throw new Error(`No capman config file found.\n\n` +
+        `Expected one of:\n` +
+        candidates.map(c => `  • ${c}`).join('\n') + '\n\n' +
+        `Run: node bin/capman.js init  to create one.`);
+}
+function writeManifest(manifest, outputPath = 'manifest.json') {
+    const resolved = path.resolve(process.cwd(), outputPath);
+    fs.writeFileSync(resolved, JSON.stringify(manifest, null, 2));
+    return resolved;
+}
+function readManifest(manifestPath = 'manifest.json') {
+    const resolved = path.resolve(process.cwd(), manifestPath);
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`No manifest found at ${resolved}. Run: node bin/capman.js generate`);
+    }
+    const raw = JSON.parse(fs.readFileSync(resolved, 'utf-8'));
+    const check = (0, schema_1.validateManifest)(raw);
+    if (!check.valid) {
+        throw new Error(`Invalid manifest at ${resolved}:\n` +
+            check.errors.map(e => `  • ${e}`).join('\n'));
+    }
+    return raw;
+}
+function validate(manifest) {
+    const errors = [];
+    const warnings = [];
+    // Delegate error checking to Zod
+    const zodResult = (0, schema_1.validateManifest)(manifest);
+    errors.push(...zodResult.errors);
+    // Warnings that Zod doesn't cover
+    for (const cap of manifest.capabilities ?? []) {
+        if (!cap.examples?.length) {
+            const msg = `Capability "${cap.id}" has no examples — adding examples improves matching`;
+            warnings.push(msg);
+            logger_1.logger.warn(msg);
+        }
+        if (!cap.returns?.length) {
+            const msg = `Capability "${cap.id}" has no "returns" declaration`;
+            warnings.push(msg);
+            logger_1.logger.warn(msg);
+        }
+    }
+    if (errors.length > 0) {
+        logger_1.logger.error(`Manifest validation failed — ${errors.length} error(s)`);
+        errors.forEach(e => logger_1.logger.error(e));
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function generateStarterConfig() {
+    return `// capman.config.js 
+// Define what your app can do for AI agents.
+// Replace the examples below with your own app's capabilities.
+
+module.exports = {
+  app: 'your-app-name',
+  baseUrl: 'https://api.your-app.com',
+
+  capabilities: [
+    {
+      id: 'get_resource',
+      name: 'Get a resource',
+      description: 'Fetch a specific resource by name, ID, or filter from the app.',
+      examples: [
+        'Show me the resource details',
+        'Find resource by ID',
+        'Look up resource by name',
+      ],
+      params: [
+        {
+          name: 'resource_id',
+          description: 'The ID or name of the resource to fetch',
+          required: true,
+          source: 'user_query',
+        },
+      ],
+      returns: ['resource', 'metadata'],
+      resolver: {
+        type: 'api',
+        endpoints: [{ method: 'GET', path: '/resources/{resource_id}' }],
+      },
+      privacy: { level: 'public', note: 'No auth required' },
+    },
+
+    {
+      id: 'navigate_to_screen',
+      name: 'Navigate to a screen',
+      description: 'Route the user to a specific page or section in the app.',
+      examples: [
+        'Take me to the dashboard',
+        'Open settings',
+        'Go to my profile',
+      ],
+      params: [
+        {
+          name: 'destination',
+          description: 'The screen or page to navigate to',
+          required: true,
+          source: 'user_query',
+        },
+      ],
+      returns: ['deep_link'],
+      resolver: { type: 'nav', destination: '{destination}' },
+      privacy: { level: 'public' },
+    },
+
+    {
+      id: 'get_user_data',
+      name: 'Get user data',
+      description: 'Retrieve data belonging to the currently authenticated user.',
+      examples: [
+        'Show my account details',
+        'What is my current plan?',
+        'Show my recent activity',
+      ],
+      params: [
+        {
+          name: 'user_id',
+          description: 'Current user ID',
+          required: true,
+          source: 'session',
+        },
+      ],
+      returns: ['user_data'],
+      resolver: {
+        type: 'api',
+        endpoints: [{ method: 'GET', path: '/users/{user_id}' }],
+      },
+      privacy: { level: 'user_owned', note: 'Requires auth — scoped to current user only' },
+    },
+  ],
+}
+`;
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,4BAOC;AAED,gCAsDC;AAED,sCAIC;AAED,oCAgBC;AAED,4BA4BC;AACD,sDAoFC;AAhND,uCAAwB;AACxB,2CAA4B;AAE5B,qCAA2D;AAC3D,qCAAiC;AAEjC,SAAgB,QAAQ,CAAC,MAAoB;IAC3C,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO;QAC3C,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAA;AACH,CAAC;AAED,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,CAAC,UAAU,CAAC;QACd,CAAC,CAAC,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAA;IAE9C,+DAA+D;IAC/D,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAA;QACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,IAAI;gBACzC,+BAA+B,CAChC,CAAA;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAA;QACvD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,GAAY,CAAA;YAEhB,qCAAqC;YACrC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;gBAC7B,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAA;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,KAAK;oBACzC,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM;oBAC3D,2CAA2C,CAC5C,CAAA;YACH,CAAC;YAED,iCAAiC;YACjC,MAAM,KAAK,GAAG,IAAA,uBAAc,EAAC,GAAG,CAAC,CAAA;YACjC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,KAAK;oBACzC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM;oBACrD,8DAA8D,CAC/D,CAAA;YACH,CAAC;YAED,OAAO,GAAmB,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,IAAI,KAAK,CACb,kCAAkC;QAClC,oBAAoB;QACpB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM;QACnD,8CAA8C,CAC/C,CAAA;AACH,CAAC;AAED,SAAgB,aAAa,CAAC,QAAkB,EAAE,UAAU,GAAG,eAAe;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAA;IACxD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAC7D,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAgB,YAAY,CAAC,YAAY,GAAG,eAAe;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAA;IAC1D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,oCAAoC,CAAC,CAAA;IACvF,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IAE1D,MAAM,KAAK,GAAG,IAAA,yBAAgB,EAAC,GAAG,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,KAAK;YACpC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7C,CAAA;IACH,CAAC;IAED,OAAO,GAAe,CAAA;AACxB,CAAC;AAED,SAAgB,QAAQ,CAAC,QAAkB;IACzC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,iCAAiC;IACjC,MAAM,SAAS,GAAG,IAAA,yBAAgB,EAAC,QAAQ,CAAC,CAAA;IAC5C,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAEhC,kCAAkC;IAClC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,eAAe,GAAG,CAAC,EAAE,uDAAuD,CAAA;YACxF,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAClB,eAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,eAAe,GAAG,CAAC,EAAE,gCAAgC,CAAA;YACjE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAClB,eAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClB,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,eAAM,CAAC,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,WAAW,CAAC,CAAA;QACtE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,eAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACtC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AACzD,CAAC;AACD,SAAgB,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFR,CAAA;AACD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+export { setLogLevel } from './logger';
+export type { LogLevel } from './logger';
+export type { Capability, CapabilityParam, CapmanConfig, Manifest, MatchResult, ResolveResult, ValidationResult, Resolver, ApiResolver, NavResolver, HybridResolver, PrivacyScope, ResolverType, HttpMethod, } from './types';
+export { generate, loadConfig, writeManifest, readManifest, validate, generateStarterConfig, } from './generator';
+export { match, matchWithLLM, } from './matcher';
+export type { LLMMatcherOptions } from './matcher';
+export { resolve } from './resolver';
+export type { ResolveOptions, AuthContext } from './resolver';
+import type { Manifest, MatchResult, ResolveResult } from './types';
+import type { LLMMatcherOptions } from './matcher';
+import type { ResolveOptions } from './resolver';
+export interface AskOptions extends ResolveOptions {
+    llm?: LLMMatcherOptions['llm'];
+}
+export interface AskResult {
+    match: MatchResult;
+    resolution: ResolveResult;
+}
+/**
+ * One-shot convenience: match + resolve in a single call.
+ *
+ * @example
+ * const result = await ask("show me the dashboard", manifest, {
+ *   baseUrl: 'https://api.your-app.com',
+ * })
+ */
+export declare function ask(query: string, manifest: Manifest, options?: AskOptions): Promise<AskResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,YAAY,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,KAAK,EACL,YAAY,GACb,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAM7D,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,GAAG,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,WAAW,CAAA;IAClB,UAAU,EAAE,aAAa,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,GAAG,CACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CAmBpB"}

package/dist/index.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolve = exports.matchWithLLM = exports.match = exports.generateStarterConfig = exports.validate = exports.readManifest = exports.writeManifest = exports.loadConfig = exports.generate = exports.setLogLevel = void 0;
+exports.ask = ask;
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "setLogLevel", { enumerable: true, get: function () { return logger_1.setLogLevel; } });
+var generator_1 = require("./generator");
+Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return generator_1.generate; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return generator_1.loadConfig; } });
+Object.defineProperty(exports, "writeManifest", { enumerable: true, get: function () { return generator_1.writeManifest; } });
+Object.defineProperty(exports, "readManifest", { enumerable: true, get: function () { return generator_1.readManifest; } });
+Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return generator_1.validate; } });
+Object.defineProperty(exports, "generateStarterConfig", { enumerable: true, get: function () { return generator_1.generateStarterConfig; } });
+var matcher_1 = require("./matcher");
+Object.defineProperty(exports, "match", { enumerable: true, get: function () { return matcher_1.match; } });
+Object.defineProperty(exports, "matchWithLLM", { enumerable: true, get: function () { return matcher_1.matchWithLLM; } });
+var resolver_1 = require("./resolver");
+Object.defineProperty(exports, "resolve", { enumerable: true, get: function () { return resolver_1.resolve; } });
+// ─── Convenience: ask() — match + resolve in one call ────────────────────────
+const matcher_2 = require("./matcher");
+const resolver_2 = require("./resolver");
+/**
+ * One-shot convenience: match + resolve in a single call.
+ *
+ * @example
+ * const result = await ask("show me the dashboard", manifest, {
+ *   baseUrl: 'https://api.your-app.com',
+ * })
+ */
+async function ask(query, manifest, options = {}) {
+    const { llm, ...resolveOptions } = options;
+    // Tier 1 — try keyword matcher first (fast, no API call)
+    const keywordResult = (0, matcher_2.match)(query, manifest);
+    // If confident enough, use it directly
+    const THRESHOLD = 50;
+    const matchResult = (keywordResult.confidence >= THRESHOLD || !llm)
+        ? keywordResult
+        : await (0, matcher_2.matchWithLLM)(query, manifest, { llm });
+    const resolution = await (0, resolver_2.resolve)(matchResult, matchResult.extractedParams, resolveOptions);
+    return { match: matchResult, resolution };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA+DA,kBAuBC;AAtFD,mCAAsC;AAA7B,qGAAA,WAAW,OAAA;AAoBpB,yCAOoB;AANlB,qGAAA,QAAQ,OAAA;AACR,uGAAA,UAAU,OAAA;AACV,0GAAA,aAAa,OAAA;AACb,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,kHAAA,qBAAqB,OAAA;AAGvB,qCAGkB;AAFhB,gGAAA,KAAK,OAAA;AACL,uGAAA,YAAY,OAAA;AAId,uCAAoC;AAA3B,mGAAA,OAAO,OAAA;AAGhB,gFAAgF;AAEhF,uCAA0E;AAC1E,yCAAgD;AAchD;;;;;;;GAOG;AACI,KAAK,UAAU,GAAG,CACvB,KAAa,EACb,QAAkB,EAClB,UAAsB,EAAE;IAExB,MAAM,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAA;IAE1C,yDAAyD;IACzD,MAAM,aAAa,GAAG,IAAA,eAAM,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAE7C,uCAAuC;IACvC,MAAM,SAAS,GAAG,EAAE,CAAA;IACpB,MAAM,WAAW,GAAG,CAAC,aAAa,CAAC,UAAU,IAAI,SAAS,IAAI,CAAC,GAAG,CAAC;QACjE,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,MAAM,IAAA,sBAAa,EAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IAEjD,MAAM,UAAU,GAAG,MAAM,IAAA,kBAAQ,EAC/B,WAAW,EACX,WAAW,CAAC,eAA0C,EACtD,cAAc,CACf,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;AAC3C,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,22 @@
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+export declare class Logger {
+    private level;
+    constructor(level?: LogLevel);
+    setLevel(level: LogLevel): void;
+    error(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    info(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+}
+export declare const logger: Logger;
+/**
+ * Set the global log level for capman.
+ *
+ * @example
+ * import { setLogLevel } from 'capman'
+ * setLogLevel('debug') // see everything
+ * setLogLevel('info')  // see key steps
+ * setLogLevel('silent') // no output (default)
+ */
+export declare function setLogLevel(level: LogLevel): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAYrE,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAQ;gBAET,KAAK,GAAE,QAAmB;IAItC,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAIxB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAKrC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAKpC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAKpC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;CAItC;AAID,eAAO,MAAM,MAAM,QAAuB,CAAA;AAE1C;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,QAE1C"}

package/dist/logger.js

@@ -0,0 +1,53 @@
+"use strict";
+// ─── Log levels ───────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+exports.setLogLevel = setLogLevel;
+const LEVELS = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+// ─── Logger ───────────────────────────────────────────────────────────────────
+class Logger {
+    constructor(level = 'silent') {
+        this.level = LEVELS[level];
+    }
+    setLevel(level) {
+        this.level = LEVELS[level];
+    }
+    error(msg, ...args) {
+        if (this.level >= LEVELS.error)
+            console.error(`[capman:error] ${msg}`, ...args);
+    }
+    warn(msg, ...args) {
+        if (this.level >= LEVELS.warn)
+            console.warn(`[capman:warn] ${msg}`, ...args);
+    }
+    info(msg, ...args) {
+        if (this.level >= LEVELS.info)
+            console.log(`[capman:info] ${msg}`, ...args);
+    }
+    debug(msg, ...args) {
+        if (this.level >= LEVELS.debug)
+            console.log(`[capman:debug] ${msg}`, ...args);
+    }
+}
+exports.Logger = Logger;
+// ─── Global logger instance ───────────────────────────────────────────────────
+exports.logger = new Logger('silent');
+/**
+ * Set the global log level for capman.
+ *
+ * @example
+ * import { setLogLevel } from 'capman'
+ * setLogLevel('debug') // see everything
+ * setLogLevel('info')  // see key steps
+ * setLogLevel('silent') // no output (default)
+ */
+function setLogLevel(level) {
+    exports.logger.setLevel(level);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA,iFAAiF;;;AA2DjF,kCAEC;AAzDD,MAAM,MAAM,GAA6B;IACvC,MAAM,EAAE,CAAC;IACT,KAAK,EAAG,CAAC;IACT,IAAI,EAAI,CAAC;IACT,IAAI,EAAI,CAAC;IACT,KAAK,EAAG,CAAC;CACV,CAAA;AAED,iFAAiF;AAEjF,MAAa,MAAM;IAGjB,YAAY,QAAkB,QAAQ;QACpC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC;IAED,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,GAAG,IAAe;QACnC,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;YAC5B,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAA;IACnD,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,GAAG,IAAe;QAClC,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI;YAC3B,OAAO,CAAC,IAAI,CAAC,iBAAiB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,GAAG,IAAe;QAClC,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI;YAC3B,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,GAAG,IAAe;QACnC,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;YAC5B,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAA;IACjD,CAAC;CACF;AA9BD,wBA8BC;AAED,iFAAiF;AAEpE,QAAA,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAA;AAE1C;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,KAAe;IACzC,cAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC"}

package/dist/matcher.d.ts

@@ -0,0 +1,7 @@
+import type { Manifest, MatchResult } from './types';
+export declare function match(query: string, manifest: Manifest): MatchResult;
+export interface LLMMatcherOptions {
+    llm: (prompt: string) => Promise<string>;
+}
+export declare function matchWithLLM(query: string, manifest: Manifest, options: LLMMatcherOptions): Promise<MatchResult>;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AA+HhE,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAiDpE;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACzC;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA8CtB"}

package/dist/matcher.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.match = match;
+exports.matchWithLLM = matchWithLLM;
+const logger_1 = require("./logger");
+const STOPWORDS = new Set([
+    'show', 'me', 'the', 'get', 'find', 'fetch', 'give', 'please',
+    'can', 'you', 'i', 'want', 'to', 'a', 'an', 'my', 'our', 'your',
+    'what', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would',
+    'could', 'should', 'may', 'might', 'shall', 'and', 'or', 'but',
+    'in', 'on', 'at', 'by', 'for', 'with', 'about', 'into', 'through',
+    'of', 'from', 'up', 'out', 'that', 'this', 'these', 'those',
+    'it', 'its', 'how', 'when', 'where', 'who', 'which', 'all',
+    'just', 'some', 'any', 'there', 'their', 'them', 'they',
+]);
+function filterStopwords(words) {
+    return words.filter(w => !STOPWORDS.has(w.toLowerCase()) && w.length > 1);
+}
+function scoreCapability(query, cap) {
+    const q = query.toLowerCase();
+    let score = 0;
+    const qWords = filterStopwords(q.split(/\W+/).filter(Boolean));
+    // Check examples — exact substring match is a strong signal
+    for (const example of cap.examples ?? []) {
+        const exWords = filterStopwords(example.toLowerCase().split(/\s+/));
+        if (exWords.length === 0)
+            continue;
+        const overlap = exWords.filter(w => qWords.includes(w)).length;
+        score += (overlap / exWords.length) * 60;
+    }
+    // Check description words
+    const descWords = filterStopwords(cap.description.toLowerCase().split(/\W+/).filter(Boolean));
+    if (descWords.length > 0) {
+        const descOverlap = descWords.filter(w => qWords.includes(w)).length;
+        score += (descOverlap / descWords.length) * 30;
+    }
+    // Check name words
+    const nameWords = filterStopwords(cap.name.toLowerCase().split(/\W+/).filter(Boolean));
+    if (nameWords.length > 0) {
+        const nameOverlap = nameWords.filter(w => qWords.includes(w)).length;
+        score += (nameOverlap / nameWords.length) * 10;
+    }
+    return Math.min(Math.round(score), 100);
+}
+function resolverToIntent(cap) {
+    const t = cap.resolver.type;
+    if (t === 'api')
+        return 'retrieval';
+    if (t === 'nav')
+        return 'navigation';
+    if (t === 'hybrid')
+        return 'hybrid';
+    return 'out_of_scope';
+}
+/**
+ * Extracts parameter values from a user query using keyword heuristics.
+ *
+ * Known limits:
+ * - Extracts single tokens only — "jane smith" would extract "jane"
+ * - Keyword matching is positional — "articles from authors I follow"
+ *   may extract "authors" instead of nothing, since "from" is a keyword
+ * - For complex or ambiguous queries, use matchWithLLM() which handles
+ *   param extraction more accurately via the LLM prompt
+ */
+function extractParams(query, cap) {
+    const result = {};
+    const q = query.toLowerCase();
+    for (const param of cap.params) {
+        // Session params come from auth context, not query
+        if (param.source === 'session') {
+            result[param.name] = '[from_session]';
+            continue;
+        }
+        if (param.source !== 'user_query') {
+            result[param.name] = null;
+            continue;
+        }
+        // Try to extract value after known keywords
+        // e.g. "profile for johndoe" → johndoe
+        //      "articles by jane"   → jane
+        //      "tag javascript"     → javascript
+        const keywords = [
+            `for `, `by `, `about `, `named `, `called `,
+            `tag `, `user `, `author `, `slug `, `id `,
+            `to `, `from `, `with `,
+        ];
+        let extracted = null;
+        for (const kw of keywords) {
+            const idx = q.indexOf(kw);
+            if (idx !== -1) {
+                const after = query.slice(idx + kw.length).trim();
+                const token = after.split(/\s+/)[0];
+                if (token && token.length > 1) {
+                    extracted = token.replace(/[^a-zA-Z0-9-_@.]/g, '');
+                    break;
+                }
+            }
+        }
+        // Fallback — grab last meaningful word in the query
+        if (!extracted) {
+            const words = query.trim().split(/\s+/);
+            const meaningful = words.filter(w => !STOPWORDS.has(w.toLowerCase()));
+            extracted = meaningful[meaningful.length - 1] ?? null;
+        }
+        result[param.name] = extracted;
+    }
+    return result;
+}
+function match(query, manifest) {
+    if (!query?.trim()) {
+        logger_1.logger.warn('Empty query received');
+        return {
+            capability: null,
+            confidence: 0,
+            intent: 'out_of_scope',
+            extractedParams: {},
+            reasoning: 'Empty query',
+        };
+    }
+    logger_1.logger.info(`Matching query: "${query}"`);
+    logger_1.logger.debug(`Manifest has ${manifest.capabilities.length} capabilities`);
+    let best = null;
+    let bestScore = 0;
+    for (const cap of manifest.capabilities) {
+        const score = scoreCapability(query, cap);
+        logger_1.logger.debug(`  scored "${cap.id}": ${score}%`);
+        if (score > bestScore) {
+            bestScore = score;
+            best = cap;
+        }
+    }
+    if (!best || bestScore < 50) {
+        logger_1.logger.info(`No match above threshold (best: ${bestScore}% for "${best?.id ?? 'none'}")`);
+        return {
+            capability: null,
+            confidence: bestScore,
+            intent: 'out_of_scope',
+            extractedParams: {},
+            reasoning: `No capability matched with sufficient confidence (best score: ${bestScore})`,
+        };
+    }
+    const params = extractParams(query, best);
+    logger_1.logger.info(`Matched "${best.id}" at ${bestScore}% confidence`);
+    logger_1.logger.debug(`Extracted params: ${JSON.stringify(params)}`);
+    return {
+        capability: best,
+        confidence: bestScore,
+        intent: resolverToIntent(best),
+        extractedParams: params,
+        reasoning: `Matched "${best.id}" via keyword scoring (score: ${bestScore})`,
+    };
+}
+async function matchWithLLM(query, manifest, options) {
+    const manifestSummary = manifest.capabilities.map(c => `- ${c.id} (${c.resolver.type}): ${c.description}${c.examples?.length ? `\n  examples: ${c.examples.slice(0, 2).join(', ')}` : ''}`).join('\n');
+    const prompt = `You are an intent matcher for an AI agent system.
+
+App: ${manifest.app}
+
+Available capabilities:
+${manifestSummary}
+
+User query: "${query}"
+
+Respond ONLY in valid JSON (no markdown):
+{
+  "matched_capability": "<capability_id or OUT_OF_SCOPE>",
+  "confidence": <0-100>,
+  "intent": "<navigation|retrieval|hybrid|out_of_scope>",
+  "reasoning": "<one sentence>",
+  "extracted_params": { "<param_name>": "<value or null>" }
+}`;
+    try {
+        const raw = await options.llm(prompt);
+        const clean = raw.replace(/```json|```/g, '').trim();
+        const parsed = JSON.parse(clean);
+        const isOOS = parsed.matched_capability === 'OUT_OF_SCOPE';
+        const capability = isOOS
+            ? null
+            : manifest.capabilities.find(c => c.id === parsed.matched_capability) ?? null;
+        return {
+            capability,
+            confidence: parsed.confidence,
+            intent: isOOS ? 'out_of_scope' : parsed.intent,
+            extractedParams: parsed.extracted_params ?? {},
+            reasoning: parsed.reasoning,
+        };
+    }
+    catch (err) {
+        logger_1.logger.warn(`LLM match failed, falling back to keyword matcher: ${err}`);
+        return match(query, manifest);
+    }
+}
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"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"}

package/dist/resolver.d.ts

@@ -0,0 +1,19 @@
+import type { MatchResult, ResolveResult } from './types';
+export interface AuthContext {
+    /** Whether the current request is authenticated */
+    isAuthenticated: boolean;
+    /** Current user's role */
+    role?: 'user' | 'admin';
+    /** Current user's ID — injected into session params */
+    userId?: string;
+}
+export interface ResolveOptions {
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    dryRun?: boolean;
+    headers?: Record<string, string>;
+    /** Auth context — required for user_owned and admin capabilities */
+    auth?: AuthContext;
+}
+export declare function resolve(matchResult: MatchResult, params?: Record<string, unknown>, options?: ResolveOptions): Promise<ResolveResult>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAA4B,MAAM,SAAS,CAAA;AAKnF,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,eAAe,EAAE,OAAO,CAAA;IACxB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,oEAAoE;IACpE,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AA+BD,wBAAsB,OAAO,CAC3B,WAAW,EAAE,WAAW,EACxB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAwExB"}