@withone/cli 1.41.0 → 1.43.2

package/dist/migrate-LHFWCO6M.js

@@ -0,0 +1,16 @@
+import {
+  buildIdentityMap,
+  dotPathToJsonbExpr,
+  memMigrateCommand,
+  reviveStringifiedJson
+} from "./chunk-AD4QM6R5.js";
+import "./chunk-44CV5IMX.js";
+import "./chunk-MRGKKO54.js";
+import "./chunk-5TT27ORC.js";
+import "./chunk-AU2ZEEMS.js";
+export {
+  buildIdentityMap,
+  dotPathToJsonbExpr,
+  memMigrateCommand,
+  reviveStringifiedJson
+};

package/dist/runtime-O3PX562N.js

@@ -0,0 +1,13 @@
+import {
+  addRecord,
+  getBackend,
+  resetBackendSingleton,
+  upsertRecord
+} from "./chunk-5TT27ORC.js";
+import "./chunk-AU2ZEEMS.js";
+export {
+  addRecord,
+  getBackend,
+  resetBackendSingleton,
+  upsertRecord
+};

package/dist/sql-JEBAPGJP.js

@@ -0,0 +1,11 @@
+import {
+  memSqlCommand,
+  syncSqlCommand
+} from "./chunk-7N5EJTYW.js";
+import "./chunk-MRGKKO54.js";
+import "./chunk-5TT27ORC.js";
+import "./chunk-AU2ZEEMS.js";
+export {
+  memSqlCommand,
+  syncSqlCommand
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withone/cli",
-  "version": "1.41.0",
+  "version": "1.43.2",
   "description": "CLI for managing One",
   "type": "module",
   "files": [
@@ -23,15 +23,19 @@
     "@clack/prompts": "^0.9.1",
     "commander": "^13.1.0",
     "open": "^10.1.0",
+    "pgserve": "^2.2.3",
     "picocolors": "^1.1.1",
     "smol-toml": "^1.6.0"
   },
   "optionalDependencies": {
-    "better-sqlite3": "^11.7.0"
+    "@electric-sql/pglite": "^0.2.17",
+    "better-sqlite3": "^11.7.0",
+    "pg": "^8.20.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.13.1",
+    "@types/pg": "^8.20.0",
     "tsup": "^8.3.6",
     "typescript": "^5.7.3"
   },

package/profiles/attio/attioCompanies.json

@@ -3,9 +3,11 @@
   "platform": "attio",
   "model": "attioCompanies",
   "connection": { "platform": "attio" },
-  "actionId": "conn_mod_def::GJt0lFZ6kpk::attio-companies-list",
-  "resultsPath": "companies",
-  "idField": "id",
+  "identityKey": "values.domains[0].domain",
+  "actionId": "conn_mod_def::GJ0CbN-LPiU::A6h6M9QkS0Cs2Lt9CdPH7Q",
+  "pathVars": { "object": "companies" },
+  "resultsPath": "data",
+  "idField": "id.record_id",
   "pagination": {
     "type": "offset",
     "passAs": "body:offset"

package/profiles/attio/attioPeople.json

@@ -3,10 +3,11 @@
   "platform": "attio",
   "model": "attioPeople",
   "connection": { "platform": "attio" },
-  "identityKey": "primary_email_address",
-  "actionId": "conn_mod_def::GJt0lFZ6kpk::attio-people-list",
-  "resultsPath": "people",
-  "idField": "id",
+  "identityKey": "values.email_addresses[0].email_address",
+  "actionId": "conn_mod_def::GJ0CbN-LPiU::A6h6M9QkS0Cs2Lt9CdPH7Q",
+  "pathVars": { "object": "people" },
+  "resultsPath": "data",
+  "idField": "id.record_id",
   "pagination": {
     "type": "offset",
     "passAs": "body:offset"

package/skills/one/SKILL.md

@@ -148,36 +148,109 @@ Knowledge and search responses are cached locally (`~/.one/cache/`). Subsequent
 - Manage cache: `one cache list`, `one cache clear`, `one cache update-all`
 - `actions execute` is NEVER cached — always fresh
 
-## Local Data Sync
+## Unified Memory
 
-Sync platform data into local SQLite for instant queries, full-text search, scheduled refresh, and change-driven automation.
+One ships a local memory store (a real Postgres process bootstrapped on demand via the bundled `embedded-postgres` plugin, with a `postgres` plugin available for remote/self-hosted Postgres) that backs both user-authored notes and synced platform data. `one mem <cmd>` is the primary surface; `one sync` is a namespaced alias (`one mem sync ...`) that writes synced rows into the same store.
+
+**Zero-config.** The first `one mem` call on a new machine auto-initializes — no separate `mem init` step required. The `embedded-postgres` plugin downloads its Postgres binaries on first run (~52MB) and writes a daemon PID/port file at `~/.one/pg/.pgserve.json` so subsequent CLI invocations reuse the running cluster. If an OpenAI key is already resolvable (env, `.onerc`, or `config.openaiApiKey`), embeddings enable automatically and search becomes hybrid FTS + semantic. Otherwise you get FTS-only with a structured `_upgrade` hint on every response telling the user how to upgrade.
+
+**Listing synced rows.** `mem list <type>` takes a positional namespaced type — there is no `--platform` flag. Synced rows live under `<platform>/<model>` types:
+
+```bash
+one --agent mem list "gmail/threads"
+one --agent mem list "attio/attioPeople" --limit 5
+one --agent mem list "google-calendar/events"
+```
+
+Underneath, the store has no `platform` column — `type` is the only platform-scoping mechanism. If you need raw SQL via `mem sql`, filter with `WHERE type LIKE 'platform/%'` (not `WHERE platform = ...`).
 
 ```bash
-# First time only
-one sync install
+# User memories
+one --agent mem add note '{"content":"..."}' --tags work --weight 7
+one --agent mem search "deadline"                       # hybrid if key set, else FTS
+one --agent mem list note --limit 20
+one --agent mem link <from-id> <to-id> relates_to --bi
+
+# Status + diagnostics
+one --agent mem status                                  # backend, provider, _upgrade hint
+one --agent mem doctor                                  # full health report
+```
+
+### Adding OpenAI for semantic search
+
+Stored at the top level of `~/.one/config.json` as `openaiApiKey`, same precedence as `ONE_SECRET` (env > `.onerc OPENAI_API_KEY=...` > project > global). Three equivalent ways to set:
+
+```bash
+# Via re-run of one init (interactive prompt)
+one init
+
+# Via config set (writes to top-level, not the memory block)
+one --agent mem config set embedding.apiKey sk-...
 
+# Via env var (no persistence)
+export OPENAI_API_KEY=sk-...
+```
+
+### Syncing platforms into memory
+
+```bash
 # Check built-in profiles (pre-validated configs for common platforms)
 one --agent sync profiles
 
-# Setup (uses built-in if available, otherwise auto-infers + auto-tests)
+# Setup — seeds from the built-in, merges your --config overrides
 one --agent sync init stripe balanceTransactions
-# If _complete: true and _test.ok: true → go straight to sync run
-
-# Sync + query
+# If _complete: true and _test.ok: true → ready to run
+
+# Preview what gets embedded BEFORE paying embedding cost (agent declares paths)
+one --agent sync init attio attioPeople --config '{
+  "memory": {
+    "embed": true,
+    "searchable": [
+      "values.name[0].full_name",
+      "values.job_title[0].value",
+      "values.description[0].value",
+      "values.email_addresses[0].email_address"
+    ]
+  }
+}'
+# Skip the "pick paths by reading knowledge" step — let the CLI rank them from a live sample
+one --agent sync suggest-searchable attio/attioPeople
+# → { suggestions: [{path, score, hitRate, avgLength, noiseFraction, sampleValue}], configPatch: {...paste-ready...} }
+
+one --agent sync test attio/attioPeople --show-searchable
+# → Previews across 5 samples. Each path has { hits, total, sample }:
+#     5/5 = path resolves on every record (clean)
+#     1/5 = field is real but sparse on this page
+#     0/5 = typo, or field never populated in sampled records
+# Iterate until the numbers match intent.
+
+# Run — memory is always written; pass --no-memory to skip (rare)
 one --agent sync run stripe
 one --agent sync query stripe/balanceTransactions --where "status=available" --limit 20
-one --agent sync search "refund"                 # FTS across all synced platforms
+one --agent sync search "refund"                 # hybrid across all synced platforms
 one --agent sync list stripe                     # progress + freshness
 
 # Schedule unattended syncs
 one sync schedule add stripe --every 1h
 ```
 
+### memory.searchable paths
+
+Declared on the profile, drives what gets embedded + FTS-indexed. Supports numeric indexes AND `[]` wildcards for array fan-out:
+
+```
+values.name[0].full_name              # numeric index (first element)
+messages[].snippet                    # wildcard — every element's .snippet
+messages[].payload.parts[].body.data  # nested wildcards
+```
+
+Without declared paths, the default walker concatenates every string in the record — correct but often noisy for hierarchical APIs (Attio, HubSpot). **Always declare paths for any profile with `embed: true`.**
+
 **Sync rejects custom actions** — profiles must use passthrough. `sync init` only surfaces passthrough models; `sync run` aborts if the list or enrich action is tagged `custom`. If no passthrough exists, compose a flow instead.
 
 **Connections are late-bound** — profiles use `"connection": { "platform": "<name>" }`, not literal `connectionKey` strings. The key is resolved at sync time, so `one add <platform>` (re-auth) doesn't break the profile. For multi-account platforms, add `"tag": "<connection-tag>"` to disambiguate. Don't hardcode connection keys in profiles.
 
-**Advanced features** (enrich, transform, exclude, identityKey, hooks, --full-refresh, --where-sql delete, cursor resume): run `one guide sync` for the full reference.
+**Advanced features** (enrich, transform, exclude, identityKey, hooks, --full-refresh, alternative backends, embedding tuning): run `one guide memory` or `one guide sync` for the full reference.
 
 ## Beyond Single Actions
 

package/skills/one/references/relay.md

@@ -16,6 +16,14 @@ one --agent connection list
 
 Identify source (sends webhooks) and destination (receives forwarded data). Note both connection keys.
 
+If you're unsure whether the source platform supports relay at all, list relay-capable platforms first:
+
+```bash
+one --agent relay platforms
+```
+
+This returns `[{ "platform": "<name>", "eventTypeCount": <n> }, ...]` for every platform that One can receive webhooks from. If your source isn't in the list, relay won't work for it.
+
 ### Step 2: Get event types
 
 ```bash
@@ -173,6 +181,13 @@ one --agent relay activate <relay-id> --actions '[{
 }]'
 ```
 
+## Discovery Commands
+
+```bash
+one --agent relay platforms                        # All relay-capable platforms + event type counts
+one --agent relay event-types <platform>           # Event types for a specific platform
+```
+
 ## Management Commands
 
 ```bash