@promptdriven/pds 0.1.0

package/README.md

@@ -0,0 +1,110 @@
+# pds CLI
+
+`pds` is the scriptable Prompt Driven Studio control plane for local operators,
+CI jobs, and AI agents. It talks to the webapp agent API; it does not run
+generation, upload, or provider code directly.
+
+## Install From npm
+
+```bash
+npm install -g @promptdriven/pds
+pds --version
+```
+
+Node.js 20 or newer is required.
+
+## Local Development Pack
+
+```bash
+cd cli/pds
+npm run pack:check
+packed_tarball="$(npm pack --json | node -e "const fs = require('node:fs'); const pack = JSON.parse(fs.readFileSync(0, 'utf8')); process.stdout.write(pack[0].filename);")"
+npm install -g "./${packed_tarball}"
+pds --version
+```
+
+Use the local pack path only when testing unpublished changes from a checkout.
+
+## Auth Setup
+
+Use a profile for day-to-day local use:
+
+```bash
+pds --api-url http://localhost:3000 --profile local auth login
+pds --profile local auth status --json
+```
+
+For CI, create a least-privilege scoped token from an owner account.
+Include `project:create` if the token must bootstrap new projects
+(e.g. for `pds release-video create` or `pds projects create`):
+
+```bash
+pds auth token create \
+  --label release-bot \
+  --project release-project-id \
+  --scopes project:create,project:read,project:write,pipeline:run,artifact:read,distribution:package,distribution:publish \
+  --expires-in 30d \
+  --json
+pds auth token list --json
+```
+
+A token with `project:create` can create new projects that were not listed at
+mint time. Store only the one-time `rawToken` in the CI secret store, then pass
+it as `PDS_TOKEN`. YouTube OAuth credentials stay server-side and must not be
+stored in CLI config.
+
+## Release Video
+
+```bash
+PDS_API_URL=https://studio.example.com \
+PDS_TOKEN="$PDS_RELEASE_TOKEN" \
+pds release-video create \
+  --project-name release-v1.8.0 \
+  --script release_video_script.md \
+  --release-notes CHANGELOG.md \
+  --changelog CHANGELOG.full.md \
+  --repo-url https://github.com/promptdriven/studio \
+  --repo-name promptdriven/studio \
+  --git-sha "$GITHUB_SHA" \
+  --release-tag v1.8.0 \
+  --preset release-notes \
+  --target publish \
+  --platform youtube \
+  --privacy unlisted \
+  --idempotency-key "release:v1.8.0:$GITHUB_SHA" \
+  --wait \
+  --json
+```
+
+Add `--dry-run` to inspect the release workflow without starting server-side
+generation or publish work.
+
+## Scripts
+
+```bash
+pds script set --project release-v1.8.0 --file release_video_script.md --idempotency-key release:v1.8.0:script --json
+pds script set --project release-v1.8.0 --file tts_script.md --target tts --idempotency-key release:v1.8.0:tts-script --json
+```
+
+`script set` writes the main script by default. The only alternate target is
+`tts`; unsupported targets fail locally before the API request.
+
+For direct uploads,
+`pds distribution publish --privacy unlisted --idempotency-key <key> --wait`
+refreshes the Stage 13 package before upload. Add `--no-generate` to require an
+existing ready package, or `--dry-run` to plan without packaging or uploading.
+
+Server-side idempotency is atomic and non-dry-run mutating release commands
+require `--idempotency-key`. Agent token records are durable on the service.
+
+Use `--json` for one final JSON object and `jobs watch --jsonl` for one event
+object per line.
+
+## Checks
+
+```bash
+npm --prefix cli/pds test
+npm --prefix cli/pds run smoke:pack
+```
+
+The root shortcut is `npm run test:pds-cli`.

package/bin/pds

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+"use strict";
+
+const { runFromProcess } = require("../dist/main.js");
+
+void runFromProcess();

package/dist/args/parser.d.ts

@@ -0,0 +1,19 @@
+export type GlobalOptions = {
+    apiUrl?: string;
+    token?: string;
+    profile?: string;
+    projectId?: string;
+    json?: boolean;
+    jsonl?: boolean;
+    noColor?: boolean;
+    timeout?: string;
+    verbose?: boolean;
+    version?: boolean;
+    help?: boolean;
+};
+export type ParsedInvocation = {
+    globalOptions: GlobalOptions;
+    commandPath: string[];
+    commandArgs: string[];
+};
+export declare function parseInvocation(argv: string[]): ParsedInvocation;

package/dist/args/parser.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseInvocation = parseInvocation;
+const errors_1 = require("../errors/errors");
+const stringGlobals = {
+    "api-url": "apiUrl",
+    token: "token",
+    profile: "profile",
+    project: "projectId",
+    timeout: "timeout"
+};
+const booleanGlobals = {
+    json: "json",
+    jsonl: "jsonl",
+    "no-color": "noColor",
+    verbose: "verbose",
+    version: "version",
+    help: "help"
+};
+const knownCommandPaths = [
+    ["auth", "login"],
+    ["auth", "status"],
+    ["auth", "logout"],
+    ["auth", "token", "create"],
+    ["auth", "token", "list"],
+    ["auth", "token", "revoke"],
+    ["projects", "create"],
+    ["project", "get"],
+    ["project", "reset-pipeline"],
+    ["script", "get"],
+    ["script", "set"],
+    ["artifacts", "list"],
+    ["pipeline", "plan"],
+    ["pipeline", "run"],
+    ["pipeline", "status"],
+    ["jobs", "watch"],
+    ["jobs", "cancel"],
+    ["distribution", "generate"],
+    ["distribution", "status"],
+    ["distribution", "publish"],
+    ["distribution", "connections", "list"],
+    ["distribution", "connection", "select"],
+    ["release-video", "create"],
+    ["release-video", "status"]
+];
+function parseInvocation(argv) {
+    const globalOptions = {};
+    const commandTokens = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === "--") {
+            commandTokens.push(...argv.slice(index + 1));
+            break;
+        }
+        if (!token.startsWith("--") || token === "--") {
+            commandTokens.push(token);
+            continue;
+        }
+        const optionText = token.slice(2);
+        const equalsIndex = optionText.indexOf("=");
+        const optionName = equalsIndex === -1 ? optionText : optionText.slice(0, equalsIndex);
+        const inlineValue = equalsIndex === -1 ? undefined : optionText.slice(equalsIndex + 1);
+        const stringKey = stringGlobals[optionName];
+        if (stringKey) {
+            const value = inlineValue ?? argv[index + 1];
+            if (!value || value.startsWith("--")) {
+                throw new errors_1.CliError(`Missing value for --${optionName}`, { code: "missing_option_value", exitCode: errors_1.EXIT_CODES.usage });
+            }
+            globalOptions[stringKey] = value;
+            if (inlineValue === undefined) {
+                index += 1;
+            }
+            continue;
+        }
+        const booleanKey = booleanGlobals[optionName];
+        if (booleanKey) {
+            globalOptions[booleanKey] = true;
+            continue;
+        }
+        commandTokens.push(token);
+    }
+    if (globalOptions.json && globalOptions.jsonl) {
+        throw new errors_1.CliError("Use only one of --json or --jsonl", {
+            code: "conflicting_output_modes",
+            exitCode: errors_1.EXIT_CODES.usage
+        });
+    }
+    const commandPath = findCommandPath(commandTokens);
+    return {
+        globalOptions,
+        commandPath,
+        commandArgs: commandTokens.slice(commandPath.length)
+    };
+}
+function findCommandPath(tokens) {
+    const prefix = [];
+    for (const token of tokens) {
+        if (token.startsWith("-")) {
+            break;
+        }
+        prefix.push(token);
+    }
+    let bestMatch = [];
+    for (const commandPath of knownCommandPaths) {
+        if (commandPath.length > prefix.length) {
+            continue;
+        }
+        if (commandPath.every((part, index) => prefix[index] === part) && commandPath.length > bestMatch.length) {
+            bestMatch = commandPath;
+        }
+    }
+    return bestMatch.length > 0 ? bestMatch : prefix;
+}
+//# sourceMappingURL=parser.js.map

package/dist/args/parser.js.map

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

package/dist/client/api-client.d.ts

@@ -0,0 +1,53 @@
+import { PDS_API_VERSION } from "../version";
+import type { CreateProjectRequest, CreateTokenRequest, DeviceLoginCompleteRequest, DeviceLoginStartRequest, DistributionRequest, DistributionConnectionListRequest, DistributionConnectionSelectRequest, JobRequest, PdsClient, PipelineRequest, ResetPipelineRequest, PipelineStatusRequest, ReleaseVideoRequest, RevokeTokenRequest, ScriptGetRequest, ScriptSetRequest } from "./types";
+export { PDS_API_VERSION };
+type FetchImpl = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export type PdsApiClientOptions = {
+    apiUrl: string;
+    token?: string;
+    timeoutMs: number;
+    fetchImpl?: FetchImpl;
+    clientVersion?: string;
+    sleepImpl?: (ms: number) => Promise<void>;
+    maxWatchReconnects?: number;
+};
+export declare class PdsApiClient implements PdsClient {
+    private readonly apiUrl;
+    private readonly token;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    private readonly clientVersion;
+    private readonly sleepImpl;
+    private readonly maxWatchReconnects;
+    constructor(options: PdsApiClientOptions);
+    getVersion(): Promise<unknown>;
+    getAuthStatus(): Promise<unknown>;
+    createProject(request: CreateProjectRequest): Promise<unknown>;
+    getProject(projectId: string): Promise<unknown>;
+    getScript(request: ScriptGetRequest): Promise<unknown>;
+    setScript(request: ScriptSetRequest): Promise<unknown>;
+    listArtifacts(projectId: string): Promise<unknown>;
+    planPipeline(request: PipelineRequest): Promise<unknown>;
+    runPipeline(request: PipelineRequest): Promise<unknown>;
+    resetPipeline(request: ResetPipelineRequest): Promise<unknown>;
+    getPipelineStatus(request: PipelineStatusRequest): Promise<unknown>;
+    watchJob(request: JobRequest): Promise<unknown>;
+    getJob(request: JobRequest): Promise<unknown>;
+    cancelJob(request: JobRequest): Promise<unknown>;
+    startDeviceLogin(request: DeviceLoginStartRequest): Promise<unknown>;
+    completeDeviceLogin(request: DeviceLoginCompleteRequest): Promise<unknown>;
+    createToken(request: CreateTokenRequest): Promise<unknown>;
+    listTokens(): Promise<unknown>;
+    revokeToken(request: RevokeTokenRequest): Promise<unknown>;
+    generateDistribution(request: DistributionRequest): Promise<unknown>;
+    getDistributionStatus(request: DistributionRequest): Promise<unknown>;
+    publishDistribution(request: DistributionRequest): Promise<unknown>;
+    listDistributionConnections(request: DistributionConnectionListRequest): Promise<unknown>;
+    selectDistributionConnection(request: DistributionConnectionSelectRequest): Promise<unknown>;
+    createReleaseVideo(request: ReleaseVideoRequest): Promise<unknown>;
+    private request;
+    private requestOnce;
+    private requestText;
+    private requestNdjson;
+    private fetchResponse;
+}