@lobu/cli 6.0.1 → 7.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @lobu/cli
 
-CLI tool for running Lobu locally and managing Lobu agents through the same REST API as the web app.
+CLI for running Lobu locally and managing Lobu agents through the same REST API as the web app.
 
 ## Quick Start
 
@@ -8,37 +8,30 @@ CLI tool for running Lobu locally and managing Lobu agents through the same REST
 npx @lobu/cli@latest init my-bot
 cd my-bot
 # edit .env to set DATABASE_URL
-npx @lobu/cli@latest run
+lobu run
 ```
 
-Lobu boots as a single Node process. Postgres is a user-provided external (managed instance or local — `brew services start postgresql`).
+Lobu boots as a single Node process. Postgres (with pgvector) is a user-provided external. `lobu doctor` reports what's missing.
 
-## Commands
-
-### `lobu init [name]`
-
-Scaffold a new Lobu project with interactive prompts:
-
-- **Project name**
-- **Gateway port** and optional **public URL** (for OAuth callbacks)
-- **Worker network access** (isolated, allowlist, or unrestricted)
-- **AI provider** selection from the bundled provider registry + API key
-- **Messaging platform** (Telegram, Slack, Discord, WhatsApp, Teams, Google Chat, or none)
-- **Memory** selection (filesystem, Lobu Cloud, or custom Owletto URL)
-
-**Generates:** `lobu.toml`, `.env` (with `DATABASE_URL` placeholder), `agents/<name>/` (`IDENTITY.md`, `SOUL.md`, `USER.md`, `skills/`, `evals/`), `skills/`, `AGENTS.md`, `TESTING.md`, `README.md`, `.gitignore`.
-
-When Owletto-backed memory is enabled, `lobu init` also scaffolds the file-first memory layout:
-
-- `[memory.owletto]` in `lobu.toml` (org, name, description, models, data)
-- `models/`
-- `data/`
-
-For a custom Owletto deployment, `.env` keeps `MEMORY_URL` as the optional base MCP URL override.
+```bash
+docker run -d --name lobu-pg -p 5432:5432 \
+  -e POSTGRES_PASSWORD=lobu pgvector/pgvector:pg16
+# DATABASE_URL=postgresql://postgres:lobu@localhost:5432/postgres
+```
 
-### `lobu run`
+## Commands
 
-Boot the embedded Lobu stack — gateway + workers + embeddings + Owletto memory backend in a single Node process. `lobu.toml` is not required; set `DATABASE_URL` in the environment or `.env`, then the command spawns the bundled `@lobu/server/dist/server.bundle.mjs`. Ctrl+C stops the process and any spawned worker subprocesses cleanly.
+`lobu --help` shows the full grouped command list, and `lobu <cmd> --help` lists the per-command flags. The highlights:
+
+- `lobu init [name]` — scaffold a project. Interactive by default; pass `--yes` (with any of `--port` / `--provider` / `--platform` / `--memory` / `--no-sentry` / etc.) for non-interactive / CI scaffolding. `lobu init .` or `--here` scaffolds into the current directory.
+- `lobu run` (aliases: `lobu dev`, `lobu start`) — boot the embedded stack. Pre-flights the gateway port and accepts `--port` / `--quiet` / `--verbose` / `--log-level`.
+- `lobu chat <prompt>` — send one prompt and stream the response. `-C/--continue` resumes the last thread (per context+agent); `--auto-approve` skips tool prompts in trusted runs; `--json` emits raw SSE events for piping.
+- `lobu doctor` — Postgres connectivity, pgvector extension, port availability, provider API keys, workspace dir.
+- `lobu link` / `lobu unlink` — bind this directory to a (context, org) at `.lobu/project.json`. `lobu apply` refuses to push mismatched targets unless `--force` is set.
+- `lobu apply` (alias: `lobu deploy`) — idempotent sync of `lobu.toml` to Lobu Cloud.
+- `lobu agent scaffold <id>` — add a second/third agent to an existing project.
+- `lobu eval new <name>` — scaffold a YAML eval into the current agent.
+- `lobu telemetry {status,on,off}` — Sentry is off by default; toggle here.
 
 ## License
 

package/dist/bundled-skills/lobu/SKILL.md

@@ -34,23 +34,23 @@ npx @lobu/cli@latest eval
 npx @lobu/cli@latest login
 ```
 
-<!-- owletto-memory-guidance:start -->
+<!-- lobu-memory-guidance:start -->
 ## Memory Defaults
 
-Your long-term memory is powered by Owletto. Do NOT use local files (memory/, MEMORY.md) for memory.
-- Owletto automatically recalls relevant memories when you receive a message.
-- To save something, call save_knowledge with the content and an appropriate semantic_type.
-- To search, call search_knowledge. Results include view_url links to the web interface.
-- NEVER construct Owletto URLs yourself. When the user asks for a link, call search_knowledge to get the correct view_url.
-- When the user says "remember this", save it to Owletto immediately.
-<!-- owletto-memory-guidance:end -->
+Your long-term memory is powered by Lobu. Do NOT use local files (memory/, MEMORY.md) for memory.
+- Lobu automatically recalls relevant memories when you receive a message.
+- To save something, call save_memory with the content and an appropriate semantic_type.
+- To search, call search_memory. Results include view_url links to the web interface.
+- NEVER construct Lobu URLs yourself. When the user asks for a link, call search_memory to get the correct view_url.
+- When the user says "remember this", save it to Lobu immediately.
+<!-- lobu-memory-guidance:end -->
 
 ## Lobu Memory
 
 Configure project-scoped memory in `lobu.toml`:
 
 ```toml
-[memory.owletto]
+[memory]
 enabled = true
 org = "my-org"
 name = "My workspace"
@@ -65,10 +65,10 @@ lobu login
 lobu memory org set <org-slug>
 lobu memory health --org <org-slug>
 lobu memory seed --org <org-slug>
-lobu memory run search_knowledge '{"query":"Acme"}' --org <org-slug>
+lobu memory run search_memory '{"query":"Acme"}' --org <org-slug>
 ```
 
-Use `search_knowledge` first when the user asks about a specific entity or workspace memory. Use `save_knowledge` to persist durable memory. To update existing knowledge, search first, then save with `supersedes_event_id` so the old row is tombstoned rather than deleted.
+Use `search_memory` first when the user asks about a specific entity or workspace memory. Use `save_memory` to persist durable memory. To update existing knowledge, search first, then save with `supersedes_event_id` so the old row is tombstoned rather than deleted.
 
 ## MCP Client Setup
 

package/dist/commands/_lib/apply/apply-cmd.d.ts

@@ -1,3 +1,5 @@
+import { type RemoteConnectorDefinition } from "./client.js";
+import { type DesiredState } from "./desired-state.js";
 export interface ApplyOptions {
     cwd?: string;
     dryRun?: boolean;
@@ -5,8 +7,44 @@ export interface ApplyOptions {
     only?: "agents" | "memory";
     org?: string;
     url?: string;
+    /** Bypass the project-link guard. */
+    force?: boolean;
     /** Test seam — inject a stubbed fetch. */
     fetchImpl?: typeof fetch;
 }
+/**
+ * Read a response body as a stream, counting *bytes* and aborting as soon as
+ * the running total exceeds `maxBytes` — before buffering the rest. Decodes to
+ * UTF-8 text only after the (bounded) body is in hand. Exported for testing.
+ */
+export declare function readBoundedBody(res: Response, maxBytes: number, onOverflow: () => never): Promise<string>;
+/**
+ * Validate connection / auth-profile config against the connector definitions
+ * the server knows about. When `skipSchemaForConnectorKeys` is given, those
+ * connector keys (the locally-declared `*.connector.ts` / `type: connector`
+ * ones) get only the structural checks here — full JSON-schema validation runs
+ * later, after install + catalog refetch, against the *fresh* schemas. This
+ * avoids rejecting a connection's config against a stale installed schema when
+ * the same apply updates that connector.
+ */
+export interface ValidateConnectorStateOptions {
+    /**
+     * Connector keys whose JSON-schema validation should be skipped in this pass
+     * (the locally-declared ones in the *pre*-install pass — they're schema-
+     * validated post-install against the fresh catalog).
+     */
+    skipSchemaForConnectorKeys?: ReadonlySet<string>;
+    /**
+     * When true (the *post*-install pass), every connector key referenced by a
+     * desired auth profile or connection must be present in the catalog with
+     * `installed === true` — otherwise a hard `ValidationError` before any
+     * `executePlan` mutation. Catches a typo'd `connector:` ref, or a local
+     * `*.connector.ts` whose compiled `definition.key` differs from what the
+     * manifest assumed (so it never got installed under the expected key).
+     */
+    requireInstalled?: boolean;
+}
+export declare function validateConnectorState(state: DesiredState, connectorDefinitions: RemoteConnectorDefinition[], opts?: ValidateConnectorStateOptions): void;
+export declare function locallyDeclaredConnectorKeys(state: DesiredState): Set<string>;
 export declare function applyCommand(opts?: ApplyOptions): Promise<void>;
 //# sourceMappingURL=apply-cmd.d.ts.map

package/dist/commands/_lib/apply/apply-cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-cmd.d.ts","sourceRoot":"","sources":["../../../../src/commands/_lib/apply/apply-cmd.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA6JD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEzE"}
+{"version":3,"file":"apply-cmd.d.ts","sourceRoot":"","sources":["../../../../src/commands/_lib/apply/apply-cmd.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,yBAAyB,EAI/B,MAAM,aAAa,CAAC;AAOrB,OAAO,EAEL,KAAK,YAAY,EAKlB,MAAM,oBAAoB,CAAC;AAkC5B,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAsBD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,KAAK,GACtB,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAkRD;;;;;;;;GAQG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,oBAAoB,EAAE,yBAAyB,EAAE,EACjD,IAAI,GAAE,6BAAkC,GACvC,IAAI,CA4CN;AAOD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAM7E;AAqTD,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0LzE"}