@notis_ai/cli 0.2.0-beta.122.1 → 0.2.0-beta.124.1

package/dist/scaffolds.json

@@ -1,5 +1,5 @@
 {
-  "source": "apps/*/notis.config.ts",
+  "source": "scaffolds/*/notis.config.ts",
   "scaffolds": [
     {
       "slug": "notis-database",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@notis_ai/cli",
-  "version": "0.2.0-beta.122.1",
+  "version": "0.2.0-beta.124.1",
   "description": "Agent-first Notis CLI for apps and generic tool execution",
   "type": "module",
   "bin": {

package/skills/notis-cli/SKILL.md

@@ -134,13 +134,13 @@ This is the main escape hatch for:
 ### Tool access workflow
 
 1. List available toolkit namespaces:
-   - `npx --package @notis_ai/cli@latest -- notis tools toolkits`
+   - `npx --package @notis_ai/cli@latest -- notis tools toolkits --timeout-ms 90000`
 2. Search for the capability you need using natural language:
-   - `npx --package @notis_ai/cli@latest -- notis tools search "<query>"`
+   - `npx --package @notis_ai/cli@latest -- notis tools search "<query>" --timeout-ms 90000`
    - optionally add known field hints with `--known-fields "<key:value>"`
 3. If needed, inspect the exact tool and parameter schema:
-   - `npx --package @notis_ai/cli@latest -- notis tools describe <tool-name>`
-   - `npx --package @notis_ai/cli@latest -- notis tools exec <tool-name> --get-schema`
+   - `npx --package @notis_ai/cli@latest -- notis tools describe <tool-name> --timeout-ms 90000`
+   - `npx --package @notis_ai/cli@latest -- notis tools exec <tool-name> --get-schema --timeout-ms 90000`
 4. Validate arguments before execution when the tool is mutating or the schema is non-trivial:
    - `npx --package @notis_ai/cli@latest -- notis tools exec <tool-name> --dry-run --arguments '<json>'`
 5. Execute the tool:
@@ -151,6 +151,22 @@ This is the main escape hatch for:
    - `npx --package @notis_ai/cli@latest -- notis tools link <toolkit>`
    - For a revoked or invalid credential-based connection, reconnect with credential JSON on stdin: `npx --package @notis_ai/cli@latest -- notis tools link <toolkit> --reconnect --credentials -`
 
+### Discovery latency and caching
+
+The discovery bridge may query several connected MCP servers on a cold run and
+can legitimately take longer than the CLI's general 30-second timeout. Always
+use `--timeout-ms 90000` for `tools toolkits`, `tools search`, `tools describe`,
+and schema-only discovery calls. If a discovery call returns `network_timeout`,
+retry that same command once with `--timeout-ms 90000`; do not start a new
+query, invent a tool name, or loop on the default 30-second command.
+
+Discovery is idempotent but should be bounded: run the toolkit listing once per
+task, run one natural-language search per distinct capability, and cache the
+returned canonical tool names and schemas for the rest of the current turn.
+After a successful search/schema response, call the returned canonical tool
+directly (with a dry-run before mutations) instead of repeating the same
+discovery request before every connected-service action.
+
 ### Tool access rules
 
 - Never guess tool names. Discover them with `npx --package @notis_ai/cli@latest -- notis tools search` first.

package/src/runtime/app-platform.js

@@ -24,7 +24,7 @@ const BUNDLE_DIR = join(OUTPUT_DIR, 'bundle');
 const MANIFEST_FILE = join(OUTPUT_DIR, 'manifest.json');
 const METADATA_DIR = 'metadata';
 const CLI_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
-const MONOREPO_APPS_DIR = resolve(CLI_ROOT, '../..', 'apps');
+const MONOREPO_SCAFFOLDS_DIR = resolve(CLI_ROOT, '../..', 'scaffolds');
 const DIST_DIR = join(CLI_ROOT, 'dist');
 const SCAFFOLD_CATALOG_FILE = join(DIST_DIR, 'scaffolds.json');
 const SCAFFOLD_SOURCE_DIR = join(DIST_DIR, 'scaffolds');
@@ -1075,7 +1075,7 @@ function resolveScaffoldSourceDir(fromSlug) {
   if (existsSync(bundledDir)) {
     return bundledDir;
   }
-  const monorepoDir = join(MONOREPO_APPS_DIR, fromSlug);
+  const monorepoDir = join(MONOREPO_SCAFFOLDS_DIR, fromSlug);
   if (existsSync(join(monorepoDir, 'notis.config.ts'))) {
     return monorepoDir;
   }
@@ -1083,15 +1083,15 @@ function resolveScaffoldSourceDir(fromSlug) {
 }
 
 function loadMonorepoScaffoldCatalog() {
-  if (!existsSync(MONOREPO_APPS_DIR)) {
+  if (!existsSync(MONOREPO_SCAFFOLDS_DIR)) {
     return [];
   }
   const scaffolds = [];
-  for (const entry of readdirSync(MONOREPO_APPS_DIR, { withFileTypes: true })) {
+  for (const entry of readdirSync(MONOREPO_SCAFFOLDS_DIR, { withFileTypes: true })) {
     if (!entry.isDirectory() || entry.name.startsWith('.') || entry.name.startsWith('_')) {
       continue;
     }
-    const configPath = join(MONOREPO_APPS_DIR, entry.name, 'notis.config.ts');
+    const configPath = join(MONOREPO_SCAFFOLDS_DIR, entry.name, 'notis.config.ts');
     if (!existsSync(configPath)) {
       continue;
     }