@dayofweek/dcli 1.5.0 → 1.7.0

package/dist/client.d.ts

@@ -108,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;
@@ -159,6 +163,49 @@ 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
@@ -217,6 +264,60 @@ export declare class DayOfWeekClient {
         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;
@@ -232,6 +333,20 @@ export declare class DayOfWeekClient {
         version: string;
         hash: string;
     }>>;
+    listSharedSkills(): Promise<SharedSkillSummary[]>;
+    getSharedSkill(skillId: string): Promise<SharedSkillBundle>;
+    publishSharedSkill(input: {
+        areaId: string;
+        name: string;
+        version: string;
+        description?: string;
+        visibility: "area" | "company" | "global";
+        files: Array<{
+            path: string;
+            content: string;
+        }>;
+    }): Promise<SharedSkillSummary>;
+    archiveSharedSkill(skillId: string): Promise<SharedSkillSummary>;
     getSchema(): Promise<any>;
     private get;
     private post;
@@ -298,3 +413,26 @@ export type BrainResolvedResource = {
     resourceType: "source";
     source: BrainSource;
 };
+export type SharedSkillSummary = {
+    id: string;
+    areaId: string;
+    areaName: string;
+    name: string;
+    version: string;
+    description?: string;
+    hash: string;
+    visibility: "area" | "company" | "global";
+    revision: number;
+    fileCount: number;
+    byteSize: number;
+    uri: string;
+    httpsUrl: string;
+    updatedAt: number;
+};
+export type SharedSkillBundle = Omit<SharedSkillSummary, "fileCount" | "byteSize"> & {
+    files: Array<{
+        path: string;
+        content: string;
+        sha256: string;
+    }>;
+};

package/dist/client.js

@@ -189,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)
@@ -197,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();
@@ -209,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}` : ""}`);
     }
@@ -218,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();
@@ -236,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}` : ""}`);
     }
@@ -288,6 +300,52 @@ 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
@@ -370,6 +428,83 @@ export class DayOfWeekClient {
             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)}` : ""}`);
@@ -377,6 +512,23 @@ export class DayOfWeekClient {
     async listSkillBundles() {
         return this.get("/skill?list=1");
     }
+    // ── Shared skills ─────────────────────────────────────────────────────────
+    //
+    // Skills other users published into shared knowledge areas. Discovery is
+    // server-owned, like the named bundles above: the CLI ships no skill names,
+    // and the server decides which skills this device's user may see.
+    async listSharedSkills() {
+        return this.get("/brain/skills");
+    }
+    async getSharedSkill(skillId) {
+        return this.get(`/brain/skills/${encodeURIComponent(skillId)}`);
+    }
+    async publishSharedSkill(input) {
+        return this.post("/brain/skills", input);
+    }
+    async archiveSharedSkill(skillId) {
+        return this.delete(`/brain/skills/${encodeURIComponent(skillId)}`);
+    }
     // ── Schema ────────────────────────────────────────────────────────────────
     async getSchema() {
         return this.get("/schema");

package/dist/skills.d.ts

@@ -8,8 +8,31 @@ export type SkillBundle = {
         sha256?: string;
     }>;
 };
+/**
+ * Where an installed skill came from — recorded in `.dayofweek-skill.json` so
+ * `skill update` and `skill status --check` can go back to the same origin.
+ * "platform" = a named bundle from the built-in endpoint; "shared" = a skill
+ * another user published into a shared knowledge area.
+ */
+export type SkillOrigin = {
+    source: "platform";
+} | {
+    source: "shared";
+    skillId: string;
+    areaId: string;
+    uri: string;
+};
+export type InstalledSkillMetadata = {
+    name: string;
+    version: string;
+    hash: string;
+    files: Record<string, string>;
+    origin?: SkillOrigin;
+};
+/** Parse `<dir>/.dayofweek-skill.json`; null when absent or malformed. */
+export declare function readInstalledSkill(targetDir: string): InstalledSkillMetadata | null;
 export declare function validateSkillBundle(bundle: SkillBundle): SkillBundle;
-export declare function writeSkillBundle(input: SkillBundle, targetDir: string): {
+export declare function writeSkillBundle(input: SkillBundle, targetDir: string, origin?: SkillOrigin): {
     written: number;
     unchanged: number;
     conflicts: string[];

package/dist/skills.js

@@ -1,6 +1,21 @@
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+/** Parse `<dir>/.dayofweek-skill.json`; null when absent or malformed. */
+export function readInstalledSkill(targetDir) {
+    const metadataPath = join(targetDir, ".dayofweek-skill.json");
+    if (!existsSync(metadataPath))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(metadataPath, "utf8"));
+        if (typeof parsed.name !== "string" || typeof parsed.version !== "string")
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
 function sha256(value) {
     return createHash("sha256").update(value).digest("hex");
 }
@@ -33,7 +48,7 @@ export function validateSkillBundle(bundle) {
         throw new Error("Skill bundle manifest checksum mismatch");
     return { ...bundle, hash: actualBundleHash, files };
 }
-export function writeSkillBundle(input, targetDir) {
+export function writeSkillBundle(input, targetDir, origin) {
     const bundle = validateSkillBundle(input);
     let filesWritten = 0;
     let unchanged = 0;
@@ -72,6 +87,6 @@ export function writeSkillBundle(input, targetDir) {
         filesWritten++;
     }
     mkdirSync(targetDir, { recursive: true });
-    writeFileSync(metadataPath, JSON.stringify({ name: bundle.name, version: bundle.version, hash: bundle.hash, files: hashes }, null, 2), "utf8");
+    writeFileSync(metadataPath, JSON.stringify({ name: bundle.name, version: bundle.version, hash: bundle.hash, files: hashes, ...(origin ? { origin } : {}) }, null, 2), "utf8");
     return { written: filesWritten, unchanged, conflicts };
 }

package/dist/uri.d.ts

@@ -1,7 +1,7 @@
 export type BrainResource = {
     version: 1;
     areaId: string;
-    resourceType: "area" | "note" | "source";
+    resourceType: "area" | "note" | "source" | "skill";
     resourceId?: string;
 };
 export declare function parseBrainResource(input: string): BrainResource;

package/dist/uri.js

@@ -21,7 +21,7 @@ function parseSegments(pathname) {
         throw new Error("Unsupported brain URI form");
     const areaId = assertId(segments[0], "area ID");
     const resourceType = segments[1];
-    if (resourceType !== "note" && resourceType !== "source") {
+    if (resourceType !== "note" && resourceType !== "source" && resourceType !== "skill") {
         throw new Error("Unsupported brain resource type");
     }
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dayofweek/dcli",
-  "version": "1.5.0",
+  "version": "1.7.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",