openpond-code 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # openpond-code
 
+## 0.1.3
+
+### Patch Changes
+
+- 96cbdc6: depreciated templateid
+
+## 0.1.2
+
+### Patch Changes
+
+- 176a699: updated endpoints
+
 ## 0.1.1
 
 ### Patch Changes

package/dist/api.d.ts

@@ -24,7 +24,6 @@ export declare function startDeviceLogin(baseUrl: string): Promise<DeviceStartRe
 export declare function pollDeviceLogin(baseUrl: string, deviceCode?: string, userCode?: string): Promise<DevicePollResponse>;
 export type CreateLocalProjectInput = {
     name: string;
-    templateId?: string;
     templateRepoUrl?: string;
     templateBranch?: string;
     envVars?: Record<string, string>;
@@ -50,7 +49,6 @@ export type CreateRepoResponse = {
 export type HeadlessAppRequest = {
     name?: string;
     description?: string;
-    templateId?: string;
     templateRepoUrl?: string;
     templateBranch?: string;
     templateName?: string;
@@ -125,6 +123,96 @@ export type AppListItem = {
         gitBranch: string | null;
     } | null;
 };
+export type AppRuntimeSummary = {
+    app: {
+        appId: string;
+        name: string;
+        description: string | null;
+        teamId: string;
+        templateRepoUrl: string | null;
+        templateBranch: string | null;
+        initialPromptSnapshot: string | null;
+    };
+    runtime: {
+        latestDeployment: {
+            id: string;
+            status: string;
+            isProduction: boolean | null;
+            createdAt: string;
+        } | null;
+        schedules: {
+            total: number;
+            enabled: number;
+            disabled: number;
+        };
+        notifications: {
+            scheduleEmailsEnabled: boolean;
+            scheduleTweetsEnabled: boolean;
+        };
+        toolNotifyEmail: {
+            notifyEmailEnabledCount: number;
+            toolsConfiguredCount: number;
+        };
+        lastScheduleRun: {
+            id: string;
+            status: string;
+            executionTime: string;
+            scheduleName: string;
+            errorMessage: string | null;
+        } | null;
+        lastToolRun: {
+            id: string;
+            status: string;
+            endpoint: string;
+            toolName: string | null;
+            method: string | null;
+            createdAt: string;
+            executionTime: number | null;
+            error: string | null;
+        } | null;
+    };
+    wallet: {
+        personalWalletAddress: string | null;
+        operatingWalletAddress: string | null;
+        arbitrum: {
+            eth: {
+                raw: string;
+                formatted: string;
+            } | null;
+            usdc: {
+                raw: string;
+                formatted: string;
+            } | null;
+        };
+        hyperliquid: {
+            mainnet: {
+                accountValue: number | null;
+                withdrawable: number | null;
+                totalMarginUsed: number | null;
+                error?: string;
+            };
+            testnet: {
+                accountValue: number | null;
+                withdrawable: number | null;
+                totalMarginUsed: number | null;
+                error?: string;
+            };
+        };
+    };
+    asOf: string;
+};
+export type AssistantMode = "plan" | "performance";
+export type AssistantRunRequest = {
+    appId: string;
+    mode: AssistantMode;
+    prompt: string;
+};
+export type AssistantRunResponse = {
+    ok: boolean;
+    mode: AssistantMode;
+    conversationId: string;
+    response: string;
+};
 export declare function listApps(apiBase: string, token: string, options?: {
     handle?: string;
 }): Promise<AppListItem[]>;
@@ -147,7 +235,6 @@ export type AgentCreateRequest = {
     template?: {
         name?: string;
         description?: string;
-        templateId?: string;
         templateRepoUrl?: string;
         templateBranch?: string;
         envVars?: Record<string, string>;
@@ -161,6 +248,8 @@ export declare function createAgentFromPrompt(baseUrl: string, token: string, pa
 export declare function getUserPerformance(baseUrl: string, token: string, options?: {
     appId?: string;
 }): Promise<unknown>;
+export declare function getAppRuntimeSummary(baseUrl: string, token: string, appId: string): Promise<AppRuntimeSummary>;
+export declare function runAssistantMode(baseUrl: string, token: string, payload: AssistantRunRequest): Promise<AssistantRunResponse>;
 export declare function postAgentDigest(baseUrl: string, token: string, body: {
     content: string;
     runAt?: string;

package/dist/cli.js

@@ -143,6 +143,28 @@ async function getUserPerformance(baseUrl, token, options) {
   }
   return await response.json();
 }
+async function getAppRuntimeSummary(baseUrl, token, appId) {
+  const params = new URLSearchParams({ appId });
+  const response = await apiFetch(baseUrl, token, `/apps/summary?${params.toString()}`, {
+    method: "GET"
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`Summary lookup failed: ${response.status} ${text}`);
+  }
+  return await response.json();
+}
+async function runAssistantMode(baseUrl, token, payload) {
+  const response = await apiFetch(baseUrl, token, "/apps/assistant/run", {
+    method: "POST",
+    body: JSON.stringify(payload)
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`Assistant run failed: ${response.status} ${text}`);
+  }
+  return await response.json();
+}
 async function executeUserTool(baseUrl, token, body) {
   const response = await apiFetch(baseUrl, token, "/apps/tools/execute", {
     method: "POST",
@@ -603,8 +625,8 @@ function formatStreamItem(item) {
     return null;
   if (type === "app_creation_started") {
     const name = item.appName || item.name || item.appId || "app";
-    const templateId = typeof item.templateId === "string" ? item.templateId : null;
-    const suffix = templateId ? ` template=${templateId}` : "";
+    const templateRepoUrl = typeof item.templateRepoUrl === "string" ? item.templateRepoUrl : null;
+    const suffix = templateRepoUrl ? ` template=${templateRepoUrl}` : "";
     return `app_creation_started: ${name}${suffix}`;
   }
   if (type === "app_created") {
@@ -972,10 +994,12 @@ function printHelp() {
   console.log("  openpond apps env get <handle>/<repo>");
   console.log("  openpond apps env set <handle>/<repo> --env <json>");
   console.log("  openpond apps performance [--app-id <id>]");
+  console.log("  openpond apps summary <handle>/<repo>");
+  console.log("  openpond apps assistant <plan|performance> <handle>/<repo> --prompt <text>");
   console.log("  openpond apps store events [--source <source>] [--status <csv>] [--symbol <symbol>] [--wallet-address <0x...>] [--since <ms|iso>] [--until <ms|iso>] [--limit <n>] [--cursor <cursor>] [--history <true|false>] [--params <json>]");
   console.log("  openpond apps trade-facts [--app-id <id>]");
   console.log("  openpond apps agent create --prompt <text> [--template-id <id>]");
-  console.log("  openpond apps tools execute <appId> <deploymentId> <tool> [--body <json>] [--method <METHOD>] [--headers <json>]");
+  console.log("  openpond apps tools execute <appId> <deploymentId> <tool> [--body <json>] [--method <METHOD>] [--headers <json>] [--summary <true|false>]");
   console.log("  openpond apps positions tx [--method <GET|POST>] [--body <json>] [--params <json>]");
   console.log("  openpond opentool <init|validate|build> [args]");
   console.log("");
@@ -1345,6 +1369,32 @@ async function runAppsPerformance(options) {
   const performance = await getUserPerformance(apiBase, apiKey, { appId });
   console.log(JSON.stringify(performance, null, 2));
 }
+async function runAppsSummary(_options, target) {
+  const config = await loadConfig();
+  const uiBase = resolveBaseUrl(config);
+  const apiBase = resolvePublicApiBaseUrl();
+  const apiKey = await ensureApiKey(config, uiBase);
+  const { app } = await resolveAppTarget(apiBase, apiKey, target);
+  const summary = await getAppRuntimeSummary(apiBase, apiKey, app.id);
+  console.log(JSON.stringify(summary, null, 2));
+}
+async function runAppsAssistant(options, mode, target, contentParts) {
+  const prompt = (typeof options.prompt === "string" ? options.prompt : null) || contentParts.join(" ");
+  if (!prompt.trim()) {
+    throw new Error("usage: apps assistant <plan|performance> <handle>/<repo> --prompt <text>");
+  }
+  const config = await loadConfig();
+  const uiBase = resolveBaseUrl(config);
+  const apiBase = resolvePublicApiBaseUrl();
+  const apiKey = await ensureApiKey(config, uiBase);
+  const { app } = await resolveAppTarget(apiBase, apiKey, target);
+  const result = await runAssistantMode(apiBase, apiKey, {
+    appId: app.id,
+    mode,
+    prompt: prompt.trim()
+  });
+  console.log(JSON.stringify(result, null, 2));
+}
 async function runAppsAgentCreate(options, contentParts) {
   const config = await loadConfig();
   const uiBase = resolveBaseUrl(config);
@@ -1354,12 +1404,11 @@ async function runAppsAgentCreate(options, contentParts) {
   if (!prompt.trim()) {
     throw new Error("usage: apps agent create --prompt <text>");
   }
-  const templateId = typeof options.templateId === "string" ? options.templateId : undefined;
   const templateRepoUrl = typeof options.templateRepoUrl === "string" ? options.templateRepoUrl : undefined;
   const templateBranch = typeof options.templateBranch === "string" ? options.templateBranch : undefined;
   const templateLocalPath = typeof options.templateLocalPath === "string" ? options.templateLocalPath : undefined;
   if (templateLocalPath && String(templateLocalPath).trim().length > 0) {
-    throw new Error("templateLocalPath is not supported; use templateId or templateRepoUrl");
+    throw new Error("templateLocalPath is not supported; use templateRepoUrl");
   }
   const envVars = typeof options.env === "string" ? parseJsonOption(options.env, "env") : undefined;
   if (envVars) {
@@ -1372,8 +1421,7 @@ async function runAppsAgentCreate(options, contentParts) {
       }
     }
   }
-  const template = templateId || templateRepoUrl || templateBranch || envVars ? {
-    templateId,
+  const template = templateRepoUrl || templateBranch || envVars ? {
     templateRepoUrl,
     templateBranch,
     envVars
@@ -1445,6 +1493,7 @@ async function runAppsToolsExecute(options, appId, deploymentId, toolName) {
   const headers = typeof options.headers === "string" ? parseJsonOption(String(options.headers), "headers") : undefined;
   const scheduleId = typeof options.scheduleId === "string" ? String(options.scheduleId) : undefined;
   const notifyEmail = parseBooleanOption(options.notifyEmail);
+  const withSummary = parseBooleanOption(options.summary) || parseBooleanOption(options.withSummary);
   const result = await executeUserTool(apiBase, apiKey, {
     appId,
     deploymentId,
@@ -1456,6 +1505,10 @@ async function runAppsToolsExecute(options, appId, deploymentId, toolName) {
     notifyEmail: notifyEmail || undefined
   });
   console.log(JSON.stringify(result, null, 2));
+  if (withSummary && result.ok) {
+    const summary = await getAppRuntimeSummary(apiBase, apiKey, appId);
+    console.log(JSON.stringify({ summary }, null, 2));
+  }
 }
 async function runAppsEnvSet(options, target) {
   const rawEnv = typeof options.env === "string" ? options.env : typeof options.vars === "string" ? options.vars : typeof options.envVars === "string" ? options.envVars : null;
@@ -1731,6 +1784,23 @@ async function main() {
       await runAppsPerformance(options);
       return;
     }
+    if (subcommand === "summary") {
+      const target = rest[1];
+      if (!target) {
+        throw new Error("usage: apps summary <handle>/<repo>");
+      }
+      await runAppsSummary(options, target);
+      return;
+    }
+    if (subcommand === "assistant") {
+      const mode = rest[1];
+      const target = rest[2];
+      if (mode !== "plan" && mode !== "performance" || !target) {
+        throw new Error("usage: apps assistant <plan|performance> <handle>/<repo> --prompt <text>");
+      }
+      await runAppsAssistant(options, mode, target, rest.slice(3));
+      return;
+    }
     if (subcommand === "store" && rest[1] === "events") {
       await runAppsStoreEvents(options);
       return;
@@ -1747,7 +1817,7 @@ async function main() {
       await runAppsPositionsTx(options);
       return;
     }
-    throw new Error("usage: apps <list|tools|deploy|env get|env set|performance|store events|trade-facts|agent create|positions tx> [args]");
+    throw new Error("usage: apps <list|tools|deploy|env get|env set|performance|summary|assistant|store events|trade-facts|agent create|positions tx> [args]");
   }
   if (command === "opentool") {
     await runOpentool(process.argv.slice(3));

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { type AgentCreateRequest, type AppEnvironmentGetResponse, type AppEnvironmentUpdateResponse, type AppListItem, type CreateRepoRequest, type CreateRepoResponse, type DeploymentLogEntry, type TemplateBranchesResponse, type TemplateDeployLatestRequest, type TemplateDeployLatestResponse, type TemplateStatusResponse, type ToolExecuteRequest, type ToolExecuteResponse } from "./api";
+import { type AssistantMode, type AssistantRunResponse, type AgentCreateRequest, type AppEnvironmentGetResponse, type AppEnvironmentUpdateResponse, type AppListItem, type AppRuntimeSummary, type CreateRepoRequest, type CreateRepoResponse, type DeploymentLogEntry, type TemplateBranchesResponse, type TemplateDeployLatestRequest, type TemplateDeployLatestResponse, type TemplateStatusResponse, type ToolExecuteRequest, type ToolExecuteResponse } from "./api";
 import type { StreamCallbacks } from "./stream";
 export type { StreamCallbacks } from "./stream";
-export type { AgentCreateRequest, AppEnvironmentGetResponse, AppEnvironmentUpdateRequest, AppEnvironmentUpdateResponse, AppListItem, CreateRepoRequest, CreateRepoResponse, DeploymentDetail, DeploymentLogEntry, TemplateBranchesResponse, TemplateDeployLatestRequest, TemplateDeployLatestResponse, TemplateStatusResponse, ToolExecuteRequest, ToolExecuteResponse, } from "./api";
+export type { AssistantMode, AssistantRunResponse, AgentCreateRequest, AppEnvironmentGetResponse, AppEnvironmentUpdateRequest, AppEnvironmentUpdateResponse, AppListItem, AppRuntimeSummary, CreateRepoRequest, CreateRepoResponse, DeploymentDetail, DeploymentLogEntry, TemplateBranchesResponse, TemplateDeployLatestRequest, TemplateDeployLatestResponse, TemplateStatusResponse, ToolExecuteRequest, ToolExecuteResponse, } from "./api";
 export type { ChatRequestBody, ResponseItem, ResponseMessageItem, TemplateBootstrap, ToolCallItem, ToolOutputItem, UsageInfo, } from "./types";
 export type { Bar as IndicatorBar, BollingerResult, MacdResult, MaCrossResult, MaCrossSignal, PriceChangeResult, } from "./indicators";
-export { apiFetch, commitFiles, createAgentFromPrompt, createRepo, createHeadlessApps, createLocalProject, deployApp, deployLatestTemplate, getAppEnvironment, updateAppEnvironment, executeHostedTool, executeUserTool, fetchToolManifest, getDeploymentDetail, getDeploymentLogs, getDeploymentStatus, getLatestDeploymentForApp, getTemplateStatus, getUserPerformance, listApps, listTemplateBranches, listUserTools, pollDeviceLogin, postAgentDigest, resolveWorkerBaseUrl, startDeviceLogin, submitPositionsTx, } from "./api";
+export { apiFetch, getAppRuntimeSummary, commitFiles, createAgentFromPrompt, createRepo, createHeadlessApps, createLocalProject, deployApp, deployLatestTemplate, getAppEnvironment, updateAppEnvironment, executeHostedTool, executeUserTool, fetchToolManifest, getDeploymentDetail, getDeploymentLogs, getDeploymentStatus, getLatestDeploymentForApp, getTemplateStatus, getUserPerformance, runAssistantMode, listApps, listTemplateBranches, listUserTools, pollDeviceLogin, postAgentDigest, resolveWorkerBaseUrl, startDeviceLogin, submitPositionsTx, } from "./api";
 export { computeAtr, computeBollinger, computeEma, computeEmaSeries, computeMacd, computeMaCross, computePriceChange, computeRsi, computeSma, computeSmaSeries, } from "./indicators";
 export { DEFAULT_CACHE_TTL_MS, getCachedApps, getCachedTools, setCachedApps, setCachedTools, } from "./cache";
 export { getConfigPath, loadConfig, loadGlobalConfig, saveConfig, saveGlobalConfig, } from "./config";
@@ -62,6 +62,8 @@ export type OpenPondClient = {
         list: (options?: AppsListOptions) => Promise<AppListItem[]>;
         tools: (options?: AppsToolsOptions) => Promise<unknown[]>;
         performance: (options?: AppsPerformanceOptions) => Promise<unknown>;
+        summary: (input: AppSummaryOptions) => Promise<AppRuntimeSummary>;
+        assistantRun: (input: AppsAssistantRunOptions) => Promise<AssistantRunResponse>;
         agentCreate: (input: AgentCreateRequest & {
             refreshCache?: boolean;
         }, callbacks?: AgentCreateStreamCallbacks) => Promise<AgentCreateStreamResult>;
@@ -121,6 +123,14 @@ export type AppsToolsOptions = {
 export type AppsPerformanceOptions = {
     appId?: string;
 };
+export type AppSummaryOptions = {
+    appId: string;
+};
+export type AppsAssistantRunOptions = {
+    appId: string;
+    mode: AssistantMode;
+    prompt: string;
+};
 export type ExecuteUserToolOptions = {
     appId: string;
     deploymentId: string;

package/dist/index.js

@@ -181,6 +181,28 @@ async function getUserPerformance(baseUrl, token, options) {
   }
   return await response.json();
 }
+async function getAppRuntimeSummary(baseUrl, token, appId) {
+  const params = new URLSearchParams({ appId });
+  const response = await apiFetch(baseUrl, token, `/apps/summary?${params.toString()}`, {
+    method: "GET"
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`Summary lookup failed: ${response.status} ${text}`);
+  }
+  return await response.json();
+}
+async function runAssistantMode(baseUrl, token, payload) {
+  const response = await apiFetch(baseUrl, token, "/apps/assistant/run", {
+    method: "POST",
+    body: JSON.stringify(payload)
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`Assistant run failed: ${response.status} ${text}`);
+  }
+  return await response.json();
+}
 async function postAgentDigest(baseUrl, token, body) {
   const response = await apiFetch(baseUrl, token, "/apps/agent/digest", {
     method: "POST",
@@ -622,8 +644,8 @@ function formatStreamItem(item) {
     return null;
   if (type === "app_creation_started") {
     const name = item.appName || item.name || item.appId || "app";
-    const templateId = typeof item.templateId === "string" ? item.templateId : null;
-    const suffix = templateId ? ` template=${templateId}` : "";
+    const templateRepoUrl = typeof item.templateRepoUrl === "string" ? item.templateRepoUrl : null;
+    const suffix = templateRepoUrl ? ` template=${templateRepoUrl}` : "";
     return `app_creation_started: ${name}${suffix}`;
   }
   if (type === "app_created") {
@@ -1210,6 +1232,12 @@ function createClient(options) {
       performance: async (options2) => {
         return getUserPerformance(apiUrl, apiKey, { appId: options2?.appId });
       },
+      summary: async (input) => {
+        return getAppRuntimeSummary(apiUrl, apiKey, input.appId);
+      },
+      assistantRun: async (input) => {
+        return runAssistantMode(apiUrl, apiKey, input);
+      },
       agentCreate: async (input, callbacks) => {
         const { refreshCache: refreshCacheFlag, ...rest } = input;
         const payload = {
@@ -1293,6 +1321,7 @@ export {
   setCachedApps,
   saveGlobalConfig,
   saveConfig,
+  runAssistantMode,
   resolveWorkerBaseUrl,
   postAgentDigest,
   pollDeviceLogin,
@@ -1311,6 +1340,7 @@ export {
   getConfigPath,
   getCachedTools,
   getCachedApps,
+  getAppRuntimeSummary,
   getAppEnvironment,
   formatStreamItem,
   fetchToolManifest,

package/dist/types.d.ts

@@ -32,7 +32,6 @@ export type UsageInfo = {
 export type TemplateBootstrap = {
     name?: string;
     description?: string;
-    templateId?: string;
     templateRepoUrl?: string;
     templateBranch?: string;
     envVars?: Record<string, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpond-code",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "OpenPond CLI (API key only)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",