@oxygen-agent/cli 1.1014.135 → 1.1014.618

package/node_modules/@oxygen/shared/dist/contracts/crm-support.d.ts

@@ -1,3 +1,4 @@
+import { type ContractIssue } from "./schema.js";
 export declare const CRM_NOTE_BODY_MAX_CHARS = 20000;
 export declare const CRM_NOTE_TITLE_MAX_CHARS = 300;
 export declare const CRM_FILE_LABEL_MAX_CHARS = 300;
@@ -10,6 +11,15 @@ export declare const CRM_NOTE_EDIT_CONTRACT: import("./schema.js").ContractObjec
     };
     readonly pinned: import("./schema.js").BooleanProperty;
 }, never>;
+export declare const CRM_NOTE_EDIT_INPUT_CONTRACT: import("./schema.js").ContractObject<{
+    readonly body: import("./schema.js").StringProperty;
+    readonly title: {
+        oneOf: [import("./schema.js").StringProperty, import("./schema.js").NullProperty];
+        description?: string;
+    };
+    readonly pinned: import("./schema.js").BooleanProperty;
+}, never>;
+export declare function crmNoteEditInputIssues(args: Readonly<Record<string, unknown>>): readonly ContractIssue[];
 export declare const CRM_FILE_ATTACH_CONTRACT: import("./schema.js").ContractObject<{
     readonly name: import("./schema.js").StringProperty;
     readonly content_base64: import("./schema.js").StringProperty;
@@ -18,6 +28,14 @@ export declare const CRM_FILE_ATTACH_CONTRACT: import("./schema.js").ContractObj
         description?: string;
     };
 }, "content_base64" | "name">;
+export declare const CRM_FILE_ATTACH_INPUT_CONTRACT: import("./schema.js").ContractObject<{
+    readonly name: import("./schema.js").StringProperty;
+    readonly content_base64: import("./schema.js").StringProperty;
+    readonly label: {
+        oneOf: [import("./schema.js").StringProperty, import("./schema.js").NullProperty];
+        description?: string;
+    };
+}, "content_base64" | "name">;
 export declare const CRM_FILE_PREPARE_CONTRACT: import("./schema.js").ContractObject<{
     readonly name: import("./schema.js").StringProperty;
     readonly byte_length: {
@@ -29,12 +47,30 @@ export declare const CRM_FILE_PREPARE_CONTRACT: import("./schema.js").ContractOb
     };
     readonly sha256: import("./schema.js").StringProperty;
 }, "byte_length" | "name" | "sha256">;
+export declare const CRM_FILE_PREPARE_INPUT_CONTRACT: import("./schema.js").ContractObject<{
+    readonly byte_length: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly name: import("./schema.js").StringProperty;
+    readonly sha256: import("./schema.js").StringProperty;
+}, "byte_length" | "name" | "sha256">;
 export declare const CRM_FILE_COMPLETE_CONTRACT: import("./schema.js").ContractObject<{
     readonly label: {
         oneOf: [import("./schema.js").StringProperty, import("./schema.js").NullProperty];
         description?: string;
     };
 }, never>;
+export declare const CRM_FILE_COMPLETE_INPUT_CONTRACT: import("./schema.js").ContractObject<{
+    readonly label: {
+        oneOf: [import("./schema.js").StringProperty, import("./schema.js").NullProperty];
+        description?: string;
+    };
+}, never>;
+export declare function crmFileCompleteInputIssues(args: Readonly<Record<string, unknown>>): readonly ContractIssue[];
 export declare const CRM_PHOTOS_CONTRACT: import("./schema.js").ContractObject<{
     readonly mode: {
         type: "string";
@@ -130,3 +166,19 @@ export declare const CRM_TASKS_QUERY_CONTRACT: import("./schema.js").ContractObj
     };
     readonly cursor: import("./schema.js").StringProperty;
 }, never>;
+export declare const CRM_TASKS_QUEUE_INPUT_CONTRACT: import("./schema.js").ContractObject<{
+    readonly assignee: import("./schema.js").StringProperty;
+    readonly status: {
+        type: "string";
+        enum: readonly ("" | "all" | "cancelled" | "completed" | "open")[];
+        description?: string;
+    };
+    readonly limit: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly cursor: import("./schema.js").StringProperty;
+}, never>;

package/node_modules/@oxygen/shared/dist/contracts/crm-support.js

@@ -1,4 +1,4 @@
-import { bool, enumOf, int, nullable, obj, str } from "./schema.js";
+import { bool, enumOf, int, nullable, obj, str, validateContract } from "./schema.js";
 export const CRM_NOTE_BODY_MAX_CHARS = 20_000;
 export const CRM_NOTE_TITLE_MAX_CHARS = 300;
 export const CRM_FILE_LABEL_MAX_CHARS = 300;
@@ -8,17 +8,52 @@ export const CRM_NOTE_EDIT_CONTRACT = obj({
     title: nullable(str({ maxLength: CRM_NOTE_TITLE_MAX_CHARS, description: "Replacement title; null or empty clears." })),
     pinned: bool({ description: "Whether the note is pinned; false unpins." }),
 });
+// HTTP trims these fields before the native length check. Raw length bounds
+// would reject accepted padding; empty body is ignored, even in a mixed edit.
+export const CRM_NOTE_EDIT_INPUT_CONTRACT = obj({
+    body: str({ description: "Replacement Markdown; trimmed text maximum 20000 characters. Empty or whitespace text is ignored." }),
+    title: nullable(str({ description: "Replacement title; trimmed maximum 300 characters. Null or empty clears." })),
+    pinned: CRM_NOTE_EDIT_CONTRACT.properties.pinned,
+});
+export function crmNoteEditInputIssues(args) {
+    const body = typeof args.body === "string" ? args.body.trim() : "";
+    const title = typeof args.title === "string" ? args.title.trim() : "";
+    const checked = validateContract(CRM_NOTE_EDIT_CONTRACT, {
+        ...(body ? { body } : {}),
+        ...(args.title !== undefined ? { title: title || null } : {}),
+        ...(args.pinned !== undefined ? { pinned: args.pinned } : {}),
+    }, { unknown: "reject", overMax: "reject" });
+    return checked.ok ? [] : checked.issues;
+}
 export const CRM_FILE_ATTACH_CONTRACT = obj({
     name: str({ minLength: 1, description: "Original filename." }),
     content_base64: str({ minLength: 1, description: "Inline bytes; entire JSON request must fit 2 MB. Larger files use upload prepare/complete." }),
     label: nullable(str({ maxLength: CRM_FILE_LABEL_MAX_CHARS, description: "Optional record-local label." })),
 }, { required: ["name", "content_base64"] });
+export const CRM_FILE_ATTACH_INPUT_CONTRACT = obj({
+    ...CRM_FILE_ATTACH_CONTRACT.properties,
+    label: nullable(str({ description: "Optional record-local label; trimmed maximum 300 characters." })),
+}, { required: [...CRM_FILE_ATTACH_CONTRACT.required] });
 export const CRM_FILE_PREPARE_CONTRACT = obj({
     name: str({ minLength: 1, description: "Original filename." }),
     byte_length: int({ minimum: 0, maximum: 100 * 1024 * 1024, description: "Exact byte length; maximum 100 MiB." }),
     sha256: str({ minLength: 64, maxLength: 64, description: "Hex SHA-256 of the exact bytes to PUT." }),
 }, { required: ["name", "byte_length", "sha256"] });
-export const CRM_FILE_COMPLETE_CONTRACT = obj({ label: nullable(str({ maxLength: CRM_FILE_LABEL_MAX_CHARS, description: "Optional record-local label." })) });
+export const CRM_FILE_PREPARE_INPUT_CONTRACT = obj({
+    ...CRM_FILE_PREPARE_CONTRACT.properties,
+    name: str({ pattern: "\\S", description: "Original filename; must remain nonempty after trimming." }),
+    sha256: str({ pattern: "^\\s*[A-Fa-f0-9]{64}\\s*$", description: "Hex SHA-256 of the exact bytes to PUT; case and surrounding whitespace are normalized." }),
+}, { required: [...CRM_FILE_PREPARE_CONTRACT.required] });
+const CRM_FILE_COMPLETE_LABEL_DESCRIPTION = "Record-local attachment label. Omitted, null or empty preserves an existing label and leaves a new attachment unlabeled. Filename is unchanged.";
+export const CRM_FILE_COMPLETE_CONTRACT = obj({ label: nullable(str({ maxLength: CRM_FILE_LABEL_MAX_CHARS, description: CRM_FILE_COMPLETE_LABEL_DESCRIPTION })) });
+export const CRM_FILE_COMPLETE_INPUT_CONTRACT = obj({
+    label: nullable(str({ description: CRM_FILE_COMPLETE_LABEL_DESCRIPTION + " Trimmed maximum 300 characters." })),
+});
+export function crmFileCompleteInputIssues(args) {
+    const label = typeof args.label === "string" ? args.label.trim() : "";
+    const checked = validateContract(CRM_FILE_COMPLETE_CONTRACT, { label: label || null }, { unknown: "reject", overMax: "reject" });
+    return checked.ok ? [] : checked.issues;
+}
 export const CRM_PHOTOS_CONTRACT = obj({
     mode: enumOf(["dry_run", "live"], { description: "Default dry_run. Inspect preview before live." }),
     live: bool({ description: "Shortcut for mode=live; conflicts with mode=dry_run." }),
@@ -46,3 +81,9 @@ export const CRM_TASKS_QUERY_CONTRACT = obj({
     limit: int({ minimum: 1, maximum: 200, description: "Maximum tasks; default 50." }),
     cursor: str({ minLength: 1, maxLength: 500, description: "Previous nextCursor." }),
 });
+export const CRM_TASKS_QUEUE_INPUT_CONTRACT = obj({
+    ...CRM_TASKS_QUERY_CONTRACT.properties,
+    status: enumOf([...CRM_TASKS_QUERY_CONTRACT.properties.status.enum, ""], { description: "open, completed or cancelled; all, empty or omitted reads every status." }),
+    limit: int({ minimum: 1, description: "Maximum tasks; the server clamps to 200. Default 50." }),
+    cursor: str({ description: "Previous nextCursor; empty is ignored." }),
+});

package/node_modules/@oxygen/shared/dist/contracts/customer-operations.js

@@ -5,7 +5,7 @@ import { WHATSAPP_DRAFTS_READ_CONTRACT } from "./whatsapp-reads.js";
 import { TABLE_FAVORITE_CONTRACT, TABLE_FAVORITES_LIST_CONTRACT, TABLE_ITEM_RESOLVE_CONTRACT, TABLE_LINK_SUGGEST_CONTRACT, TABLE_RECOVER_PENDING_CONTRACT } from "./table-operations.js";
 import { BILLING_OWNER_READ_CONTRACT } from "./billing-owner-read.js";
 import { COPILOT_SESSIONS_LIST_CONTRACT } from "./copilot-sessions.js";
-import { CRM_FILE_ATTACH_CONTRACT, CRM_FILE_ATTACH_DESCRIPTION } from "./crm-support.js";
+import { CRM_CONNECTIONS_QUERY_CONTRACT, CRM_FILE_ATTACH_INPUT_CONTRACT, CRM_FILE_ATTACH_DESCRIPTION, CRM_FILE_COMPLETE_INPUT_CONTRACT, CRM_FILE_PREPARE_INPUT_CONTRACT, CRM_NOTE_EDIT_INPUT_CONTRACT, CRM_PHOTOS_CONTRACT, CRM_TASKS_QUEUE_INPUT_CONTRACT, crmFileCompleteInputIssues, crmNoteEditInputIssues } from "./crm-support.js";
 import { spintaxContract } from "./spintax.js";
 import { betaFeaturesUpdateContract, emailDomainSuppressionListContract, emailDomainSuppressionRemoveContract, emailSuppressionRemoveContract, providerLimitListContract, providerLimitSelectorContract, providerLimitUpdateContract } from "./workspace-utilities.js";
 import { knowledgeSyncReadContract } from "./knowledge-sync.js";
@@ -38,7 +38,7 @@ export const CUSTOMER_OPERATIONS = [
     operation("members.client_role", "/api/cli/collab/members/role", "POST", "approvals client grant", "oxygen_members_client_role_set", "collaboration", "Set or clear the restricted client overlay; admin only. May read pending Clerk invitations; sends no invitation. Free.", { email: text(), role: nullable(enumOf(["client"])) }, ["email", "role"], { ...mcpOnly, annotations: { openWorldHint: true } }),
     operation("members.workspace_role", "/api/cli/collab/members/workspace-role", "POST", "orgs member-role", "oxygen_members_workspace_role_set", "collaboration", "Change a member's workspace role in Clerk; admin only, with self-role and last-administrator protection. Free.", { email: text(), role: enumOf(["admin", "member"]) }, ["email", "role"], { ...mcpOnly, annotations: { openWorldHint: true } }),
     operation("copilot.sessions.list", "/api/cli/copilot/sessions", "GET", "copilot list", "oxygen_copilot_sessions_list", "agents", "List attended Copilot sessions in this workspace.", COPILOT_SESSIONS_LIST_CONTRACT.properties, [], mcpOnly),
-    operation("copilot.sessions.update", "/api/cli/copilot/sessions/{session_id}", "PATCH", "copilot policy set", "oxygen_copilot_session_update", "agents", "Set an attended Copilot session's approval and screen-follow policies. Paid auto-approval is explicit standing authorization.", { auto_approve_policy: enumOf(["off", "paid"]), surface_policy: enumOf(["off", "follow"]) }, [], { spends: true }),
+    operation("copilot.sessions.update", "/api/cli/copilot/sessions/{session_id}", "PATCH", "copilot policy set", "oxygen_copilot_session_update", "agents", "Set an attended Copilot session's approval policy. Paid auto-approval is explicit standing authorization.", { auto_approve_policy: enumOf(["off", "paid"]) }, ["auto_approve_policy"], { spends: true }),
     operation("copilot.attachments.list", "/api/cli/copilot/sessions/{session_id}/attachments", "GET", "copilot attachments list", "oxygen_copilot_attachments_list", "agents", "List sent and unsent attachments in one Copilot session.", {}, []),
     operation("copilot.attachments.prepare", "/api/cli/copilot/sessions/{session_id}/attachments", "POST", "copilot attachments prepare", "oxygen_copilot_attachment_prepare", "agents", "Reserve a Copilot attachment and return its scoped upload URL; complete only after uploading the exact bytes.", { file_name: text(), content_type: text(), content_length: int({ minimum: 1 }) }, ["file_name", "content_length"]),
     operation("copilot.attachments.complete", "/api/cli/copilot/sessions/{session_id}/attachments/{attachment_id}/complete", "POST", "copilot attachments complete", "oxygen_copilot_attachment_complete", "agents", "Verify and describe an uploaded Copilot attachment in its session.", {}, []),
@@ -46,13 +46,13 @@ export const CUSTOMER_OPERATIONS = [
     operation("copilot.feedback", "/api/cli/copilot/sessions/{session_id}/turns/{turn_id}/feedback", "POST", "copilot feedback", "oxygen_copilot_feedback", "agents", "Rate one attended Copilot turn and optionally explain the rating.", { rating: enumOf(["up", "down"]), comment: text() }, ["rating"]),
     operation("copilot.interrupt", "/api/cli/copilot/sessions/{session_id}/turns/{turn_id}/interrupt", "POST", "copilot interrupt", "oxygen_copilot_interrupt", "agents", "Request cancellation of one Copilot turn. Read the session again to confirm it stopped.", {}, [], mcpOnly),
     operation("context.canonical.get", "/api/cli/context/canonical/get", "POST", "context canonical get", "oxygen_context_canonical_get", "knowledge", "Read the current canonical (pinned) voice, brand or positioning that AI copy uses, or any type's pinned asset. present=false means none is pinned; grounding_when_absent says what AI copy uses instead.", { type: text("Type to read: voice, brand or positioning (the canonical copy AI uses), or another context type such as playbook or persona.") }, ["type"], { mutates: false }),
-    operation("crm.notes.update", "/api/cli/crm/notes/{note_id}", "PATCH", "crm notes update", "oxygen_crm_note_update", "crm", "Edit a CRM note's body, title or pinned state; an empty title clears it.", { body: text(), title: nullable(text()), pinned: bool() }, [], mcpOnly),
+    operation("crm.notes.update", "/api/cli/crm/notes/{note_id}", "PATCH", "crm notes update", "oxygen_crm_note_update", "crm", "Edit a CRM note's body, title or pinned state; an empty title clears it.", {}, [], { ...mcpOnly, contract: CRM_NOTE_EDIT_INPUT_CONTRACT, inputCheck: crmNoteEditInputIssues }),
     operation("crm.notes.delete", "/api/cli/crm/notes/{note_id}", "DELETE", "crm notes delete", "oxygen_crm_note_delete", "crm", "Delete one CRM note in this workspace.", {}, [], mcpOnly),
-    operation("crm.files.attach_inline", "/api/cli/crm/objects/{object}/records/{row_id}/files", "POST", "crm files attach-inline", "oxygen_crm_file_attach", "crm", CRM_FILE_ATTACH_DESCRIPTION, CRM_FILE_ATTACH_CONTRACT.properties, [...(CRM_FILE_ATTACH_CONTRACT.required ?? [])]),
-    operation("crm.files.prepare", "/api/cli/crm/objects/{object}/records/{row_id}/files/upload-url", "POST", "crm files prepare-upload", "oxygen_crm_file_prepare_upload", "crm", "Reserve a CRM file upload by exact name, length and SHA-256; returns a scoped upload URL.", { name: text(), byte_length: int({ minimum: 0 }), sha256: text() }, ["name", "byte_length", "sha256"]),
-    operation("crm.files.complete", "/api/cli/crm/objects/{object}/records/{row_id}/files/{file_id}/uploaded", "POST", "crm files complete-upload", "oxygen_crm_file_complete_upload", "crm", "Verify a reserved CRM upload and attach it to its record; mismatched bytes remain pending.", { label: text() }),
+    operation("crm.files.attach_inline", "/api/cli/crm/objects/{object}/records/{row_id}/files", "POST", "crm files attach-inline", "oxygen_crm_file_attach", "crm", CRM_FILE_ATTACH_DESCRIPTION, {}, [], { contract: CRM_FILE_ATTACH_INPUT_CONTRACT, inputCheck: crmFileCompleteInputIssues }),
+    operation("crm.files.prepare", "/api/cli/crm/objects/{object}/records/{row_id}/files/upload-url", "POST", "crm files prepare-upload", "oxygen_crm_file_prepare_upload", "crm", "Reserve a CRM file upload by exact name, length and SHA-256; returns a scoped upload URL.", {}, [], { contract: CRM_FILE_PREPARE_INPUT_CONTRACT }),
+    operation("crm.files.complete", "/api/cli/crm/objects/{object}/records/{row_id}/files/{file_id}/uploaded", "POST", "crm files complete-upload", "oxygen_crm_file_complete_upload", "crm", "Verify a reserved CRM upload and attach it to its record; mismatched bytes remain pending.", {}, [], { contract: CRM_FILE_COMPLETE_INPUT_CONTRACT, inputCheck: crmFileCompleteInputIssues, bodyRequired: true }),
     operation("crm.files.delete", "/api/cli/crm/files/{attachment_id}", "DELETE", "crm files detach", "oxygen_crm_file_delete", "crm", "Detach a CRM attachment by attachment_id, preserving the stored file.", {}, [], mcpOnly),
-    operation("crm.photos", "/api/cli/crm/photos", "POST", "crm photos", "oxygen_crm_photos_backfill", "crm", "Preview or fill people photos from data this workspace already holds. Free; mode defaults to dry_run.", { mode: enumOf(["dry_run", "live"]), limit: int({ minimum: 1, maximum: 10000 }) }, [], mcpOnly),
+    operation("crm.photos", "/api/cli/crm/photos", "POST", "crm photos", "oxygen_crm_photos_backfill", "crm", "Preview or fill people photos from data this workspace already holds. Free; mode defaults to dry_run.", {}, [], { ...mcpOnly, contract: CRM_PHOTOS_CONTRACT, bodyRequired: true }),
     operation("dashboards.tabs.create", "/api/cli/dashboards/{dashboard_id}/tabs", "POST", "dashboards tabs add", "oxygen_dashboard_tab_create", "signals", "Create a named tab in a workspace dashboard.", { title: text() }, ["title"], mcpOnly),
     operation("dashboards.tabs.delete", "/api/cli/dashboards/{dashboard_id}/tabs", "DELETE", "dashboards tabs remove", "oxygen_dashboard_tab_delete", "signals", "Remove one dashboard tab by its id.", { tab: text() }, ["tab"], { ...mcpOnly, queryFields: ["tab"] }),
     operation("integrations.custom.connect", "/api/cli/custom-integrations/connect", "POST", "custom-integrations connect", "oxygen_custom_integration_connect", "integrations", "Store an encrypted API key for an applied custom HTTP integration; the secret is never returned.", { slug: text(), api_key: text() }, ["slug", "api_key"], mcpOnly),
@@ -63,10 +63,11 @@ export const CUSTOMER_OPERATIONS = [
     operation("db.cost_policy.reconcile", "/api/cli/db/reconcile-cost-policy", "POST", "db reconcile-cost-policy", "oxygen_database_cost_policy_reconcile", "workspace", "Retired Neon compatibility action: reports applied=false with no operations; does not suspend PostgreSQL. Native workspace write access applies; no preview or confirmation field. 0 credits.", { suspend_idle: bool() }, [], mcpOnly),
     operation("directory.apply", "/api/cli/directory/apply", "POST", "directory apply", "oxygen_directory_apply", "crm", "Apply for an agency-directory listing for this workspace; reuses an existing open application.", { message: text(), website: text() }, [], mcpOnly),
     operation("directory.logo", "/api/cli/directory/listing/logo", "POST", "directory logo upload", "oxygen_directory_logo_upload", "crm", "Upload a public agency-directory logo and read back the updated listing; PNG, JPEG, WebP or SVG, at most 2 MB.", { content_base64: text(), file_name: text(), content_type: enumOf(["image/png", "image/jpeg", "image/webp", "image/svg+xml"]) }, ["content_base64", "file_name", "content_type"], { multipart: { contentField: "content_base64", nameField: "file_name", typeField: "content_type", fileField: "file" } }),
-    operation("domains.delete", "/api/cli/domains/delete", "POST", "domains delete", "oxygen_domains_delete", "deliverability", "Preview domain removal and renewal cancellation; execute only with the exact plan hash and confirmation.", { domains: list(), approved: bool(), plan_hash: text(), confirmation: text() }, ["domains"], mcpOnly),
+    operation("domains.delete", "/api/cli/domains/delete", "POST", "domains delete", "oxygen_domains_delete", "deliverability", "Preview domain and inbox removal; execute with the exact plan hash and confirmation. Oxygen-bought domains stop renewing but stay registered until expiry; no refund.", { domains: list(), approved: bool(), plan_hash: text(), confirmation: text() }, ["domains"], { ...mcpOnly, annotations: { destructiveHint: true, openWorldHint: true } }),
     operation("knowledge.pages.archive", "/api/cli/knowledge/pages/archive", "POST", "knowledge page archive", "oxygen_knowledge_page_archive", "knowledge", "Archive a knowledge page; content/history remain, links become unresolved. Pass expected_revision for the version you reviewed.", { slug: text(), id: text(), expected_revision: int({ minimum: 1 }) }, [], mcpOnly),
-    operation("knowledge.sync.manifest", "/api/cli/knowledge/sync/manifest", "POST", "knowledge sync-manifest", "oxygen_knowledge_sync_manifest", "knowledge", "Read wiki revision/hash metadata. Follow next_cursor for remaining pages; scope is a live keyset, not a snapshot.", {}, [], { contract: knowledgeSyncReadContract, mutates: false }),
-    operation("knowledge.sync.delta", "/api/cli/knowledge/sync/delta", "POST", "knowledge sync-delta", "oxygen_knowledge_sync_delta", "knowledge", "Read complete wiki pages/tombstones. First call seeds missing starter pages. Follow next_cursor; an oversized page is refused without skipping. 0 credits.", {}, [], { contract: knowledgeSyncReadContract }),
+    operation("knowledge.pages.restore", "/api/cli/knowledge/pages/restore", "POST", "knowledge page restore", "oxygen_knowledge_page_restore", "knowledge", "Restore a knowledge page to an earlier revision as a new revision; history is kept. Pass expected_revision to refuse if the page changed since. Sensitive pages still need approval.", { slug: text(), id: text(), revision: int({ minimum: 1 }), expected_revision: int({ minimum: 1 }) }, ["revision"], mcpOnly),
+    operation("knowledge.sync.manifest", "/api/cli/knowledge/sync/manifest", "POST", "knowledge sync-manifest", "oxygen_knowledge_sync_manifest", "knowledge", "Read complete wiki revision/hash metadata. has_more/truncated mean more pages, not cut entries. last_cursor marks the last returned page; next_cursor resumes when more remain. Live keyset, not a snapshot.", {}, [], { contract: knowledgeSyncReadContract, mutates: false }),
+    operation("knowledge.sync.delta", "/api/cli/knowledge/sync/delta", "POST", "knowledge sync-delta", "oxygen_knowledge_sync_delta", "knowledge", "Sync complete wiki pages/tombstones; first call may seed missing starter pages. Follow next_cursor; an oversized page is refused without skipping. 0 credits.", {}, [], { contract: knowledgeSyncReadContract }),
     operation("limits.provider.get", "/api/cli/limits/provider", "GET", "limits provider list", "oxygen_provider_limits_list", "billing", "Read provider request limits and BYOK warning defaults. MCP defaults to bounded summary pages; follow paging.next_offset with the same filter. HTTP/CLI omit pagination for the full legacy list. 0 credits.", {}, [], { contract: providerLimitListContract, generated: { cli: false, mcp: false } }),
     operation("limits.provider.set", "/api/cli/limits/provider", "POST", "limits provider set", "oxygen_provider_limits_set", "billing", "Set an enforced provider request limit; admin or owner only. Approve the exact provider, operation and window: raising a cap may permit more provider use. 0 credits.", {}, [], { ...mcpOnly, contract: providerLimitUpdateContract }),
     operation("limits.provider.delete", "/api/cli/limits/provider", "DELETE", "limits provider delete", "oxygen_provider_limits_delete", "billing", "Clear one provider request-limit override; admin or owner only. Approve the exact selector. Other operation overrides remain; the provider returns to its defaults, whose BYOK threshold may be observe-only. 0 credits.", {}, [], { ...mcpOnly, contract: providerLimitSelectorContract, queryFields: ["provider", "operation"] }),
@@ -102,15 +103,17 @@ export const CUSTOMER_OPERATIONS = [
     operation("worker.repair", "/api/cli/worker/repair", "POST", "worker repair", "oxygen_workspace_queue_repair", "workspace", "Repair this workspace's stalled execution queues through the native bounded recovery path.", {}, [], mcpOnly),
     operation("db.status", "/api/cli/db/status", "GET", "db status", "oxygen_workspace_database_status", "workspace", "Read this workspace's database status and latest completed provisioning/migration receipt; not a list of current pending migrations. Historical Neon fields are lineage. Hosting is plan-included; 0 credits.", {}, [], mcpOnly),
     operation("db.provision", "/api/cli/db/provision", "POST", "db provision", "oxygen_workspace_database_provision", "workspace", "Provision or retry this workspace database immediately; already-ready workspaces retain it. No preview or confirmation field; native workspace write access applies. May outlast the connector deadline: read oxygen_workspace_database_status before retrying. Hosting is plan-included; 0 credits.", {}, [], mcpOnly),
-    operation("sessions.list", "/api/cli/sessions", "GET", "sessions list", "oxygen_sessions_list", "workspace", "List your personal CLI sessions across workspaces; OAuth or personal user session required, organization API keys are refused."),
-    operation("sessions.revoke", "/api/cli/sessions/{session_id}", "DELETE", "sessions revoke", "oxygen_sessions_revoke", "workspace", "Revoke one of your personal CLI sessions; OAuth or personal user session required, organization API keys are refused."),
+    operation("sessions.list", "/api/cli/sessions", "GET", "sessions list", "oxygen_sessions_list", "workspace", "List your personal CLI sessions across workspaces, including your organizations; OAuth or personal user session required, organization API keys are refused."),
+    operation("sessions.revoke", "/api/cli/sessions/{session_id}", "DELETE", "sessions revoke", "oxygen_sessions_revoke", "workspace", "Revoke one personal CLI session; if this client uses it, calls stop until you reconnect with a new session. OAuth or personal user session required; organization API keys are refused."),
     operation("billing.allowance", "/api/cli/billing/allowance", "GET", "billing allowance", "oxygen_billing_allowance", "billing", "Inspect this workspace's recurring credit allowance and period; due plan grants or credit expiry may apply. 0 credits; reserves nothing.", {}, [], { ...mcpOnly, mutates: true }),
     operation("billing.invoices", "/api/cli/billing/invoices", "GET", "billing invoices", "oxygen_billing_invoices", "billing", "Read this workspace's billing invoices and their hosted payment links.", {}, [], mcpOnly),
     operation("billing.seats.set", "/api/cli/billing/seats", "POST", "billing seats set", "oxygen_billing_seats_set", "billing", "Set purchased legacy sending-seat quantity. Retired seats cannot increase; reducing existing seats lowers the next renewal charge.", { seat_key: enumOf(["linkedin", "whatsapp", "phone_number", "email_sender"]), quantity: int({ minimum: 0 }) }, ["seat_key", "quantity"], mcpOnly),
     operation("collaboration.gates.list", "/api/cli/collab/gates", "GET", "approvals gate list", "oxygen_approval_gates_list", "collaboration", "Read this workspace's approval gates, optionally for one exact subject.", { subject: text() }, [], mcpOnly),
     operation("collaboration.members.list", "/api/cli/collab/members", "GET", "approvals client list", "oxygen_workspace_members_list", "collaboration", "Read workspace member roles, with Clerk profiles and pending invitations. Free.", {}, [], { ...mcpOnly, annotations: { openWorldHint: true } }),
-    operation("crm.connections", "/api/cli/crm/objects/{object}/records/{row_id}/connections", "GET", "crm connections", "oxygen_crm_connections", "crm", "Read a CRM record's connected conversations, sequence enrollments and related activity.", { conversation_limit: int({ minimum: 1 }), sequence_limit: int({ minimum: 1 }) }, [], mcpOnly),
-    operation("crm.tasks.list", "/api/cli/crm/tasks", "GET", "crm tasks list", "oxygen_crm_tasks_queue", "crm", "Read the workspace task queue by status, assignee and cursor.", { status: text(), assignee: text(), cursor: text(), limit: int({ minimum: 1 }) }, [], mcpOnly),
+    // Preserve this alias's existing over-limit admission: the API clamps each
+    // link limit to 100. Projection/window fields share the native read contract.
+    operation("crm.connections", "/api/cli/crm/objects/{object}/records/{row_id}/connections", "GET", "crm connections", "oxygen_crm_connections", "crm", "Read a CRM record's connected conversations, sequence enrollments and related activity.", { ...CRM_CONNECTIONS_QUERY_CONTRACT.properties, conversation_limit: int({ minimum: 1 }), sequence_limit: int({ minimum: 1 }) }, [], mcpOnly),
+    operation("crm.tasks.list", "/api/cli/crm/tasks", "GET", "crm tasks list", "oxygen_crm_tasks_queue", "crm", "Read the workspace task queue by status, assignee and cursor.", {}, [], { ...mcpOnly, contract: CRM_TASKS_QUEUE_INPUT_CONTRACT, queryOmitValues: { status: ["all"] } }),
     operation("crm.files.download", "/api/cli/crm/files/{attachment_id}/download", "GET", "crm files download", "oxygen_crm_file_download", "crm", "Download a tenant-owned record attachment by attachment_id. The native authenticated response contains its exact bytes.", {}, [], { binary: { maxBytes: 50 * 1024 * 1024 } }),
     operation("db.cost_policy.get", "/api/cli/db/cost-policy", "GET", "db cost-policy", "oxygen_database_cost_policy", "workspace", "Read this workspace's retired Neon cost-policy status. PostgreSQL has no per-workspace sleep control; stored Neon policy is historical. 0 credits.", {}, [], mcpOnly),
     operation("egress.dedicated.get", "/api/cli/egress/dedicated", "GET", "egress dedicated status", "oxygen_dedicated_egress_status", "deliverability", "Read dedicated outbound egress status and its current monthly commitment without activating it.", {}, [], mcpOnly),

package/node_modules/@oxygen/shared/dist/contracts/knowledge-content-reads.js

@@ -3,7 +3,7 @@ import { bool, enumOf, int, obj, str } from "./schema.js";
 // Optional native windows: unqualified HTTP/CLI reads retain their legacy shape.
 const window = {
     cursor: str({ minLength: 1, maxLength: 4096 }),
-    max_chars: int({ minimum: 2000, maximum: 48000, description: "Complete receipt window; surface cap applies." }),
+    max_chars: int({ minimum: 2000, maximum: 48000, description: "Caps: MCP 10k; Agent/Copilot 4k; HTTP/CLI 48k." }),
 };
 export const knowledgeIndexReadContract = obj({
     limit: int({ minimum: 1, maximum: 1000 }),

package/node_modules/@oxygen/shared/dist/contracts/knowledge-proposal-reads.d.ts

@@ -0,0 +1,49 @@
+/** Optional representation only; omitted controls keep the legacy list. */
+export declare const knowledgeProposalWindowContract: import("./schema.js").ContractObject<{
+    readonly projection: {
+        type: "string";
+        enum: readonly ("full" | "summary" | "value")[];
+        description?: string;
+    };
+    readonly path: import("./schema.js").StringProperty;
+    readonly value_cursor: import("./schema.js").StringProperty;
+    readonly max_chars: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly cursor: import("./schema.js").StringProperty;
+    readonly proposal: import("./schema.js").StringProperty;
+}, never>;
+export declare const knowledgeProposalReadContract: import("./schema.js").ContractObject<{
+    readonly projection: {
+        type: "string";
+        enum: readonly ("full" | "summary" | "value")[];
+        description?: string;
+    };
+    readonly path: import("./schema.js").StringProperty;
+    readonly value_cursor: import("./schema.js").StringProperty;
+    readonly max_chars: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly cursor: import("./schema.js").StringProperty;
+    readonly proposal: import("./schema.js").StringProperty;
+    readonly status: {
+        type: "string";
+        enum: readonly ("all" | "decided" | "open")[];
+        description?: string;
+    };
+    readonly limit: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+}, never>;

package/node_modules/@oxygen/shared/dist/contracts/knowledge-proposal-reads.js

@@ -0,0 +1,14 @@
+import { KNOWLEDGE_SLUG_MAX_LENGTH } from "../knowledge-constants.js";
+import { enumOf, int, obj, str } from "./schema.js";
+import { STORED_READ_WINDOW_FIELDS } from "./stored-read-window.js";
+/** Optional representation only; omitted controls keep the legacy list. */
+export const knowledgeProposalWindowContract = obj({
+    ...STORED_READ_WINDOW_FIELDS,
+    cursor: str({ minLength: 1, maxLength: 2000, description: "Queue next_cursor; same status/projection/selection/member. Live physical keyset, not a snapshot." }),
+    proposal: str({ minLength: 1, maxLength: KNOWLEDGE_SLUG_MAX_LENGTH, description: "Exact proposal UUID or slug, required for value. Reads its raw captured patch, not the normalized display page." }),
+});
+export const knowledgeProposalReadContract = obj({
+    status: enumOf(["open", "decided", "all"]),
+    limit: int({ minimum: 1, maximum: 200 }),
+    ...knowledgeProposalWindowContract.properties,
+});

package/node_modules/@oxygen/shared/dist/contracts/knowledge-sync.js

@@ -4,5 +4,5 @@ import { int, obj, str } from "./schema.js";
 export const knowledgeSyncReadContract = obj({
     cursor: str({ minLength: 1, maxLength: 256 }),
     limit: int({ minimum: 1, maximum: 200 }),
-    max_chars: int({ minimum: 1000, maximum: 48000, description: "Complete receipt window; surface cap applies." }),
+    max_chars: int({ minimum: 1000, maximum: 48000, description: "Response-envelope character cap; complete pages only. A single oversized page is refused; none is skipped. Surface cap applies." }),
 });

package/node_modules/@oxygen/shared/dist/contracts/limits-read.js

@@ -1,3 +1,5 @@
+import { PLAN_BAND_LIMITS_TIER, PLAN_BAND_ORDER } from "../plan-band.js";
+import { planLimitsStoragePendingLine } from "../plan-limits-view.js";
 import { enumOf, int, obj } from "./schema.js";
 export const LIMITS_READ_SECTIONS = ["summary", "capacity", "plan", "pricing", "api", "webhooks", "spend", "sending", "workflow", "all"];
 export const LIMITS_READ_QUERY_CONTRACT = obj({
@@ -28,13 +30,65 @@ function capacityProjection(value) {
             table_warning: reconciled ? usage.table_warning ?? null : null,
             table_limit_reached: reconciled ? usage.table_limit_reached ?? null : null,
         } : null,
-        note: "Rows are registry counts, available only after every Table is reconciled. Database bytes combine the last measured bytes and estimated subsequent growth; the estimate flag and timestamps name that state. Object storage is separate.",
+        note: [capacity.note ?? planLimitsStoragePendingLine(capacity), "Rows are registry counts, available only after every Table is reconciled. Database bytes combine the last measured bytes and estimated subsequent growth; the estimate flag and timestamps name that state. Object storage is separate."].filter(value => typeof value === "string").join(" "),
     };
 }
+/** Keys are the schedule's source contract. Unknown future keys stay unknown. */
+function scheduleScope(key) {
+    const [area, scope] = key.split(".");
+    if (!area || !scope)
+        return null;
+    if (["storage", "spend", "workflows"].includes(area) && PLAN_BAND_ORDER.includes(scope))
+        return { plan_band: scope };
+    if (area === "agents" && Object.values(PLAN_BAND_LIMITS_TIER).some(tier => tier === scope))
+        return { limits_tier: scope };
+    if (area === "plans" && scope?.startsWith("oxygen_") && PLAN_BAND_ORDER.includes(scope.slice(7)))
+        return { plan_band: scope.slice(7) };
+    if (["topup", "sending", "seat", "overage", "byok", "enrichment"].includes(area)
+        || (area === "workflows" && ["automation_step_credits", "steps_count_toward_max_credits"].includes(scope)))
+        return { all_plans: true };
+    return null;
+}
+function scheduleProjection(data, section, selectedBand) {
+    if (!data.pricing_schedule)
+        return null;
+    const schedule = record(data.pricing_schedule);
+    const band = selectedBand ?? String(data.plan_band ?? "");
+    const tier = selectedBand ? PLAN_BAND_LIMITS_TIER[selectedBand]
+        : data.limits_tier ?? PLAN_BAND_LIMITS_TIER[band];
+    const changes = (Array.isArray(schedule.changes) ? schedule.changes : []).map(record).filter(change => {
+        if (section === "pricing")
+            return true;
+        const key = String(change.key ?? ""), scope = scheduleScope(key);
+        if (scope?.plan_band && scope.plan_band !== band)
+            return false;
+        if (scope?.limits_tier && scope.limits_tier !== tier)
+            return false;
+        if (section === "capacity" || section === "summary")
+            return key.startsWith("storage.");
+        if (section === "spend")
+            return /^(spend|agents)\./.test(key);
+        if (section === "workflow")
+            return key.startsWith("workflows.");
+        return true;
+    }).map(change => ({
+        ...pick(change, ["key", "unit", "value_before", "value_after", "value_in_force"]),
+        // Pricing compares all bands; the key and typed scope remain concise.
+        ...(section !== "pricing" ? pick(change, ["description"]) : {}),
+        scope: scheduleScope(String(change.key ?? "")),
+    }));
+    return { ...pick(schedule, ["name", "effective_at", "status"]), changes,
+        note: "The date applies only to the listed changes. Scope names a plan band, a limits tier, or all plans; null means unknown. It does not activate awaiting_capacity_test targets." };
+}
 function pricingBand(value) {
     const row = record(value);
+    const storage = record(row.storage);
+    const pending = planLimitsStoragePendingLine(storage);
     return { ...pick(row, ["band", "label", "monthly_price_usd", "monthly_credits", "volume_bonus_percent", "usd_per_100_credits", "current"]),
-        storage: pick(record(row.storage), ["table_row_limit", "workspace_row_limit", "workspace_database_limit_bytes", "status", "effective_at", "target"]) };
+        storage: { ...pick(storage, ["table_row_limit", "workspace_row_limit", "workspace_database_limit_bytes", "status", "effective_at", "target"]),
+            ...(pending ? { note: storage.status === "awaiting_capacity_test"
+                    ? "Planned capacity is not in force; a capacity test is required and no activation date is set."
+                    : pending } : {}) } };
 }
 /** Legacy unqualified HTTP/CLI stays full. Native callers always select a section. */
 export function projectLimitsRead(data, query) {
@@ -64,14 +118,13 @@ export function projectLimitsRead(data, query) {
     }
     else if (section === "pricing") {
         selected.plan_bands = bands.map(pricingBand);
-        const schedule = record(data.pricing_schedule);
-        selected.pricing_schedule = {
-            ...pick(schedule, ["effective_at", "status"]),
-            changes: Array.isArray(schedule.changes) ? schedule.changes.map(value => pick(record(value), ["key", "value_before", "value_after", "value_in_force"])) : [],
-        };
+        selected.pricing_schedule = scheduleProjection(data, section);
     }
     else
         selected[SECTION_FIELDS[section]] = data[SECTION_FIELDS[section]];
+    if (!sameSelection && ["summary", "capacity", "plan", "spend", "workflow"].includes(section)) {
+        selected.pricing_schedule = scheduleProjection(data, section, query.band);
+    }
     if (!sameSelection && section === "all" && query.band)
         selected.plan_bands = bands.filter(row => record(row).band === query.band);
     // Copy before pruning: the full HTTP response and caller's source object are

package/node_modules/@oxygen/shared/dist/contracts/operations.d.ts

@@ -1,10 +1,14 @@
-import { type ContractObject } from "./schema.js";
+import { type ContractObject, type ContractIssue } from "./schema.js";
 export type OperationSpec<C extends ContractObject = ContractObject> = {
     /** Stable id, `<resource>.<verb>`. */
     id: string;
     /** Route template; `{name}` segments are path parameters. */
     route: string;
     method: "GET" | "POST" | "PATCH" | "DELETE";
+    /** Send an empty JSON object when the native route requires a JSON body. */
+    bodyRequired?: true;
+    /** Additional native checks on a normalized copy; raw wire values stay intact. */
+    inputCheck?: (args: Readonly<Record<string, unknown>>) => readonly ContractIssue[];
     /** When set, the contract describes `body[bodyKey]` rather than the whole body. */
     bodyKey?: string;
     contract: C;
@@ -12,6 +16,8 @@ export type OperationSpec<C extends ContractObject = ContractObject> = {
     parameters?: readonly string[];
     /** Fields sent in the query rather than the JSON body (all fields for GET). */
     queryFields?: readonly string[];
+    /** Client sentinels omitted only from query fields of this operation. */
+    queryOmitValues?: Readonly<Record<string, readonly string[]>>;
     /** Array fields encoded as repeated query keys rather than a JSON string. */
     repeatedQueryFields?: readonly string[];
     /** Fixed discriminator fields owned by this operation, never supplied by a caller. */
@@ -73,6 +79,8 @@ export type OperationSpec<C extends ContractObject = ContractObject> = {
 export declare function operationPath(spec: Pick<OperationSpec, "route">, params: Readonly<Record<string, string>>): string;
 /** The exact public grammar, including the operation's scoped route parameters. */
 export declare function operationInputContract(spec: OperationSpec): ContractObject;
+/** Check the closed raw grammar before any operation-specific native checks. */
+export declare function operationInputIssues(spec: OperationSpec, args: Record<string, unknown>): readonly ContractIssue[];
 /** Preserve absent, false, null and empty values while assigning each field to its transport. */
 export declare function operationRequest(spec: OperationSpec, args: Record<string, unknown>): {
     path: string;

package/node_modules/@oxygen/shared/dist/contracts/operations.js

@@ -5,7 +5,7 @@
  * cannot disagree on which fields exist. Leaf and browser-safe.
  */
 import { CONNECTOR_EVENTS_REVOKE_OPERATION, CONNECTOR_UPDATE_OPERATION } from "./connectors.js";
-import { str } from "./schema.js";
+import { str, validateContract } from "./schema.js";
 import { SENDER_LIMITS_SET_OPERATION } from "./sender-limits.js";
 import { WORKSPACE_PAGES_GET_OPERATION, WORKSPACE_PAGES_UPDATE_OPERATION } from "./workspace-pages.js";
 import { BROWSER_OPERATIONS } from "./browser-operations.js";
@@ -13,6 +13,7 @@ import { TABLE_FEED_UPDATE_OPERATION } from "./table-feed-update.js";
 import { GEO_OPERATIONS } from "./geo.js";
 import { CUSTOMER_OPERATIONS } from "./customer-operations.js";
 import { AGENT_SESSION_OPERATIONS } from "./agent-sessions.js";
+import { TEAMMATE_OPERATIONS } from "./teammates.js";
 import { WORKSPACE_SKILL_OPERATIONS } from "./workspace-skills.js";
 /** The route with its `{param}` segments filled in, each URL-encoded. */
 export function operationPath(spec, params) {
@@ -39,6 +40,11 @@ export function operationInputContract(spec) {
         required: [...parameters, ...(spec.contract.required ?? [])],
     };
 }
+/** Check the closed raw grammar before any operation-specific native checks. */
+export function operationInputIssues(spec, args) {
+    const checked = validateContract(operationInputContract(spec), args, { unknown: "reject", overMax: "reject" });
+    return checked.ok ? (spec.inputCheck?.(args) ?? []) : checked.issues;
+}
 /** Preserve absent, false, null and empty values while assigning each field to its transport. */
 export function operationRequest(spec, args) {
     const params = Object.fromEntries((spec.parameters ?? []).map((name) => [name, String(args[name] ?? "")]));
@@ -50,6 +56,8 @@ export function operationRequest(spec, args) {
         if (value === undefined)
             continue;
         if (spec.method === "GET" || spec.queryFields?.includes(name)) {
+            if (typeof value === "string" && spec.queryOmitValues?.[name]?.includes(value))
+                continue;
             if (spec.repeatedQueryFields?.includes(name) && Array.isArray(value)) {
                 for (const entry of value)
                     query.append(name, String(entry));
@@ -62,7 +70,7 @@ export function operationRequest(spec, args) {
     }
     if (query.size)
         path += `?${query}`;
-    return { path, method: spec.method, ...(spec.method !== "GET" && Object.keys(body).length > 0 ? { body: spec.bodyKey ? { [spec.bodyKey]: body } : body } : {}) };
+    return { path, method: spec.method, ...(spec.method !== "GET" && (Object.keys(body).length > 0 || spec.bodyRequired) ? { body: spec.bodyKey ? { [spec.bodyKey]: body } : body } : {}) };
 }
 /** Decode the explicit file property and keep the native multipart API contract. */
 export function operationFormData(spec, body) {
@@ -83,6 +91,6 @@ export function operationFormData(spec, body) {
     }
     return form;
 }
-export const OPERATION_SPECS = [SENDER_LIMITS_SET_OPERATION, CONNECTOR_UPDATE_OPERATION, CONNECTOR_EVENTS_REVOKE_OPERATION, WORKSPACE_PAGES_GET_OPERATION, WORKSPACE_PAGES_UPDATE_OPERATION, TABLE_FEED_UPDATE_OPERATION, ...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS];
-export const CLI_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.cli !== false);
-export const MCP_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.mcp !== false);
+export const OPERATION_SPECS = [SENDER_LIMITS_SET_OPERATION, CONNECTOR_UPDATE_OPERATION, CONNECTOR_EVENTS_REVOKE_OPERATION, WORKSPACE_PAGES_GET_OPERATION, WORKSPACE_PAGES_UPDATE_OPERATION, TABLE_FEED_UPDATE_OPERATION, ...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS];
+export const CLI_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.cli !== false);
+export const MCP_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.mcp !== false);

package/node_modules/@oxygen/shared/dist/contracts/publishing-reads.js

@@ -29,7 +29,7 @@ export function isPublishingStoredRead(name, args) {
 }
 export const publishingReadProjectionContract = obj({
     projection: { ...str({ description: "full default; summary lists exact child metadata/indices; value streams lossless canonical JSON. Follow next_cursor with the same scope." }), enum: ["full", "summary", "value"] },
-    value_path: str({ description: "Projection RFC6901 pointer: empty=root; /revisions/0/content_text, /comments/0/body, /series, /curve, /benchmarks or /accounts. No field is silently trimmed.", maxLength: 4096 }),
+    value_path: str({ description: "Exact RFC6901 pointer into this endpoint's native result; empty=root. Use projection=summary to discover existing child paths before selecting a value. Paths depend on the endpoint and analytics scope. No field is silently trimmed.", maxLength: 4096 }),
     cursor: str({ description: "Signed projection continuation; repeat the same filters, projection and value_path. Changed data/scope/source refuses stale.", maxLength: 4096 }),
 });
 export const publishingReadWindowContract = obj({

package/node_modules/@oxygen/shared/dist/contracts/teammates.d.ts

@@ -0,0 +1,16 @@
+import type { OperationSpec } from "./operations.js";
+export declare const TEAMMATE_PROFILE_FIELDS: {
+    name: import("./schema.js").StringProperty;
+    description: import("./schema.js").StringProperty;
+    avatar_key: {
+        type: "string";
+        enum: readonly ("atom" | "bubbles" | "clover" | "comet" | "crown" | "mark" | "o2" | "orbit" | "pill" | "trio" | "tripod" | "twin")[];
+        description?: string;
+    };
+    avatar_color: {
+        type: "string";
+        enum: readonly ("amber" | "aqua" | "blue" | "brown" | "forest" | "green" | "magenta" | "orange" | "purple" | "red" | "slate" | "violet")[];
+        description?: string;
+    };
+};
+export declare const TEAMMATE_OPERATIONS: readonly OperationSpec[];