openpond 0.0.30-bootstrap.0

package/CHANGELOG.md

@@ -0,0 +1,128 @@
+# openpond
+
+## 0.5.3
+
+### Patch Changes
+
+- 812a6dc: Fix env handling and add more hosted-workspace support.
+
+## 0.5.2
+
+### Patch Changes
+
+- 9f9094a: Remove managed database declarations from the hosted workspace template and create/fork request contracts. Templates should use durable volumes with SQLite or files for structured workspace state.
+
+  Add template startup validation so template authors can validate the current manifest, sync the local repo through OpenPond Git, create a hosted workspace with declared resources and volumes, upload declared file inputs, and run the selected start/action/service command with replay params.
+
+## 0.5.1
+
+### Patch Changes
+
+- 2281254: renamed yaml file
+
+## 0.5.0
+
+### Minor Changes
+
+- 74a6833: Add hosted workspaces.
+
+## 0.4.0
+
+### Minor Changes
+
+- f5646cb: added balances
+
+## 0.3.5
+
+### Patch Changes
+
+- bf8b0e6: added more agent controls
+
+## 0.3.4
+
+### Patch Changes
+
+- 36f0422: added chat
+
+## 0.3.3
+
+### Patch Changes
+
+- 37b3a33: fixed missing listappschedles
+
+## 0.3.2
+
+### Patch Changes
+
+- 5c9db6b: fixed account active
+
+## 0.3.1
+
+### Patch Changes
+
+- 32ae02a: api base url
+- 32ae02a: Add profile-specific API base URL config and remove hardcoded environment endpoint mappings from the CLI/runtime bundle.
+
+## 0.3.0
+
+### Minor Changes
+
+- bb4018e: updated docs
+
+## 0.2.4
+
+### Patch Changes
+
+- 4cac928: Add public account, API health, and redacted local profile config helpers.
+
+## 0.2.3
+
+### Patch Changes
+
+- 59a2c17: remove cli device code login
+
+## 0.2.2
+
+### Patch Changes
+
+- 0212347: added version command
+
+## 0.2.1
+
+### Patch Changes
+
+- d1479e9: updated base url
+
+## 0.2.0
+
+### Minor Changes
+
+- b6e5f07: added multi accounts
+
+## 0.1.4
+
+### Patch Changes
+
+- bb79cf8: cleaned up naming
+
+## 0.1.3
+
+### Patch Changes
+
+- 96cbdc6: depreciated templateid
+
+## 0.1.2
+
+### Patch Changes
+
+- 176a699: updated endpoints
+
+## 0.1.1
+
+### Patch Changes
+
+- 05f2e19: testing github push
+
+## 0.1.0
+
+- Initial release of the API key CLI.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenPond contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,162 @@
+# openpond
+
+OpenPond CLI
+
+The generated [command reference](./docs/command-reference.md) is the authoritative command and option inventory.
+
+Install:
+
+```bash
+npm i -g openpond
+# or
+npx --package openpond openpond tool list handle/repo
+# or (curl installer)
+curl -fsSL https://openpond.ai/install.sh | bash
+```
+
+Login (stores key in `~/.openpond/config.json`):
+
+```bash
+openpond login
+# or (non-interactive)
+openpond login --api-key opk_...
+# or save under an account profile
+openpond login --account production --api-key opk_prod_...
+openpond login --account secondary --api-key opk_secondary_...
+```
+
+Commands:
+
+```bash
+openpond --version
+openpond --check-update
+openpond profiles list
+openpond profiles use production
+openpond profiles save secondary --api-key opk_...
+openpond account
+openpond health
+openpond --account production apps list
+openpond tool list <handle>/<repo>
+openpond tool run <handle>/<repo> <tool> --body '{"foo":"bar"}'
+openpond deploy watch <handle>/<repo> --branch main
+openpond template status <handle>/<repo>
+openpond template branches <handle>/<repo>
+openpond template update <handle>/<repo> --env production
+openpond repo create --name my-repo --path .
+openpond repo push --path . --branch main
+openpond apps list [--handle <handle>] [--refresh] [--json]
+openpond apps tools
+openpond apps deploy <handle>/<repo> --env production --watch
+openpond apps env get <handle>/<repo>
+openpond apps env set <handle>/<repo> --env '{"OPENTOOL_PUBLIC_HL_SIGNAL_BOT_CONFIG":"..."}'
+openpond apps performance [--app-id <id>]
+openpond apps agent create --prompt "Build a daily digest agent"
+openpond apps tools execute <appId> <deploymentId> <tool> --body '{"foo":"bar"}'
+openpond apps positions tx --method GET --params '{"status":"open"}'
+openpond opentool init --dir .
+```
+
+Global account selection:
+
+- `--account <name>` (alias `--profile <name>`) selects which stored account/API key to use.
+- `--base-url <url>` (alias `--baseurl`) selects the account entry matching that base URL when duplicate handles exist.
+- `OPENPOND_ACCOUNT=<name>` sets the default selected account for a shell/session.
+- If omitted, CLI uses the last active stored account.
+
+Command reference:
+
+- `openpond login`: prompt for API key and save to `~/.openpond/config.json`.
+- `openpond login --api-key <key>`: save the API key without prompting.
+- `openpond profiles list`: list redacted local profiles from `~/.openpond/config.json`.
+- `openpond profiles use <name> [--base-url <url>]`: switch the active local profile.
+- `openpond profiles save <name> --api-key <key> [--base-url <url>] [--environment <name>]`: save or update a local profile API key.
+- `openpond account`: fetch current account/profile fields and active products for the selected API key.
+- `openpond health`: check public API reachability and selected API-key auth health when a key is configured.
+- `openpond tool list <handle>/<repo>`: list tools for the latest deployment.
+- `openpond tool run <handle>/<repo> <tool> [--body <json>] [--method <METHOD>]`: run a tool on the latest deployment.
+- `openpond deploy watch <handle>/<repo> [--branch <branch>]`: stream deployment logs for the latest deployment.
+- `openpond template status <handle>/<repo>`: check whether a template update is available.
+- `openpond template branches <handle>/<repo>`: list available template branches.
+- `openpond template update <handle>/<repo> [--env preview|production]`: deploy the latest template commit.
+- `openpond repo create --name <name> [--path <dir>] [--empty|--opentool] [--deploy-on-push]`: create an OpenPond repo and attach the git remote.
+- `openpond repo push [--path <dir>] [--branch <branch>]`: push the current git branch using a tokenized remote (non-interactive, restores origin after push).
+- `openpond apps list [--handle <handle>] [--refresh] [--json]`: list apps for your account, optionally filtered by handle.
+- `openpond apps tools`: list tools for your account (public API).
+- `openpond apps deploy <handle>/<repo> [--env preview|production] [--watch]`: trigger a deployment for an app.
+- `openpond apps env get <handle>/<repo>`: get OPENTOOL_PUBLIC_* env vars for an app.
+- `openpond apps env set <handle>/<repo> --env <json>`: set OPENTOOL_PUBLIC_* env vars for an app.
+- `openpond apps performance [--app-id <id>]`: fetch performance summary, optionally scoped to an app.
+- `openpond apps agent create --prompt <text> [--template-id <id>]`: create an agent from a prompt (streams deploy logs by default).
+- `openpond apps tools execute <appId> <deploymentId> <tool> [--body <json>] [--method <METHOD>] [--headers <json>]`: execute a tool for a specific deployment.
+- `openpond apps positions tx [--method <GET|POST>] [--body <json>] [--params <json>]`: read or submit positions.
+- `openpond opentool <init|validate|build> [args]`: run OpenTool CLI commands via `npx opentool`.
+
+Agent source/edit status:
+
+- `openpond agent edit check-status <workItemId> --team-id <id> [--limit <n>] [--json]`: return the compact source-check status for an agent edit work item.
+- `openpond agent source check-status <workItemId> --team-id <id> [--limit <n>] [--json]`: alias for the same work-item status projection under the source command group.
+- The machine-readable status contract is documented in [`docs/agent-edit-check-status-json.md`](docs/agent-edit-check-status-json.md).
+
+## TypeScript package
+
+Programmatic API that mirrors the CLI command surface:
+
+```ts
+import {
+  createClient,
+  listConfiguredProfiles,
+  saveProfileApiKey,
+  setActiveProfile,
+} from "openpond";
+
+const client = createClient({ apiKey: process.env.OPENPOND_API_KEY! });
+
+const { tools } = await client.tool.list("handle/repo");
+const result = await client.tool.run("handle/repo", "myTool", {
+  body: { foo: "bar" },
+});
+
+const apps = await client.apps.list();
+const account = await client.account.get();
+const balance = await client.account.balance();
+const health = await client.account.health();
+const accountTools = await client.apps.tools();
+const performance = await client.apps.performance({ appId: "app_123" });
+const repo = await client.repo.create({ name: "my-repo", repoInit: "empty" });
+
+const profiles = await listConfiguredProfiles();
+await setActiveProfile("0xglu", { baseUrl: "https://openpond.ai" });
+await saveProfileApiKey({
+  handle: "secondary",
+  apiKey: "opk_...",
+  baseUrl: "https://openpond.ai",
+});
+
+await client.apps.agentCreate(
+  { prompt: "Build a daily digest agent" },
+  {
+    onItems: (items) => {
+      for (const item of items) {
+        console.log(item);
+      }
+    },
+  }
+);
+```
+
+You can override hosts with `apiUrl` and `toolUrl` in `createClient`, or
+via `OPENPOND_API_URL` and `OPENPOND_TOOL_URL`.
+
+Examples live in `examples`.
+
+
+## Run
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Cache:
+
+- `~/.openpond/cache.json` caches app/tool lists for 1 hour and refreshes automatically on next use.

package/RELEASE.md

@@ -0,0 +1,20 @@
+# Release Workflow
+
+The root stable-release workflow publishes this package to npm after every supported Desktop package and smoke report passes.
+
+## Setup required
+
+### npm trusted publisher
+Configure npm trusted publishing for this GitHub repository/workflow.
+
+## Release workflow
+
+1. Run `pnpm release:patch`, `pnpm release:minor`, or `pnpm release:major` from a clean `master` checkout.
+2. The command creates `feat/release-vX.Y.Z`, updates every versioned workspace, runs the full checks, commits, pushes the branch, and opens a release PR. It never pushes `master` or creates a tag locally.
+3. Merge the release PR after its required checks pass. The merge automatically starts `.github/workflows/release-builds.yml` for that exact `master` commit.
+4. The workflow waits for the required `Checks` result on `master`, then builds and smokes Linux/macOS Desktop and CLI artifacts on x64 and arm64.
+5. After the smoke reports pass, the workflow creates the tag, publishes `apps/cli` with npm provenance when configured, and publishes the GitHub release with `SHA256SUMS.txt`.
+
+`pnpm release:stable` is a manual recovery command for a checked-in version whose stable tag does not exist. Normal releases do not require it; rerun an existing failed workflow when its tag already exists.
+
+Nightly releases publish GitHub artifacts but do not publish an npm version.

package/dist/api/core.d.ts

@@ -0,0 +1,22 @@
+export declare const LONG_STREAM_API_OPTIONS: {
+    readonly timeoutMs: number;
+    readonly maxResponseBytes: number;
+};
+export type ApiFetchOptions = RequestInit & {
+    timeoutMs?: number;
+    maxResponseBytes?: number;
+};
+export declare class ApiTimeoutError extends Error {
+    readonly timeoutMs: number;
+    readonly requestUrl: string;
+    readonly code = "OPENPOND_API_TIMEOUT";
+    constructor(timeoutMs: number, requestUrl: string);
+}
+export declare class ApiResponseTooLargeError extends Error {
+    readonly maximumBytes: number;
+    readonly requestUrl: string;
+    readonly code = "OPENPOND_API_RESPONSE_TOO_LARGE";
+    constructor(maximumBytes: number, requestUrl: string);
+}
+export declare function apiFetch(baseUrl: string, token: string | null, requestPath: string, options?: ApiFetchOptions): Promise<Response>;
+export declare function readApiJson<T>(response: Response, label: string): Promise<T>;

package/dist/api/deployments.d.ts

@@ -0,0 +1,30 @@
+import type { DeploymentDetail, DeploymentLogEntry, PromotePreviewToProductionRequest, PromotePreviewToProductionResponse, StartAppLifecycleRequest, StartAppLifecycleResponse } from "./types.js";
+export declare function commitFiles(baseUrl: string, token: string, appId: string, files: Record<string, string>, commitMessage: string): Promise<{
+    commitSha: string;
+}>;
+export declare function deployApp(baseUrl: string, token: string, appId: string, input?: {
+    environment?: "preview" | "production";
+    commitSha?: string;
+    branch?: string;
+}): Promise<{
+    deploymentId: string;
+    environment?: "preview" | "production";
+    url?: string;
+    version?: number;
+    commitSha?: string;
+}>;
+export declare function promotePreviewToProduction(baseUrl: string, token: string, appId: string, input: PromotePreviewToProductionRequest): Promise<PromotePreviewToProductionResponse>;
+export declare function startAppLifecycle(baseUrl: string, token: string, appId: string, input: StartAppLifecycleRequest): Promise<StartAppLifecycleResponse>;
+export declare function getDeploymentLogs(apiBase: string, token: string, deploymentId: string): Promise<DeploymentLogEntry[]>;
+export declare function getDeploymentStatus(apiBase: string, token: string, deploymentId: string): Promise<{
+    status?: string;
+}>;
+export declare function getLatestDeploymentForApp(apiBase: string, token: string, appId: string, options?: {
+    status?: string[];
+    createdAfter?: string;
+    branch?: string;
+}): Promise<{
+    id?: string;
+    status?: string;
+} | null>;
+export declare function getDeploymentDetail(apiBase: string, token: string, deploymentId: string): Promise<DeploymentDetail | null>;