epismo 0.1.2 → 0.1.4

package/README.md

@@ -4,6 +4,18 @@ GitHub made code reusable. Hugging Face made models reusable. Epismo makes human
 
 Capture how you got your best results — not just the output — and share them as executable workflows that agents and humans can discover, adapt, and run across projects.
 
+## CLI Contract
+
+Epismo CLI is designed for agents first.
+
+- Non-interactive runs default to machine-readable JSON.
+- Interactive TTY runs also keep success output machine-readable on `stdout`.
+- `stderr` is used for prompts, browser-login guidance, and error output.
+- Exit code `0` indicates success. Any non-zero exit code indicates failure.
+
+In interactive sessions, the CLI may prompt on `stderr`.
+In non-interactive environments, commands that need prompts fail fast instead of waiting for input.
+
 ## Install
 
 ```bash
@@ -19,38 +31,43 @@ npx epismo <command>
 ## Authentication
 
 ```bash
-epismo login                                      # OTP (prompts for email + code)
-epismo login --email you@example.com --pin 123456 # inline values
-epismo login --browser                            # OAuth via browser
-epismo logout                                     # clear local credentials
+epismo login                                         # OTP (prompts for email + code)
+epismo login --email you@example.com --otp 123456    # inline values
+epismo login --browser                               # OAuth via browser
+epismo logout                                        # clear local credentials
+EPISMO_TOKEN=<access-token> epismo whoami            # preferred for scripts
 ```
 
+If `EPISMO_TOKEN` is set, the CLI uses it instead of stored credentials.
+
+When `EPISMO_TOKEN` is active, the saved default workspace is ignored unless you pass `--workspace-id`.
+
 ## Commands
 
 ### `epismo whoami`
 
-Show the current user and accessible workspaces.
+Show the current user, effective workspace context, and accessible workspaces.
 
 ### `epismo workspace`
 
 ```bash
-epismo workspace list                    # list accessible workspaces
-epismo workspace current                 # show saved default
-epismo workspace use <workspace-id>      # set default workspace
-epismo workspace clear                   # clear default workspace
+epismo workspace list                                 # list accessible workspaces
+epismo workspace current                              # show saved default from local config only
+epismo workspace use --workspace-id <workspace-id>    # set default workspace
+epismo workspace clear                                # clear default workspace
 ```
 
 ### `epismo track`
 
-Manage tasks, notes, and goals.
+Manage tasks and goals.
 
 ```bash
 epismo track upsert --type task --title "Fix bug" --content "Details..."
 epismo track upsert --input @task.json
-epismo track get --type task --id <id>
+epismo track get --id <id>
 epismo track search --type task --query "bug" --filter '{"status":["todo"]}'
-epismo track search --type task --query "bug" --view summary
-epismo track delete --type task --id <id>
+epismo track search --type task --query "bug" --view brief
+epismo track delete --id <id>
 ```
 
 ### `epismo asset`
@@ -59,12 +76,26 @@ Manage workflows and other assets.
 
 ```bash
 epismo asset upsert --type workflow --title "My workflow" --input @workflow.json
-epismo asset get --type workflow --id <id>
+epismo asset get --id <id>
+epismo asset get --alias myproject
+epismo asset get --alias @epismo/myproject
 epismo asset search --type workflow --query "onboarding" --filter '{"visibility":["public"]}'
-epismo asset search --type workflow --query "onboarding" --view summary
-epismo asset like --type workflow --id <id> --liked true
-epismo asset import --project-id <project-id> --asset-ids <id1>,<id2>
-epismo asset delete --type workflow --id <id>
+epismo asset search --type workflow --query "onboarding" --view brief
+epismo asset like --id <id> --liked
+epismo asset like --id <id> --no-liked
+epismo asset delete --id <id>    # also removes your aliases for that asset
+```
+
+### `epismo alias`
+
+Manage aliases as a top-level resource.
+
+```bash
+epismo alias upsert --type workflow --id <id> --alias myproject
+epismo alias get --alias myproject
+epismo alias get --alias @epismo/myproject    # another user's alias
+epismo alias list
+epismo alias delete --alias myproject
 ```
 
 ### `epismo credit`
@@ -72,6 +103,7 @@ epismo asset delete --type workflow --id <id>
 ```bash
 epismo credit balance
 epismo credit balance --workspace-id <workspace-id>
+epismo credit checkout --allocations '[{"userId":"<user-id>","quantity":10}]'
 ```
 
 ## Skills
@@ -82,9 +114,11 @@ Browse skills: https://github.com/epismoai/skills
 
 ## Workspace Selection
 
-- `epismo workspace use <workspace-id>` saves the default for all commands.
+- `epismo workspace use --workspace-id <workspace-id>` saves the default for all commands.
 - `--workspace-id <id>` overrides the default for a single command.
 - If neither is set, the CLI operates in personal context.
+- `epismo workspace current` reads only local config and does not require network access.
+- When `EPISMO_TOKEN` is active, saved default workspace selection is ignored unless `--workspace-id` is provided.
 
 ## Input
 
@@ -92,7 +126,28 @@ Browse skills: https://github.com/epismoai/skills
 - `--input @path/to/file.json` — load from file
 - `--input -` — read from stdin
 - Explicit flags override fields from `--input`
+- Enum-like flags are validated in the CLI before the request is sent.
 
 ## Output
 
-All commands output JSON by default. Pass `--json` to force JSON when a human-readable summary is also available.
+- Successful command output is JSON on `stdout`.
+- Errors and warnings are written to `stderr` as JSON.
+- Prompts and browser-login guidance are also written to `stderr`.
+
+**Error shape** (`stderr`, exit code ≠ 0):
+
+```json
+{ "error": { "code": "NOT_FOUND", "message": "...", "retryable": false, "hint": "..." } }
+```
+
+**Warning shape** (`stderr`, exit code 0):
+
+```json
+{ "warning": { "code": "UPDATE_AVAILABLE", "message": "..." } }
+```
+
+## Update Checks
+
+Automatic update checks are enabled by default (once per day, shown only in interactive TTY sessions).
+
+- Set `EPISMO_UPDATE_CHECK=0` to disable the background npm version check.

package/dist/aliases.js

@@ -0,0 +1,31 @@
+import { requestJson, withWorkspaceQuery } from "./api.js";
+import { resolveApiUrl } from "./config.js";
+import { readRequiredString, toObjectInput } from "./input.js";
+export async function upsertAlias(context, input) {
+    return requestJson(resolveApiUrl(), withWorkspaceQuery("/v1/aliases", context.workspaceId), {
+        method: "PUT",
+        authToken: context.auth.accessToken,
+        body: toObjectInput(input)
+    });
+}
+export async function getAlias(context, input) {
+    const alias = readRequiredString(input, "alias", "Pass --alias <alias>.");
+    const params = new URLSearchParams();
+    params.set("alias", alias);
+    return requestJson(resolveApiUrl(), withWorkspaceQuery(`/v1/aliases?${params.toString()}`, context.workspaceId), {
+        authToken: context.auth.accessToken
+    });
+}
+export async function listAliases(context) {
+    return requestJson(resolveApiUrl(), withWorkspaceQuery("/v1/aliases", context.workspaceId), {
+        authToken: context.auth.accessToken
+    });
+}
+export async function deleteAlias(context, input) {
+    const alias = readRequiredString(input, "alias", "Pass --alias <alias>.");
+    return requestJson(resolveApiUrl(), withWorkspaceQuery(`/v1/aliases/${encodeURIComponent(alias)}`, context.workspaceId), {
+        method: "DELETE",
+        authToken: context.auth.accessToken
+    });
+}
+//# sourceMappingURL=aliases.js.map

package/dist/aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.js","sourceRoot":"","sources":["../src/aliases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,OAAyB,EACzB,KAAc;IAEd,OAAO,WAAW,CACjB,aAAa,EAAE,EACf,kBAAkB,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,EACtD;QACC,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;QACnC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC;KAC1B,CACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,OAAyB,EACzB,KAAc;IAEd,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,WAAW,CACjB,aAAa,EAAE,EACf,kBAAkB,CAAC,eAAe,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC,EAC3E;QACC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;KACnC,CACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAyB;IAC1D,OAAO,WAAW,CACjB,aAAa,EAAE,EACf,kBAAkB,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,EACtD;QACC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;KACnC,CACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,OAAyB,EACzB,KAAc;IAEd,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAC1E,OAAO,WAAW,CACjB,aAAa,EAAE,EACf,kBAAkB,CAAC,eAAe,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC,EACnF;QACC,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;KACnC,CACD,CAAC;AACH,CAAC"}

package/dist/api.js

@@ -1,3 +1,12 @@
+import { CliError } from "./errors.js";
+export function withWorkspaceQuery(pathname, workspaceId) {
+    if (!workspaceId?.trim()) {
+        return pathname;
+    }
+    const params = new URLSearchParams({ workspaceId: workspaceId.trim() });
+    const separator = pathname.includes("?") ? "&" : "?";
+    return `${pathname}${separator}${params.toString()}`;
+}
 export async function requestJson(apiUrl, pathname, options = {}) {
     const headers = {};
     if (options.body !== undefined) {
@@ -6,11 +15,35 @@ export async function requestJson(apiUrl, pathname, options = {}) {
     if (options.authToken) {
         headers.authorization = `Bearer ${options.authToken}`;
     }
-    const response = await fetch(`${apiUrl}${pathname}`, {
-        method: options.method ?? "GET",
-        headers,
-        body: options.body !== undefined ? JSON.stringify(options.body) : undefined
-    });
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 30_000);
+    let response;
+    try {
+        response = await fetch(`${apiUrl}${pathname}`, {
+            method: options.method ?? "GET",
+            headers,
+            body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+            signal: controller.signal
+        });
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new CliError({
+                code: "REQUEST_TIMEOUT",
+                message: "Request timed out.",
+                retryable: true
+            });
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new CliError({
+            code: "NETWORK_ERROR",
+            message,
+            retryable: true
+        });
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
     const text = await response.text();
     let parsed = {};
     if (text) {
@@ -29,9 +62,39 @@ export async function requestJson(apiUrl, pathname, options = {}) {
             ? payload.error
             : typeof payload.error_description === "string"
                 ? payload.error_description
-                : `HTTP ${response.status}`;
-        throw new Error(message);
+                : typeof payload.message === "string"
+                    ? payload.message
+                    : `HTTP ${response.status}`;
+        throw new CliError({
+            code: mapHttpErrorCode(response.status),
+            message,
+            retryable: response.status >= 500 || response.status === 429,
+            details: {
+                status: response.status,
+                pathname
+            }
+        });
     }
     return parsed;
 }
+function mapHttpErrorCode(status) {
+    switch (status) {
+        case 400:
+            return "BAD_REQUEST";
+        case 401:
+            return "UNAUTHORIZED";
+        case 403:
+            return "FORBIDDEN";
+        case 404:
+            return "NOT_FOUND";
+        case 409:
+            return "CONFLICT";
+        case 422:
+            return "UNPROCESSABLE_ENTITY";
+        case 429:
+            return "RATE_LIMITED";
+        default:
+            return status >= 500 ? "SERVER_ERROR" : "HTTP_ERROR";
+    }
+}
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,MAAc,EACd,QAAgB,EAChB,UAA8B,EAAE;IAEhC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,aAAa,GAAG,UAAU,OAAO,CAAC,SAAS,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,GAAG,QAAQ,EAAE,EAAE;QACpD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,OAAO;QACP,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC3E,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,MAAM,GAAY,EAAE,CAAC;IACzB,IAAI,IAAI,EAAE,CAAC;QACV,IAAI,CAAC;YACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;IACF,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,OAAO,GACZ,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAC7D,CAAC,CAAE,MAAkC;YACrC,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,OAAO,GACZ,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YAChC,CAAC,CAAC,OAAO,CAAC,KAAK;YACf,CAAC,CAAC,OAAO,OAAO,CAAC,iBAAiB,KAAK,QAAQ;gBAC9C,CAAC,CAAC,OAAO,CAAC,iBAAiB;gBAC3B,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,MAAmB,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/assets.js

@@ -1,83 +1,67 @@
-import { requestJson } from "./api.js";
+import { requestJson, withWorkspaceQuery } from "./api.js";
 import { resolveApiUrl } from "./config.js";
-function withWorkspaceQuery(pathname, workspaceId) {
-    if (!workspaceId?.trim()) {
-        return pathname;
-    }
-    const params = new URLSearchParams({ workspaceId: workspaceId.trim() });
-    return `${pathname}?${params.toString()}`;
-}
-function readRequiredId(input) {
-    if (!input || typeof input !== "object") {
-        throw new Error("id is required.");
-    }
-    const id = input.id;
-    if (typeof id !== "string" || !id.trim()) {
-        throw new Error("id is required.");
-    }
-    return id.trim();
-}
-function readRequiredType(input) {
-    if (!input || typeof input !== "object") {
-        throw new Error("type is required.");
-    }
-    const type = input.type;
-    if (typeof type !== "string" || !type.trim()) {
-        throw new Error("type is required.");
-    }
-    return type.trim();
-}
+import { CliError } from "./errors.js";
+import { readAssetReference, readRequiredId, toObjectInput } from "./input.js";
 export async function upsertAsset(context, input) {
-    return requestJson(resolveApiUrl(), "/v1/assets", {
+    return requestJson(resolveApiUrl(), withWorkspaceQuery("/v1/assets", context.workspaceId), {
         method: "PUT",
         authToken: context.auth.accessToken,
-        body: {
-            ...(input && typeof input === "object" ? input : {}),
-            ...(context.workspaceId ? { workspaceId: context.workspaceId } : {})
-        }
+        body: toObjectInput(input)
     });
 }
-export async function getAsset(context, input) {
-    const type = readRequiredType(input);
-    const id = readRequiredId(input);
-    return requestJson(resolveApiUrl(), withWorkspaceQuery(`/v1/assets/${encodeURIComponent(type)}/${encodeURIComponent(id)}`, context.workspaceId), {
+export async function getAsset(context, input, blockId) {
+    const { id, alias } = readAssetReference(input);
+    const requestPath = id !== undefined
+        ? withWorkspaceQuery(`/v1/assets/${encodeURIComponent(id)}`, context.workspaceId)
+        : withWorkspaceQuery(`/v1/assets?alias=${encodeURIComponent(alias ?? "")}`, context.workspaceId);
+    const response = await requestJson(resolveApiUrl(), requestPath, {
         authToken: context.auth.accessToken
     });
+    const asset = response.asset && typeof response.asset === "object" && !Array.isArray(response.asset)
+        ? response.asset
+        : response;
+    if (blockId !== undefined) {
+        const blocks = asset["blocks"];
+        if (!Array.isArray(blocks)) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "Asset does not contain context blocks (--block-id requires type=context)."
+            });
+        }
+        const block = blocks.find((n) => typeof n === "object" &&
+            n !== null &&
+            n["id"] === blockId);
+        if (block === undefined) {
+            throw new CliError({
+                code: "NOT_FOUND",
+                message: `Context block '${blockId}' not found in context asset '${id ?? alias}'.`
+            });
+        }
+        return block;
+    }
+    return asset;
 }
 export async function searchAssets(context, input) {
     return requestJson(resolveApiUrl(), withWorkspaceQuery("/v1/assets/search", context.workspaceId), {
         method: "POST",
         authToken: context.auth.accessToken,
-        body: {
-            ...(input && typeof input === "object" ? input : {}),
-            ...(context.workspaceId ? { workspaceId: context.workspaceId } : {})
-        }
+        body: toObjectInput(input)
     });
 }
 export async function likeAsset(context, input) {
+    const id = readRequiredId(input);
     return requestJson(resolveApiUrl(), withWorkspaceQuery("/v1/assets/like", context.workspaceId), {
         method: "POST",
         authToken: context.auth.accessToken,
         body: {
-            ...(input && typeof input === "object" ? input : {}),
-            ...(context.workspaceId ? { workspaceId: context.workspaceId } : {})
-        }
-    });
-}
-export async function importAssets(context, input) {
-    return requestJson(resolveApiUrl(), withWorkspaceQuery("/v1/assets/import", context.workspaceId), {
-        method: "POST",
-        authToken: context.auth.accessToken,
-        body: {
-            ...(input && typeof input === "object" ? input : {}),
-            ...(context.workspaceId ? { workspaceId: context.workspaceId } : {})
+            ...toObjectInput(input),
+            id
         }
     });
 }
 export async function deleteAsset(context, input) {
-    const type = readRequiredType(input);
     const id = readRequiredId(input);
-    return requestJson(resolveApiUrl(), withWorkspaceQuery(`/v1/assets/${encodeURIComponent(type)}/${encodeURIComponent(id)}`, context.workspaceId), {
+    return requestJson(resolveApiUrl(), withWorkspaceQuery(`/v1/assets/${encodeURIComponent(id)}`, context.workspaceId), {
         method: "DELETE",
         authToken: context.auth.accessToken
     });

package/dist/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"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"}