@vectros-ai/mcp-server 0.18.1 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/CHANGELOG.md +50 -1
  2. package/README.md +105 -28
  3. package/dist/cli-http.js +1430 -302
  4. package/dist/cli-http.js.map +1 -1
  5. package/dist/cli-http.mjs +1430 -302
  6. package/dist/cli-http.mjs.map +1 -1
  7. package/dist/cli.js +1428 -300
  8. package/dist/cli.js.map +1 -1
  9. package/dist/cli.mjs +1428 -300
  10. package/dist/cli.mjs.map +1 -1
  11. package/dist/index.d.mts +10 -11
  12. package/dist/index.d.ts +10 -11
  13. package/dist/index.js +1428 -300
  14. package/dist/index.js.map +1 -1
  15. package/dist/index.mjs +1428 -300
  16. package/dist/index.mjs.map +1 -1
  17. package/package.json +3 -3
package/dist/index.d.mts CHANGED
@@ -42,22 +42,21 @@ declare function createLogger(ctx?: LogContext): Logger;
42
42
  * every name here needs a factory there, and vice versa. The server
43
43
  * iterates this list at construction; an unimplemented name throws.
44
44
  *
45
- * v0.1 (shipped 2026-05-30): hybrid_search, record_query, rag_ask, document_ask
46
- * v0.2 (shipped): list_schemas, document_get, current_identity, document_ingest
45
+ * v0.1: hybrid_search, record_query, rag_ask, document_ask
46
+ * v0.2: list_schemas, document_get, current_identity, document_ingest
47
47
  * launch data-plane I/O: record_get, record_create, record_update, record_delete (tier 1);
48
48
  * document_query (tier 2);
49
49
  * document_update, document_delete, folder_query,
50
50
  * folder_create, folder_update, folder_delete (tier 3)
51
- * (see the data-plane surface doc)
52
51
  * parity sweep: lookup_principal (identity resolution for the
53
52
  * ownership filters), version_history (record/document
54
53
  * audit trail)
55
- * 0.41.0 SDK adoption: record_batch_get (POST /v1/records/batch-get went
56
- * live in 0.41.0 — previously a 501 stub)
57
- * 0.43.0 SDK adoption: record_batch_write (POST /v1/records/batch went
58
- * live in 0.43.0 — previously a 501 stub)
54
+ * 0.41.0 SDK adoption: record_batch_get (POST /v1/records/batch-get, live since 0.41.0)
55
+ * 0.43.0 SDK adoption: record_batch_write (POST /v1/records/batch, live since 0.43.0)
56
+ * 0.49.0 SDK adoption: agent_list, agent_run, run_get (stored agents: GET /v1/agents,
57
+ * POST /v1/runs, GET /v1/runs/{id})
59
58
  */
60
- declare const TOOL_NAMES: readonly ["hybrid_search", "record_query", "record_get", "record_batch_get", "record_create", "record_batch_write", "record_update", "record_delete", "rag_ask", "document_ask", "list_schemas", "document_get", "document_query", "document_update", "document_delete", "folder_query", "folder_create", "folder_update", "folder_delete", "current_identity", "document_ingest", "lookup_principal", "version_history"];
59
+ declare const TOOL_NAMES: readonly ["hybrid_search", "record_query", "record_get", "record_batch_get", "record_create", "record_batch_write", "record_update", "record_delete", "rag_ask", "document_ask", "list_schemas", "document_get", "document_query", "document_update", "document_delete", "folder_query", "folder_create", "folder_update", "folder_delete", "current_identity", "document_ingest", "lookup_principal", "version_history", "agent_list", "agent_run", "run_get"];
61
60
  type ToolName = (typeof TOOL_NAMES)[number];
62
61
 
63
62
  /**
@@ -103,7 +102,7 @@ interface VectrosMCPServerOptions {
103
102
  logger?: Logger;
104
103
  /**
105
104
  * Which transport this server will be wired up with. Optional; only
106
- * affects tool behavior that depends on partner-local-fs access
105
+ * affects tool behavior that depends on local filesystem access
107
106
  * (currently `document_ingest`'s filePath mode is stdio-only). The
108
107
  * CLI entry points set this — `cli.ts` passes 'stdio', the v0.2
109
108
  * `cli-http.ts` passes 'http'. Programmatic embedders default to
@@ -113,7 +112,7 @@ interface VectrosMCPServerOptions {
113
112
  /**
114
113
  * If true (default in v0.2), perform a GET /v1/ping check during
115
114
  * `connect()` to fail-fast on bad credentials BEFORE the MCP
116
- * client sends its first tool call. The default is safe — partners
115
+ * client sends its first tool call. The default is safe — callers
117
116
  * who don't want the network roundtrip on startup can set false,
118
117
  * but the trade-off is "credential failures surface mid-tool-call
119
118
  * rather than at startup."
@@ -152,7 +151,7 @@ declare class VectrosMCPServer {
152
151
  *
153
152
  * If `validateOnStart` (default true) is enabled, performs a
154
153
  * GET /v1/ping check BEFORE wiring the transport. On failure,
155
- * throws — the partner's MCP client sees a startup error instead
154
+ * throws — your MCP client sees a startup error instead
156
155
  * of a confusing "tools work but the first call 401s" experience.
157
156
  */
158
157
  connect(transport: Transport): Promise<void>;
package/dist/index.d.ts CHANGED
@@ -42,22 +42,21 @@ declare function createLogger(ctx?: LogContext): Logger;
42
42
  * every name here needs a factory there, and vice versa. The server
43
43
  * iterates this list at construction; an unimplemented name throws.
44
44
  *
45
- * v0.1 (shipped 2026-05-30): hybrid_search, record_query, rag_ask, document_ask
46
- * v0.2 (shipped): list_schemas, document_get, current_identity, document_ingest
45
+ * v0.1: hybrid_search, record_query, rag_ask, document_ask
46
+ * v0.2: list_schemas, document_get, current_identity, document_ingest
47
47
  * launch data-plane I/O: record_get, record_create, record_update, record_delete (tier 1);
48
48
  * document_query (tier 2);
49
49
  * document_update, document_delete, folder_query,
50
50
  * folder_create, folder_update, folder_delete (tier 3)
51
- * (see the data-plane surface doc)
52
51
  * parity sweep: lookup_principal (identity resolution for the
53
52
  * ownership filters), version_history (record/document
54
53
  * audit trail)
55
- * 0.41.0 SDK adoption: record_batch_get (POST /v1/records/batch-get went
56
- * live in 0.41.0 — previously a 501 stub)
57
- * 0.43.0 SDK adoption: record_batch_write (POST /v1/records/batch went
58
- * live in 0.43.0 — previously a 501 stub)
54
+ * 0.41.0 SDK adoption: record_batch_get (POST /v1/records/batch-get, live since 0.41.0)
55
+ * 0.43.0 SDK adoption: record_batch_write (POST /v1/records/batch, live since 0.43.0)
56
+ * 0.49.0 SDK adoption: agent_list, agent_run, run_get (stored agents: GET /v1/agents,
57
+ * POST /v1/runs, GET /v1/runs/{id})
59
58
  */
60
- declare const TOOL_NAMES: readonly ["hybrid_search", "record_query", "record_get", "record_batch_get", "record_create", "record_batch_write", "record_update", "record_delete", "rag_ask", "document_ask", "list_schemas", "document_get", "document_query", "document_update", "document_delete", "folder_query", "folder_create", "folder_update", "folder_delete", "current_identity", "document_ingest", "lookup_principal", "version_history"];
59
+ declare const TOOL_NAMES: readonly ["hybrid_search", "record_query", "record_get", "record_batch_get", "record_create", "record_batch_write", "record_update", "record_delete", "rag_ask", "document_ask", "list_schemas", "document_get", "document_query", "document_update", "document_delete", "folder_query", "folder_create", "folder_update", "folder_delete", "current_identity", "document_ingest", "lookup_principal", "version_history", "agent_list", "agent_run", "run_get"];
61
60
  type ToolName = (typeof TOOL_NAMES)[number];
62
61
 
63
62
  /**
@@ -103,7 +102,7 @@ interface VectrosMCPServerOptions {
103
102
  logger?: Logger;
104
103
  /**
105
104
  * Which transport this server will be wired up with. Optional; only
106
- * affects tool behavior that depends on partner-local-fs access
105
+ * affects tool behavior that depends on local filesystem access
107
106
  * (currently `document_ingest`'s filePath mode is stdio-only). The
108
107
  * CLI entry points set this — `cli.ts` passes 'stdio', the v0.2
109
108
  * `cli-http.ts` passes 'http'. Programmatic embedders default to
@@ -113,7 +112,7 @@ interface VectrosMCPServerOptions {
113
112
  /**
114
113
  * If true (default in v0.2), perform a GET /v1/ping check during
115
114
  * `connect()` to fail-fast on bad credentials BEFORE the MCP
116
- * client sends its first tool call. The default is safe — partners
115
+ * client sends its first tool call. The default is safe — callers
117
116
  * who don't want the network roundtrip on startup can set false,
118
117
  * but the trade-off is "credential failures surface mid-tool-call
119
118
  * rather than at startup."
@@ -152,7 +151,7 @@ declare class VectrosMCPServer {
152
151
  *
153
152
  * If `validateOnStart` (default true) is enabled, performs a
154
153
  * GET /v1/ping check BEFORE wiring the transport. On failure,
155
- * throws — the partner's MCP client sees a startup error instead
154
+ * throws — your MCP client sees a startup error instead
156
155
  * of a confusing "tools work but the first call 401s" experience.
157
156
  */
158
157
  connect(transport: Transport): Promise<void>;