teamshift 0.1.0 → 0.1.2

package/README.md

@@ -11,9 +11,11 @@ npx teamshift add code-audit-swarm     # adds it to your workspace
 npx teamshift run <team-id> "review services/api for auth mistakes"
 ```
 
-`teamshift teams` lists everything callable, including teams you built yourself
-in the portal. `add` is idempotent — running it twice will not duplicate a team
-or overwrite edits you have made to it.
+`teamshift teams` lists callable teams, including teams you built yourself in the
+portal; `teamshift agents` lists callable individual agents. Keeping the two
+inventories separate prevents a large internal agent library from burying the
+teams a customer actually runs. `add` is idempotent — running it twice will not
+duplicate a team or overwrite edits you have made to it.
 
 ## Parallel fan-out
 
@@ -36,7 +38,9 @@ completed  $1.20   4.0s  find dead code
 ```
 
 `--file prompts.txt` reads one prompt per line. Concurrency is bounded (default
-5) so a large batch does not trip the API's write rate limit.
+5) so a large batch does not trip the API's write rate limit. Completed runs
+print their scrubbed deliverable after the status table; `--json` includes it as
+the outcome's `output` field.
 
 ## Already using Claude Code or Codex?
 
@@ -54,12 +58,11 @@ agent, with no second CLI to learn. Both install commands are in the portal unde
 
 | Code | Meaning |
 | --- | --- |
-| `0` | every run reached a terminal status |
-| `1` | usage error, auth failure, or at least one run failed to dispatch |
+| `0` | every run completed and returned its deliverable |
+| `1` | usage/auth error, timeout, failed run, or missing deliverable |
 | `2` | out of credit — add credits and rerun |
 
 ## Releasing
 
-This package is `private: true` so a workspace-wide publish cannot push it by
-accident. Releasing is deliberate: set `private: false`, `pnpm build`, then
-`npm publish`.
+Published on npm as `teamshift`. To release: bump `version`, `pnpm build`, run
+the package tests, then `npm publish --access public` from this directory.

package/dist/api.js

@@ -73,4 +73,7 @@ export class TeamShiftClient {
         const body = await this.request(`/v1/runs/${runId}`);
         return body.run;
     }
+    getRunResult(runId) {
+        return this.request(`/v1/runs/${runId}/result`);
+    }
 }

package/dist/bin.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// The bin entrypoint runs main() unconditionally. Detecting "was I executed
+// directly?" from argv[1] is exactly the 0.1.0 release bug: npm invokes a bin
+// through node_modules/.bin/<command> — a symlink named after the COMMAND — so
+// any filename-based guard fails and the CLI exits silently. Library consumers
+// import from index.ts / cli.ts, which must never self-execute; only this file
+// may have side effects on import.
+import { main } from './cli.js';
+void main();

package/dist/cli.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { createInterface } from 'node:readline/promises';
 import { PaymentRequiredError, TeamShiftClient } from './api.js';
 import { DEFAULT_API_URL, loadCredentials, maskKey, saveCredentials } from './config.js';
@@ -11,7 +10,8 @@ const USAGE = `teamshift — run agent teams from your terminal
   teamshift whoami                    Show the active key and endpoint
   teamshift catalog                   Browse prebuilt teams you can add
   teamshift add <catalog-id>          Add a prebuilt team to your workspace
-  teamshift teams                     List callable teams and agents
+  teamshift teams                     List callable teams
+  teamshift agents                    List callable agents
   teamshift run <id> "<prompt>"       Run one team, wait, print status and charge
   teamshift run <id> -p "a" -p "b"    Fan out prompts in parallel
   teamshift run <id> --file prompts.txt   One prompt per line, run in parallel
@@ -72,18 +72,16 @@ async function login() {
         rl.close();
     }
 }
-async function listCallable(json) {
+async function listCallable(kind, json) {
     const payload = await requireClient().interop();
+    const items = kind === 'team' ? payload.teams : payload.agents;
     if (json) {
-        console.log(JSON.stringify(payload, null, 2));
+        console.log(JSON.stringify(items, null, 2));
         return;
     }
-    const rows = [
-        ...payload.teams.map((item) => ['team', item.id, item.name]),
-        ...payload.agents.map((item) => ['agent', item.id, item.name]),
-    ];
+    const rows = items.map((item) => [kind, item.id, item.name]);
     if (rows.length === 0) {
-        console.log('Nothing callable yet — create a team in the portal first.');
+        console.log(`No callable ${kind}s yet${kind === 'team' ? ' — add one with `teamshift add <id>`.' : '.'}`);
         return;
     }
     console.log(table(['KIND', 'ID', 'NAME'], rows));
@@ -153,9 +151,15 @@ async function run(args) {
     const serial = outcomes.reduce((sum, outcome) => sum + outcome.elapsedMs, 0);
     console.log(`\n${outcomes.length} run(s) · ${money(total)} total · ${duration(Date.now() - startedAt)} wall clock ` +
         `(${duration(serial)} if run one at a time)`);
+    for (const outcome of outcomes) {
+        if (outcome.output === null || outcome.output === undefined)
+            continue;
+        const output = typeof outcome.output === 'string' ? outcome.output : JSON.stringify(outcome.output, null, 2);
+        console.log(`\n${outcomes.length > 1 ? `[${outcome.prompt}]\n` : ''}${output}`);
+    }
     const failed = outcomes.filter((outcome) => outcome.error).length;
     if (failed > 0) {
-        console.log(`${failed} run(s) failed to dispatch — rerun just those prompts.`);
+        console.log(`${failed} run(s) need attention — inspect the status above before retrying.`);
         process.exitCode = 1;
     }
 }
@@ -187,7 +191,9 @@ export async function main(argv = process.argv.slice(2)) {
             case 'add':
                 return await addFromCatalog(args);
             case 'teams':
-                return await listCallable(args.json);
+                return await listCallable('team', args.json);
+            case 'agents':
+                return await listCallable('agent', args.json);
             case 'run':
                 return await run(args);
             default:
@@ -204,6 +210,3 @@ export async function main(argv = process.argv.slice(2)) {
         process.exit(1);
     }
 }
-const invokedDirectly = process.argv[1]?.endsWith('cli.js') || process.argv[1]?.endsWith('cli.ts');
-if (invokedDirectly)
-    void main();

package/dist/run.js

@@ -1,5 +1,14 @@
 import { isTerminal } from './format.js';
 const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export class RunPollingTimeoutError extends Error {
+    runId;
+    latest;
+    constructor(runId, latest) {
+        super(`run ${runId} did not finish before the polling timeout (last status: ${latest.status ?? 'unknown'})`);
+        this.runId = runId;
+        this.latest = latest;
+    }
+}
 /** Poll one run to a terminal status, or give up at the timeout. */
 export async function waitForRun(client, runId, options = {}) {
     const { intervalMs = 2000, timeoutMs = 900_000, now = Date.now, sleep = defaultSleep } = options;
@@ -7,7 +16,7 @@ export async function waitForRun(client, runId, options = {}) {
     let latest = await client.getRun(runId);
     while (!isTerminal(latest.status)) {
         if (now() - startedAt >= timeoutMs)
-            return latest;
+            throw new RunPollingTimeoutError(runId, latest);
         await sleep(intervalMs);
         latest = await client.getRun(runId);
     }
@@ -34,22 +43,39 @@ export async function runBatch(client, kind, id, prompts, options = {}) {
             if (prompt === undefined)
                 return;
             const startedAt = now();
+            let runId = null;
             try {
-                const runId = await client.startRun(kind, id, prompt);
+                runId = await client.startRun(kind, id, prompt);
                 const summary = await waitForRun(client, runId, { ...pollOptions, now });
+                let output = null;
+                let resultError;
+                if (summary.status === 'completed') {
+                    try {
+                        const result = await client.getRunResult(runId);
+                        output = result.text ?? result.document;
+                    }
+                    catch (error) {
+                        resultError = `result unavailable: ${error instanceof Error ? error.message : String(error)}`;
+                    }
+                }
+                else {
+                    resultError = `run ended with status ${summary.status ?? 'unknown'}`;
+                }
                 results[index] = {
                     prompt,
                     runId,
                     status: String(summary.status ?? 'unknown'),
                     costUsd: summary.cost_estimate_usd ?? null,
                     elapsedMs: now() - startedAt,
+                    output,
+                    ...(resultError ? { error: resultError } : {}),
                 };
             }
             catch (error) {
                 results[index] = {
                     prompt,
-                    runId: null,
-                    status: 'dispatch_failed',
+                    runId,
+                    status: error instanceof RunPollingTimeoutError ? 'poll_timeout' : 'dispatch_failed',
                     costUsd: null,
                     elapsedMs: now() - startedAt,
                     error: error instanceof Error ? error.message : String(error),

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "teamshift",
   "private": false,
-  "version": "0.1.0",
-  "description": "Run TeamShift agent teams from your terminal. Metered by usage — no model key of your own required.",
+  "version": "0.1.2",
+  "description": "Run TeamShift agent teams from your terminal. Metered by usage \u2014 no model key of your own required.",
   "type": "module",
   "bin": {
-    "teamshift": "dist/cli.js"
+    "teamshift": "dist/bin.js"
   },
   "main": "src/index.ts",
   "types": "src/index.ts",