@pixelbyte-software/pixcode 1.54.11 → 1.55.0

package/server/services/telegram/control-center.js

@@ -65,7 +65,7 @@ const CONTROL_COMMANDS = new Set([
   '/model',
   '/models',
   '/workflows',
-  '/orchestration',
+  '/tasks',
   '/runs',
   '/approvals',
   '/controlroom',
@@ -1101,7 +1101,7 @@ export async function showModelMenu({ bot, chatId, link, refresh = false, editMe
 
 export async function showWorkflowMenu({ bot, chatId, link, editMessageId }) {
   const lang = languageFor(link);
-  const workflows = await localApi(link.user_id, '/api/orchestration/workflows');
+  const workflows = await localApi(link.user_id, '/api/tasks');
   const list = Array.isArray(workflows?.workflows) ? workflows.workflows : [];
   const state = getState(link.user_id);
   const workflowButtons = list.map((workflow) => button(
@@ -1118,7 +1118,7 @@ export async function showWorkflowMenu({ bot, chatId, link, editMessageId }) {
 
 async function showRuns({ bot, chatId, link, editMessageId }) {
   const lang = languageFor(link);
-  const data = await localApi(link.user_id, '/api/orchestration/workflows/runs?limit=10');
+  const data = await localApi(link.user_id, '/api/tasks/runs?limit=10');
   const runs = Array.isArray(data?.runs) ? data.runs : [];
   if (runs.length === 0) {
     await send(bot, chatId, t(lang, 'control.noRuns'), { editMessageId });
@@ -1137,7 +1137,7 @@ async function showRuns({ bot, chatId, link, editMessageId }) {
 
 async function showApprovalQueue({ bot, chatId, link, editMessageId }) {
   const lang = languageFor(link);
-  const data = await localApi(link.user_id, '/api/orchestration/workflows/approvals');
+  const data = await localApi(link.user_id, '/api/tasks/approvals');
   const approvals = Array.isArray(data?.pendingApprovals) ? data.pendingApprovals : [];
   if (approvals.length === 0) {
     await send(bot, chatId, t(lang, 'control.noApprovals'), { editMessageId });
@@ -1554,7 +1554,7 @@ export async function runWorkflow({ bot, chatId, link, input, activity = null })
   const result = await runTelegramTool({
     userId: link.user_id,
     action: 'run_workflow',
-    execute: () => localApi(link.user_id, `/api/orchestration/workflows/${workflowId}/runs`, {
+    execute: () => localApi(link.user_id, `/api/tasks/${workflowId}/runs`, {
       method: 'POST',
       body: {
         input,
@@ -1610,7 +1610,7 @@ async function cancelRun({ bot, chatId, link, runId, editMessageId, confirmed =
   const result = await runTelegramTool({
     userId: link.user_id,
     action: 'run_cancel',
-    execute: () => localApi(link.user_id, `/api/orchestration/workflows/runs/${encodeURIComponent(runId)}/cancel`, {
+    execute: () => localApi(link.user_id, `/api/tasks/runs/${encodeURIComponent(runId)}/cancel`, {
       method: 'POST',
     }),
   });
@@ -1662,7 +1662,7 @@ async function findProjectByQuery(query) {
 
 async function listWorkflowSummaries(userId) {
   try {
-    const data = await localApi(userId, '/api/orchestration/workflows', { timeoutMs: 10_000 });
+    const data = await localApi(userId, '/api/tasks', { timeoutMs: 10_000 });
     if (Array.isArray(data)) return data;
     if (Array.isArray(data?.workflows)) return data.workflows;
   } catch {
@@ -1840,7 +1840,7 @@ async function handleRoutedIntent({ bot, chatId, link, text, activity }) {
 }
 
 async function fetchRun(userId, runId) {
-  return localApi(userId, `/api/orchestration/workflows/runs/${runId}`);
+  return localApi(userId, `/api/tasks/runs/${runId}`);
 }
 
 function summarizeRun(run, mode) {
@@ -2097,7 +2097,7 @@ async function handleCommand({ bot, chatId, link, text }) {
     await showModelMenu({ bot, chatId, link, refresh: command === '/models' && argText === 'refresh' });
     return true;
   }
-  if (command === '/workflows' || command === '/orchestration') {
+  if (command === '/workflows' || command === '/tasks') {
     await showWorkflowMenu({ bot, chatId, link });
     return true;
   }
@@ -2385,7 +2385,7 @@ async function handleTelegramControlCallbackInternal({ bot, query, link }) {
     const toolResult = await runTelegramTool({
       userId: link.user_id,
       action: 'approval_decide',
-      execute: () => localApi(link.user_id, `/api/orchestration/workflows/approvals/${encodeURIComponent(payload.approvalId)}`, {
+      execute: () => localApi(link.user_id, `/api/tasks/approvals/${encodeURIComponent(payload.approvalId)}`, {
         method: 'POST',
         body: {
           allow: payload.allow === true,

package/server/services/telegram/telegram-gateway.js

@@ -8,8 +8,8 @@ export const TELEGRAM_CONTROL_SCOPES = [
   'telegram:write',
   'providers:read',
   'providers:write',
-  'orchestration:read',
-  'orchestration:write',
+  'tasks:read',
+  'tasks:write',
   'projects:read',
   'sessions:read',
   'webhooks:read',

package/server/services/telegram/translations.js

@@ -21,7 +21,7 @@ const EN = {
   'control.help': 'Commands: /menu, /projects, /provider, /model, /workflows, /runs, /approvals, /control-room, /webhooks, /sessions, /terminal, /detach, /newchat, /chat <prompt>, /workflow <prompt>, /install, /auth, /settings, /progress final|steps|errors|all, /control on|off.',
   'control.examples': 'Examples:\n/chat summarize this project\n/chat fix the last error\n/workflow review the current changes\n/settings to change language and progress mode',
   'control.unknownCommand': 'I do not know that command yet. Here are the available Pixcode commands:',
-  'control.onboarding': 'How to start:\n/projects to pick a project\n/provider to pick the CLI\n/model to choose the model\n/chat <prompt> to run the current agent\n/workflow <prompt> to run orchestration\n/help to see all commands',
+  'control.onboarding': 'How to start:\n/projects to pick a project\n/provider to pick the CLI\n/model to choose the model\n/chat <prompt> to run the current agent\n/workflow <prompt> to run a task\n/help to see all commands',
   'control.summary.project': 'Project',
   'control.summary.provider': 'Provider',
   'control.summary.workflow': 'Workflow',
@@ -66,9 +66,9 @@ const EN = {
   'control.projectNotFound': 'No project matched "{{query}}". Pick one from the list.',
   'control.pickProvider': 'Pick the CLI provider Telegram should use:',
   'control.modelsFor': 'Models for {{provider}}:',
-  'control.pickWorkflow': 'Pick an orchestration workflow:',
-  'control.noRuns': 'No orchestration runs yet.',
-  'control.recentRuns': 'Recent orchestration runs:',
+  'control.pickWorkflow': 'Pick an task workflow:',
+  'control.noRuns': 'No task runs yet.',
+  'control.recentRuns': 'Recent task runs:',
   'control.approvalQueue': 'Pending approval queue:',
   'control.noApprovals': 'No pending approvals.',
   'control.approvalDecided': 'Approval {{approvalId}} {{status}}.\nRun: {{runId}}',
@@ -126,7 +126,7 @@ const EN = {
   'control.modelCleared': 'Model cleared.',
   'control.workflowSelected': 'Workflow selected: {{workflow}}',
   'control.sendAgentPrompt': 'Send the agent prompt.',
-  'control.sendWorkflowPrompt': 'Send the orchestration prompt.',
+  'control.sendWorkflowPrompt': 'Send the task prompt.',
   'control.remoteEnabled': 'Remote control enabled.',
   'control.remoteDisabled': 'Remote control disabled.',
   'control.progressUsage': 'Use /progress final, /progress steps, /progress errors, or /progress all.',

package/dist/api-automation.html

@@ -1,110 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>Pixcode API Automation - px_ API Keys, Agent Runs and Workflow Control</title>
-    <meta
-      name="description"
-      content="Use Pixcode API automation with px_ API keys to list projects, run Claude Code, Codex, Cursor CLI, Gemini CLI, Qwen Code, and OpenCode tasks, preview orchestration workflows, start runs, stream events, cancel runs, and integrate Telegram or external tools."
-    />
-    <meta
-      name="keywords"
-      content="Pixcode API, px API key, AI coding agent API, Codex API automation, Claude Code automation, OpenCode automation, orchestration REST API, self-hosted developer automation, coding agent webhook"
-    />
-    <meta name="robots" content="index,follow,max-image-preview:large,max-snippet:-1" />
-    <link rel="canonical" href="https://alicomert.github.io/pixcode/api-automation.html" />
-    <link rel="icon" href="favicon.png" />
-    <link rel="stylesheet" href="site.css" />
-  </head>
-  <body>
-    <nav class="site-nav" aria-label="Main navigation">
-      <a class="brand" href="landing.html">
-        <img src="logo.png" alt="" />
-        <span>Pixcode</span>
-      </a>
-      <div class="nav-links">
-        <a href="docs.html">Documentation</a>
-        <a href="features.html">Features</a>
-        <a href="orchestration.html">Orchestration</a>
-        <a href="api-automation.html">API</a>
-        <a href="https://github.com/alicomert/pixcode">GitHub</a>
-      </div>
-    </nav>
-
-    <header class="hero docs-hero">
-      <div>
-        <div class="eyebrow">API automation</div>
-        <h1>Control Pixcode from scripts, dashboards, CI, and remote tools.</h1>
-        <p class="lead">
-          Pixcode exposes REST and WebSocket-powered workflows. Generate a `px_` API key, then trigger provider tasks, inspect projects, preview orchestration, start workflow runs, stream output, and cancel work from external clients.
-        </p>
-      </div>
-      <div class="image-slot">
-        <span><strong>API dashboard slot</strong>Recommended: 1400 x 1000. Show API keys, OpenAPI docs, and an automation request/result.</span>
-      </div>
-    </header>
-
-    <main>
-      <section class="section">
-        <h2>Authentication</h2>
-        <p class="sublead">
-          New Pixcode API keys start with `px_`. Older `ck_` keys remain accepted for compatibility, but new documentation and examples should use `px_`.
-        </p>
-        <div class="grid two">
-          <div class="code-panel"><pre><code>curl http://localhost:3001/api/projects \
-  -H "Authorization: Bearer px_your_key_here"</code></pre></div>
-          <div class="code-panel"><pre><code>curl http://localhost:3001/api/projects \
-  -H "X-API-Key: px_your_key_here"</code></pre></div>
-        </div>
-      </section>
-
-      <section class="section alt">
-        <h2>Run a one-shot agent task</h2>
-        <p class="sublead">
-          `POST /api/agent` is the external REST entry point for non-interactive automation. It can run a provider against a project path, optionally stream events, and optionally return buffered JSON with `stream: false`.
-        </p>
-        <div class="code-panel"><pre><code>curl http://localhost:3001/api/agent \
-  -H "Authorization: Bearer px_your_key_here" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "provider": "codex",
-    "projectPath": "/home/me/project",
-    "message": "Review the current diff and list release risks.",
-    "stream": false
-  }'</code></pre></div>
-      </section>
-
-      <section class="section warm">
-        <h2>Workflow automation</h2>
-        <p class="sublead">
-          Orchestration endpoints can list workflow modes, preview expanded DAGs, start runs, read run state, stream events, and cancel active work.
-        </p>
-        <div class="grid two">
-          <div class="card"><strong>Preview</strong><p>Validate agent metadata and inspect the node graph before running child agents.</p></div>
-          <div class="card"><strong>Run</strong><p>Start the workflow and track node runs, agent task IDs, status, events, and output.</p></div>
-          <div class="card"><strong>Stream</strong><p>Use run event endpoints to follow progress in dashboards or CLI scripts.</p></div>
-          <div class="card"><strong>Cancel</strong><p>Stop active orchestration runs when the user changes direction or detects bad output.</p></div>
-        </div>
-      </section>
-
-      <section class="section">
-        <h2>Common integration ideas</h2>
-        <ul class="feature-list">
-          <li>Ask Codex or Claude Code to review a Git diff from a CI job before release.</li>
-          <li>Trigger OpenCode or Gemini CLI from a custom internal dashboard.</li>
-          <li>Build a Telegram command that starts a Pixcode agent run on an always-on server.</li>
-          <li>Run multi-agent review on a branch before creating a tag or npm publish.</li>
-          <li>Expose a safe internal tool that lists projects and starts approved workflows.</li>
-        </ul>
-        <p>
-          Full OpenAPI reference: <a href="openapi.yaml">openapi.yaml</a>.
-        </p>
-      </section>
-    </main>
-
-    <footer class="footer">
-      <strong>Pixcode API automation</strong> · <a href="docs.html">Documentation</a> · <a href="openapi.yaml">OpenAPI</a> · <a href="llms.txt">llms.txt</a>
-    </footer>
-  </body>
-</html>