@dayofweek/dcli 1.4.0 → 1.6.0

package/dist/client.d.ts

@@ -2,6 +2,11 @@
  * HTTP client for the Day of Week platform REST API.
  * All calls go through the proxy at field.dayofweek.com/app/api/dcli.
  */
+/**
+ * Node's Buffer is a Uint8Array view over a possibly-larger, possibly-shared
+ * backing store, which is not assignable to BodyInit. Copy out the exact bytes.
+ */
+export declare function toArrayBuffer(view: Uint8Array): ArrayBuffer;
 export declare class ApiError extends Error {
     status: number;
     code?: string | undefined;
@@ -103,23 +108,27 @@ export declare class DayOfWeekClient {
         type?: string;
         parent?: string;
         limit?: number;
+        org?: string;
     }): Promise<any[]>;
-    getEntity(entityId: string): Promise<any>;
+    getEntity(entityId: string, org?: string): Promise<any>;
     listProduce(opts?: {
         entity?: string;
         limit?: number;
+        org?: string;
     }): Promise<any[]>;
     listContacts(opts?: {
         entity?: string;
         limit?: number;
+        org?: string;
     }): Promise<any[]>;
-    listEntityTypes(): Promise<any[]>;
+    listEntityTypes(org?: string): Promise<any[]>;
     searchCatalog(opts?: {
         search?: string;
         parent?: string;
         type?: string;
         includeCategories?: boolean;
         limit?: number;
+        org?: string;
     }): Promise<any[]>;
     listProposals(opts?: {
         status?: string;
@@ -154,6 +163,161 @@ export declare class DayOfWeekClient {
         truncated: boolean;
         total: number;
     }>;
+    /**
+     * Direct produce entry — creates real Creator rows, not proposals.
+     *
+     * With `dryRun` the server runs the whole import and rolls it back, so the
+     * operator approves the server's verdict instead of a reconstruction of it.
+     */
+    importProduce(input: {
+        entityId: string;
+        items: unknown[];
+        dryRun?: boolean;
+        skipExistingNames?: boolean;
+        org?: string;
+    }): Promise<any>;
+    /** Recipe ingredients still standing in for something vaguer. */
+    listImpreciseIngredients(entityId: string, org?: string): Promise<any>;
+    /** Point an imprecise ingredient at what it actually is. */
+    refineIngredient(input: {
+        processInputId: string;
+        catalogConceptId?: string;
+        materialId?: string;
+        role?: string;
+        qty?: number;
+        unitCode?: string;
+        stillImprecise?: boolean;
+        org?: string;
+    }): Promise<any>;
+    /**
+     * Grow the shared produce catalog. Admin only — every customer sees these
+     * concepts, so adding one is a platform decision, not a per-import shortcut.
+     */
+    createCatalogConcepts(input: {
+        concepts: unknown[];
+        org?: string;
+    }): Promise<any>;
+    /** Area sources, metadata only, newest first — the freshness evidence. */
+    listBrainSources(areaId: string): Promise<any>;
+    /** Entities with an active customer role and no investor/partner/producer role. */
+    adminCustomersOnly(): Promise<any>;
+    /** Tips mailed to press@mail.dayofweek.com, read by the press-scan skill. */
+    adminPressInbox(opts?: {
+        since?: string;
+        limit?: number;
+    }): Promise<any>;
+    /**
+     * List the knowledge documents attached to an entity. `full` returns each
+     * document's whole content instead of an excerpt, which is what you want when
+     * mirroring an entity's sources into an external knowledge base.
+     */
+    listKnowledge(opts: {
+        entity: string;
+        full?: boolean;
+        org?: string;
+    }): Promise<any[]>;
+    getKnowledge(documentId: string, org?: string): Promise<any>;
+    /** Semantic search across knowledge documents. */
+    searchKnowledge(opts: {
+        query: string;
+        entity?: string;
+        types?: string[];
+        limit?: number;
+        allOrgs?: boolean;
+        org?: string;
+    }): Promise<any>;
+    /**
+     * Add a markdown knowledge note.
+     *
+     * Without `direct` this submits a proposal for human review — the default,
+     * and the only option non-admin tokens have. With `direct: true` an admin
+     * token writes the document immediately, skipping review. Ask the operator
+     * before doing that; see references/admin.md in the served skill.
+     */
+    addKnowledge(input: {
+        entityId: string;
+        title: string;
+        content: string;
+        sourceType?: string;
+        sourceUrl?: string;
+        sourceDescription?: string;
+        confidence?: number;
+        sourceAgent?: string;
+        direct?: boolean;
+        org?: string;
+    }): Promise<any>;
+    /**
+     * Attach a binary source (PDF, DOCX, XLSX, …) to an entity. Admin only.
+     *
+     * Three hops: ask for an upload URL, send the bytes straight to Convex
+     * storage, then register the resulting storageId. The bytes never pass
+     * through function arguments, so file size isn't bounded by an arg limit.
+     */
+    attachKnowledgeFile(input: {
+        entityId: string;
+        /** Raw file bytes. Buffer callers: pass `toArrayBuffer(buf)` below. */
+        data: ArrayBuffer;
+        fileName: string;
+        mimeType: string;
+        sourceType?: string;
+        sourceUrl?: string;
+        sourceDescription?: string;
+        org?: string;
+    }): Promise<any>;
+    listDatasets(org?: string): Promise<{
+        datasets: Array<{
+            name: string;
+            description: string;
+            params: string[];
+        }>;
+    }>;
+    readDataset(name: string, opts?: {
+        limit?: number;
+        org?: string;
+    }): Promise<any>;
+    listFeedback(opts?: {
+        status?: string;
+        priority?: string;
+        category?: string;
+        limit?: number;
+    }): Promise<{
+        items: any[];
+    }>;
+    getFeedbackItem(itemId: string): Promise<any>;
+    /** Top-N from the heuristic prioritizer — "what should I work on next?". */
+    feedbackRecommendations(limit?: number): Promise<{
+        recommendations: any[];
+    }>;
+    claimFeedbackItem(itemId: string): Promise<any>;
+    commentOnFeedbackItem(itemId: string, body: string): Promise<any>;
+    updateFeedbackItem(itemId: string, updates: {
+        status?: string;
+        priority?: string;
+        rejectedReason?: string;
+    }): Promise<any>;
+    listEmailThreads(opts?: {
+        status?: string;
+        since?: string;
+        customer?: string;
+        limit?: number;
+        org?: string;
+    }): Promise<any>;
+    getEmailThread(threadKey: string): Promise<any>;
+    replyToEmailThread(threadKey: string, input: {
+        message: string;
+        subject?: string;
+        to?: string;
+        cc?: string[];
+        quote?: boolean;
+    }): Promise<any>;
+    composeEmail(input: {
+        entityId?: string;
+        inbox?: string;
+        to: string;
+        cc?: string[];
+        subject: string;
+        message: string;
+    }): Promise<any>;
     getSkillBundle(name?: string): Promise<{
         name: string;
         version: string;
@@ -172,6 +336,7 @@ export declare class DayOfWeekClient {
     getSchema(): Promise<any>;
     private get;
     private post;
+    private put;
     private patch;
     private delete;
     private request;

package/dist/client.js

@@ -8,6 +8,15 @@ import { basename, dirname, join } from "node:path";
 import { Readable, Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 const DEFAULT_BASE_URL = "https://field.dayofweek.com/app/api/dcli";
+/**
+ * Node's Buffer is a Uint8Array view over a possibly-larger, possibly-shared
+ * backing store, which is not assignable to BodyInit. Copy out the exact bytes.
+ */
+export function toArrayBuffer(view) {
+    const out = new ArrayBuffer(view.byteLength);
+    new Uint8Array(out).set(view);
+    return out;
+}
 export class ApiError extends Error {
     status;
     code;
@@ -180,6 +189,8 @@ export class DayOfWeekClient {
         return this.get(`/brain/audit?${query}`);
     }
     // ── Read ──────────────────────────────────────────────────────────────────
+    // Every read endpoint accepts ?org=<slug|id> for admin tokens. Exposing it as
+    // --org is what keeps admins from dropping to curl for cross-org reads.
     async listEntities(opts) {
         const params = new URLSearchParams();
         if (opts?.type)
@@ -188,11 +199,14 @@ export class DayOfWeekClient {
             params.set("parent", opts.parent);
         if (opts?.limit)
             params.set("limit", String(opts.limit));
+        if (opts?.org)
+            params.set("org", opts.org);
         const qs = params.toString();
         return this.get(`/entities${qs ? `?${qs}` : ""}`);
     }
-    async getEntity(entityId) {
-        return this.get(`/entities/${entityId}`);
+    async getEntity(entityId, org) {
+        const qs = org ? `?org=${encodeURIComponent(org)}` : "";
+        return this.get(`/entities/${entityId}${qs}`);
     }
     async listProduce(opts) {
         const params = new URLSearchParams();
@@ -200,6 +214,8 @@ export class DayOfWeekClient {
             params.set("entity", opts.entity);
         if (opts?.limit)
             params.set("limit", String(opts.limit));
+        if (opts?.org)
+            params.set("org", opts.org);
         const qs = params.toString();
         return this.get(`/produce${qs ? `?${qs}` : ""}`);
     }
@@ -209,11 +225,14 @@ export class DayOfWeekClient {
             params.set("entity", opts.entity);
         if (opts?.limit)
             params.set("limit", String(opts.limit));
+        if (opts?.org)
+            params.set("org", opts.org);
         const qs = params.toString();
         return this.get(`/contacts${qs ? `?${qs}` : ""}`);
     }
-    async listEntityTypes() {
-        return this.get("/entity-types");
+    async listEntityTypes(org) {
+        const qs = org ? `?org=${encodeURIComponent(org)}` : "";
+        return this.get(`/entity-types${qs}`);
     }
     async searchCatalog(opts) {
         const params = new URLSearchParams();
@@ -227,6 +246,8 @@ export class DayOfWeekClient {
             params.set("includeCategories", "true");
         if (opts?.limit)
             params.set("limit", String(opts.limit));
+        if (opts?.org)
+            params.set("org", opts.org);
         const qs = params.toString();
         return this.get(`/catalog${qs ? `?${qs}` : ""}`);
     }
@@ -279,6 +300,211 @@ export class DayOfWeekClient {
         const qs = params.toString();
         return this.get(`/admin/proposals${qs ? `?${qs}` : ""}`);
     }
+    // ── Produce import (admin) ────────────────────────────────────────────────
+    /**
+     * Direct produce entry — creates real Creator rows, not proposals.
+     *
+     * With `dryRun` the server runs the whole import and rolls it back, so the
+     * operator approves the server's verdict instead of a reconstruction of it.
+     */
+    async importProduce(input) {
+        return this.post("/produce/import", input);
+    }
+    /** Recipe ingredients still standing in for something vaguer. */
+    async listImpreciseIngredients(entityId, org) {
+        const params = new URLSearchParams({ entity: entityId });
+        if (org)
+            params.set("org", org);
+        return this.get(`/produce/ingredients?${params.toString()}`);
+    }
+    /** Point an imprecise ingredient at what it actually is. */
+    async refineIngredient(input) {
+        return this.patch("/produce/ingredients", input);
+    }
+    /**
+     * Grow the shared produce catalog. Admin only — every customer sees these
+     * concepts, so adding one is a platform decision, not a per-import shortcut.
+     */
+    async createCatalogConcepts(input) {
+        return this.post("/catalog/concepts", input);
+    }
+    /** Area sources, metadata only, newest first — the freshness evidence. */
+    async listBrainSources(areaId) {
+        return this.get(`/brain/sources?area=${encodeURIComponent(areaId)}`);
+    }
+    /** Entities with an active customer role and no investor/partner/producer role. */
+    async adminCustomersOnly() {
+        return this.get("/admin/customers-only");
+    }
+    /** Tips mailed to press@mail.dayofweek.com, read by the press-scan skill. */
+    async adminPressInbox(opts) {
+        const params = new URLSearchParams();
+        if (opts?.since)
+            params.set("since", opts.since);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.get(`/press-inbox${qs ? `?${qs}` : ""}`);
+    }
+    // ── Knowledge ─────────────────────────────────────────────────────────────
+    /**
+     * List the knowledge documents attached to an entity. `full` returns each
+     * document's whole content instead of an excerpt, which is what you want when
+     * mirroring an entity's sources into an external knowledge base.
+     */
+    async listKnowledge(opts) {
+        const params = new URLSearchParams({ entity: opts.entity });
+        if (opts.full)
+            params.set("full", "1");
+        if (opts.org)
+            params.set("org", opts.org);
+        return this.get(`/knowledge?${params.toString()}`);
+    }
+    async getKnowledge(documentId, org) {
+        const params = new URLSearchParams({ document: documentId });
+        if (org)
+            params.set("org", org);
+        return this.get(`/knowledge?${params.toString()}`);
+    }
+    /** Semantic search across knowledge documents. */
+    async searchKnowledge(opts) {
+        const params = new URLSearchParams({ q: opts.query });
+        if (opts.entity)
+            params.set("entity", opts.entity);
+        if (opts.types?.length)
+            params.set("types", opts.types.join(","));
+        if (opts.limit)
+            params.set("limit", String(opts.limit));
+        if (opts.allOrgs)
+            params.set("allOrgs", "1");
+        if (opts.org)
+            params.set("org", opts.org);
+        return this.get(`/knowledge?${params.toString()}`);
+    }
+    /**
+     * Add a markdown knowledge note.
+     *
+     * Without `direct` this submits a proposal for human review — the default,
+     * and the only option non-admin tokens have. With `direct: true` an admin
+     * token writes the document immediately, skipping review. Ask the operator
+     * before doing that; see references/admin.md in the served skill.
+     */
+    async addKnowledge(input) {
+        return this.post("/knowledge", input);
+    }
+    /**
+     * Attach a binary source (PDF, DOCX, XLSX, …) to an entity. Admin only.
+     *
+     * Three hops: ask for an upload URL, send the bytes straight to Convex
+     * storage, then register the resulting storageId. The bytes never pass
+     * through function arguments, so file size isn't bounded by an arg limit.
+     */
+    async attachKnowledgeFile(input) {
+        const { uploadUrl } = await this.post("/knowledge/file", {
+            entityId: input.entityId,
+            org: input.org,
+        });
+        const byteSize = input.data.byteLength;
+        const uploadRes = await fetch(uploadUrl, {
+            method: "POST",
+            headers: { "Content-Type": input.mimeType },
+            body: input.data,
+        });
+        if (!uploadRes.ok) {
+            throw new ApiError(uploadRes.status, `Upload to storage failed: ${uploadRes.status} ${uploadRes.statusText}`);
+        }
+        const uploaded = (await uploadRes.json());
+        if (!uploaded.storageId)
+            throw new Error("Storage upload returned no storageId");
+        return this.put("/knowledge/file", {
+            entityId: input.entityId,
+            org: input.org,
+            storageId: uploaded.storageId,
+            fileName: input.fileName,
+            mimeType: input.mimeType,
+            byteSize,
+            sourceType: input.sourceType,
+            sourceUrl: input.sourceUrl,
+            sourceDescription: input.sourceDescription,
+        });
+    }
+    // ── Datasets ──────────────────────────────────────────────────────────────
+    // The server owns the catalog: which datasets exist, what they are called,
+    // and who may read them. This client is deliberately name-blind — discovery
+    // happens at runtime so the open-source CLI reveals nothing about the
+    // platform's product surfaces.
+    async listDatasets(org) {
+        const qs = org ? `?org=${encodeURIComponent(org)}` : "";
+        return this.get(`/datasets${qs}`);
+    }
+    async readDataset(name, opts) {
+        const params = new URLSearchParams();
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        if (opts?.org)
+            params.set("org", opts.org);
+        const qs = params.toString();
+        return this.get(`/datasets/${encodeURIComponent(name)}${qs ? `?${qs}` : ""}`);
+    }
+    // ── Feedback backlog ──────────────────────────────────────────────────────
+    // Token scopes apply: read:feedback for the GETs, write:feedback to comment,
+    // admin:feedback for claim/status/priority. backOffice users have them all.
+    async listFeedback(opts) {
+        const params = new URLSearchParams();
+        if (opts?.status)
+            params.set("status", opts.status);
+        if (opts?.priority)
+            params.set("priority", opts.priority);
+        if (opts?.category)
+            params.set("category", opts.category);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.get(`/feedback${qs ? `?${qs}` : ""}`);
+    }
+    async getFeedbackItem(itemId) {
+        return this.get(`/feedback/${encodeURIComponent(itemId)}`);
+    }
+    /** Top-N from the heuristic prioritizer — "what should I work on next?". */
+    async feedbackRecommendations(limit) {
+        const qs = limit ? `?limit=${limit}` : "";
+        return this.get(`/feedback/ai-recommendations${qs}`);
+    }
+    async claimFeedbackItem(itemId) {
+        return this.post(`/feedback/${encodeURIComponent(itemId)}/claim`, {});
+    }
+    async commentOnFeedbackItem(itemId, body) {
+        return this.post(`/feedback/${encodeURIComponent(itemId)}/comments`, { body });
+    }
+    async updateFeedbackItem(itemId, updates) {
+        return this.patch(`/feedback/${encodeURIComponent(itemId)}`, updates);
+    }
+    // ── Customer emails (admin only) ──────────────────────────────────────────
+    // Sending is gated on explicit human approval by the skill, not by the API.
+    async listEmailThreads(opts) {
+        const params = new URLSearchParams();
+        if (opts?.status)
+            params.set("status", opts.status);
+        if (opts?.since)
+            params.set("since", opts.since);
+        if (opts?.customer)
+            params.set("customer", opts.customer);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        if (opts?.org)
+            params.set("org", opts.org);
+        const qs = params.toString();
+        return this.get(`/emails${qs ? `?${qs}` : ""}`);
+    }
+    async getEmailThread(threadKey) {
+        return this.get(`/emails/${encodeURIComponent(threadKey)}`);
+    }
+    async replyToEmailThread(threadKey, input) {
+        return this.post(`/emails/${encodeURIComponent(threadKey)}/reply`, input);
+    }
+    async composeEmail(input) {
+        return this.post("/emails/compose", input);
+    }
     // ── Skill ─────────────────────────────────────────────────────────────────
     async getSkillBundle(name) {
         return this.get(`/skill${name ? `?name=${encodeURIComponent(name)}` : ""}`);
@@ -297,6 +523,9 @@ export class DayOfWeekClient {
     async post(path, body) {
         return this.request(path, { method: "POST", body: JSON.stringify(body) });
     }
+    async put(path, body) {
+        return this.request(path, { method: "PUT", body: JSON.stringify(body) });
+    }
     async patch(path, body) {
         return this.request(path, { method: "PATCH", body: JSON.stringify(body) });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dayofweek/dcli",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "CLI for the Day of Week AgTech platform — read data and submit proposals for review",
   "license": "MIT",
   "type": "module",
@@ -8,13 +8,15 @@
     "dcli": "dist/bin/dcli.js"
   },
   "files": [
-    "dist/"
+    "dist/",
+    "!dist/standalone"
   ],
   "engines": {
     "node": ">=18"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/build-bundle.mjs",
+    "build:bundle": "node scripts/build-bundle.mjs",
     "dev": "tsx src/bin/dcli.ts",
     "test": "vitest run",
     "test:watch": "vitest",