orangeslice 2.1.4-beta.2 → 2.1.4

package/docs/integrations/attio/updateObject.md

@@ -0,0 +1,40 @@
+# updateObject
+
+Update an object's metadata.
+
+```typescript
+const result = await integrations.attio.updateObject({
+  object: "projects",
+  data: {
+    singular_noun: "Initiative",
+    plural_noun: "Initiatives",
+  },
+});
+```
+
+## Input
+
+```typescript
+{
+  object: string;
+  data: {
+    api_slug?: string;
+    singular_noun?: string;
+    plural_noun?: string;
+  };
+}
+```
+
+## Output
+
+```typescript
+{
+  data: {
+    id: { object_id: string };
+    api_slug: string;
+    singular_noun: string;
+    plural_noun: string;
+    created_at: string;
+  };
+}
+```

package/docs/integrations/attio/updateRecord.md

@@ -0,0 +1,41 @@
+# updateRecord
+
+Update a record. For multiselect attributes, new values are appended (existing values kept).
+
+```typescript
+const result = await integrations.attio.updateRecord({
+  object: "people",
+  record_id: "rec_01abc123def456",
+  data: {
+    values: {
+      job_title: "Senior Engineer",
+      tags: ["vip"],
+    },
+  },
+});
+```
+
+## Input
+
+```typescript
+{
+  object: string;
+  record_id: string;
+  data: {
+    values: Record<string, any>;
+  };
+}
+```
+
+## Output
+
+```typescript
+{
+  data: {
+    id: { workspace_id: string; object_id: string; record_id: string };
+    created_at: string;
+    web_url: string;
+    values: Record<string, Array<{ active_from?: string; active_until?: string | null; attribute_type?: string; [key: string]: any }>>;
+  };
+}
+```

package/docs/integrations/attio/updateSelectOption.md

@@ -0,0 +1,40 @@
+# updateSelectOption
+
+Update a select option.
+
+```typescript
+const result = await integrations.attio.updateSelectOption({
+  target: "objects",
+  target_identifier: "companies",
+  attribute: "industry",
+  option: "fin-services-opt-id",
+  data: { title: "Finance & Banking" },
+});
+```
+
+## Input
+
+```typescript
+{
+  target: "objects" | "lists";
+  target_identifier: string;
+  attribute: string;
+  option: string;
+  data: {
+    title?: string;
+    is_archived?: boolean;
+  };
+}
+```
+
+## Output
+
+```typescript
+{
+  data: {
+    id: { option_id: string };
+    title: string;
+    is_archived: boolean;
+  };
+}
+```

package/docs/integrations/attio/updateStatus.md

@@ -0,0 +1,47 @@
+# updateStatus
+
+Update a status.
+
+```typescript
+const result = await integrations.attio.updateStatus({
+  target: "objects",
+  target_identifier: "deals",
+  attribute: "stage",
+  status: "negotiation-status-id",
+  data: {
+    title: "In Negotiation",
+    celebration_enabled: true,
+  },
+});
+```
+
+## Input
+
+```typescript
+{
+  target: "objects" | "lists";
+  target_identifier: string;
+  attribute: string;
+  status: string;
+  data: {
+    title?: string;
+    is_archived?: boolean;
+    celebration_enabled?: boolean;
+    target_time_in_status?: string | null;
+  };
+}
+```
+
+## Output
+
+```typescript
+{
+  data: {
+    id: { status_id: string };
+    title: string;
+    is_archived: boolean;
+    celebration_enabled: boolean;
+    target_time_in_status: string | null;
+  };
+}
+```

package/docs/integrations/attio/updateTask.md

@@ -0,0 +1,57 @@
+# updateTask
+
+Update a task.
+
+```typescript
+const result = await integrations.attio.updateTask({
+  task_id: "task_01abc123def456",
+  data: {
+    is_completed: true,
+    deadline_at: "2026-03-28T17:00:00.000Z",
+    assignees: [
+      { workspace_member_email_address: "manager@example.com" },
+    ],
+    linked_records: [
+      { target_object: "companies", target_record_id: "rec_01abc123def456" },
+      { target_object: "people", target_record_id: "rec_02xyz789ghi012" },
+    ],
+  },
+});
+```
+
+## Input
+
+```typescript
+{
+  task_id: string;
+  data: {
+    deadline_at?: string | null;
+    is_completed?: boolean;
+    assignees?: Array<
+      | { referenced_actor_type: string; referenced_actor_id: string }
+      | { workspace_member_email_address: string }
+    >;
+    linked_records?: Array<{
+      target_object: string;
+      target_record_id: string;
+    }>;
+  };
+}
+```
+
+## Output
+
+```typescript
+{
+  data: {
+    id: { task_id: string };
+    content_plaintext: string;
+    is_completed: boolean;
+    deadline_at: string | null;
+    created_at: string;
+    created_by_actor: { type: string; id: string | null };
+    assignees: Array<{ type: string; id: string | null }>;
+    linked_records: Array<{ target_object: string; target_record_id: string }>;
+  };
+}
+```

package/docs/integrations/attio/updateWebhook.md

@@ -0,0 +1,41 @@
+# updateWebhook
+
+Update a webhook.
+
+```typescript
+const result = await integrations.attio.updateWebhook({
+  webhook_id: "wh_01abc234def567",
+  data: {
+    target_url: "https://example.com/webhooks/attio/v2",
+  },
+});
+```
+
+## Input
+
+```typescript
+{
+  webhook_id: string;
+  data: {
+    target_url?: string;
+    subscriptions?: Array<{
+      event_type: string;
+      filter: Record<string, any> | null;
+    }>;
+  };
+}
+```
+
+## Output
+
+```typescript
+{
+  data: {
+    id: { webhook_id: string };
+    target_url: string;
+    subscriptions: Array<{ event_type: string; filter: Record<string, any> | null }>;
+    status: string;
+    created_at: string;
+  };
+}
+```

package/docs/integrations/index.md

@@ -149,6 +149,48 @@ const invite = await integrations.slack.conversationsInviteShared({
 
 See [slack/](./slack/) for all available functions.
 
+### Attio
+
+CRM operations for records, lists, notes, tasks, and more.
+
+```typescript
+// List people with a filter
+const people = await integrations.attio.listRecords({
+   object: "people",
+   filter: { email_addresses: { email_address: "jane@acme.com" } }
+});
+
+// Upsert a company by domain
+const company = await integrations.attio.assertRecord({
+   object: "companies",
+   matching_attribute: "domains",
+   data: { values: { name: [{ value: "Acme Inc" }], domains: [{ domain: "acme.com" }] } }
+});
+
+// Add a record to a list
+await integrations.attio.createEntry({
+   list_id: "sales_pipeline",
+   data: {
+      parent_record_id: company.data.id.record_id,
+      parent_object: "companies",
+      entry_values: { stage: "New Lead" }
+   }
+});
+
+// Create a note on a record
+await integrations.attio.createNote({
+   data: {
+      parent_object: "people",
+      parent_record_id: "rec_abc123",
+      title: "Call notes",
+      format: "plaintext",
+      content: "Discussed Q3 roadmap."
+   }
+});
+```
+
+See [attio/](./attio/) for all available functions.
+
 ### Gmail
 
 Send emails from connected Google Gmail accounts.

package/docs/services/ctx/index.md

@@ -9,8 +9,7 @@ Manage Orange Slice spreadsheets programmatically. Create spreadsheets, add shee
 ## Quick start
 
 ```typescript
-import { services } from "orangeslice";
-const { ctx } = services;
+import { ctx } from "orangeslice";
 
 // Create a spreadsheet
 const ss = await ctx.createSpreadsheet({ name: "Leads" });
@@ -18,8 +17,12 @@ const ss = await ctx.createSpreadsheet({ name: "Leads" });
 // Create a sheet with columns
 await ctx.sql(ss.id, "CREATE TABLE contacts (name, email, website)");
 
-// Insert data
-await ctx.sql(ss.id, "INSERT INTO contacts (name, email) VALUES ('Acme', 'hi@acme.com')");
+// Insert data via addRows (not SQL)
+const bound = ctx.spreadsheet(ss.id);
+await bound.sheet("contacts").addRows([
+   { name: "Acme", email: "hi@acme.com" },
+   { name: "Globex", email: "hello@globex.com" }
+]);
 
 // Query data
 const result = await ctx.sql(ss.id, "SELECT * FROM contacts WHERE name = 'Acme'");
@@ -40,19 +43,17 @@ console.log(result.rows);
 Call `ctx.spreadsheet(id)` to get a handle bound to a specific spreadsheet:
 
 ```typescript
-const { ctx } = services;
 const ss = ctx.spreadsheet("uuid-here");
 await ss.sql("SELECT * FROM contacts");
-await ss.sheet("contacts").addRow({ name: "Corp", email: "corp@example.com" });
 await ss.sheet("contacts").addRows([
+   { name: "Corp", email: "corp@example.com" },
    { name: "Foo", email: "foo@example.com" },
    { name: "Bar", email: "bar@example.com" }
 ]);
 ```
 
 - **`ss.sql(sql)`** — Execute EAV-SQL (same as `ctx.sql` but without needing to pass spreadsheetId).
-- **`ss.sheet(name).addRow(row)`** — Insert a single row into the named sheet.
-- **`ss.sheet(name).addRows(rows)`** — Insert multiple rows.
+- **`ss.sheet(name).addRows(rows)`** — Insert one or more rows into the named sheet. Accepts a single row object or an array. Missing columns are auto-created.
 
 ## EAV-SQL Reference
 
@@ -62,7 +63,7 @@ The `sql` method supports a subset of SQL mapped to Orange Slice's EAV storage:
 | -------------- | ---------------------------------------------------------- | -------------------------------- |
 | `CREATE TABLE` | `CREATE TABLE leads (name, email, website)`                | Creates a new sheet with columns |
 | `SELECT`       | `SELECT name, email FROM leads WHERE email LIKE '%@acme%'` | Query rows                       |
-| `INSERT INTO`  | `INSERT INTO leads (name) VALUES ('Acme')`                 | Add rows                         |
+| `INSERT INTO`  | Use `ss.sheet(name).addRows([...])` instead                | Add rows (not via SQL)           |
 | `ALTER TABLE`  | `ALTER TABLE leads ADD COLUMN phone`                       | Add/rename/drop columns          |
 | `DELETE FROM`  | `DELETE FROM leads WHERE email IS NULL`                    | Delete rows                      |
 | `DROP TABLE`   | `DROP TABLE leads`                                         | Delete a sheet                   |

package/docs/services/index.md

@@ -1,4 +1,3 @@
-- **ctx**: Spreadsheet management — create spreadsheets, run SQL, add sheets/columns/rows programmatically.
 - **ai**: AI helpers (summaries, classifications, scoring).
 - **apify**: Run any of 10,000+ Apify actors for web scraping, social media, e-commerce, and more.
 - **browser**: Kernel browser automation - spin up cloud browsers, execute Playwright code, take screenshots. **Use this for scraping structured lists of repeated data** (e.g., product listings, search results, table rows) where you know the DOM structure. Also ideal for **intercepting network requests** to discover underlying APIs, then paginate those APIs directly in your code (faster & cheaper than clicking through pages). Perfect for JS-heavy sites that don't work with simple HTTP scraping.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orangeslice",
-  "version": "2.1.4-beta.2",
+  "version": "2.1.4",
   "description": "B2B LinkedIn database prospector - 1.15B profiles, 85M companies",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",