@agentprojectcontext/apx 1.16.0 → 1.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"
@@ -60,7 +60,8 @@
     "semver": "^7.8.0",
     "solid-js": "^1.9.12",
     "strip-ansi": "^7.2.0",
-    "yargs": "^18.0.0"
+    "yargs": "^18.0.0",
+    "zod": "^3.25.76"
   },
   "optionalDependencies": {
     "fast-glob": "^3.3.2",

package/src/daemon/super-agent.js

@@ -37,7 +37,7 @@ const ACK_ONLY_TOOLS = new Set(["send_telegram"]);
 // (the model already had its chance to call a real tool).
 const MAX_CONSECUTIVE_ACKS = 2;
 
-const DEFAULT_SYSTEM = `# Identity (override everything else)
+export const DEFAULT_SYSTEM = `# Identity (override everything else)
 You are **APX** — Manuel's personal assistant running on his Mac.
 You are NOT a code analyzer, NOT a generic chatbot, NOT a tutor.
 You are an **action agent**: you USE TOOLS to do real things on Manuel's system.

package/src/tui/context/sdk-apx.tsx

@@ -4,6 +4,7 @@ import { onCleanup } from "solid-js"
 import fs from "node:fs"
 import os from "node:os"
 import path from "node:path"
+import { spawn } from "node:child_process"
 
 const TOKEN_PATH = path.join(os.homedir(), ".apx", "daemon.token")
 
@@ -20,6 +21,9 @@ export type ApxEvent =
   | { type: "chunk"; sessionID: string; chunk: string }
   | { type: "final"; sessionID: string; text: string; usage?: { input_tokens: number; output_tokens: number } }
   | { type: "error"; sessionID: string; error: string }
+  | { type: "shell.start"; sessionID: string; shellID: string; command: string; cwd: string }
+  | { type: "shell.output"; sessionID: string; shellID: string; stream: "stdout" | "stderr"; chunk: string }
+  | { type: "shell.done"; sessionID: string; shellID: string; exitCode: number | null; signal: NodeJS.Signals | null }
 
 export const { use: useSDK, provider: SDKProvider } = createSimpleContext({
   name: "SDK",
@@ -102,6 +106,27 @@ export const { use: useSDK, provider: SDKProvider } = createSimpleContext({
       return (data as any).id as string
     }
 
+    function runShell(sessionID: string, command: string, cwd: string = process.cwd()): Promise<{ shellID: string; exitCode: number | null }> {
+      const shellID = `sh-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`
+      emitter.emit("event", { type: "shell.start", sessionID, shellID, command, cwd })
+      return new Promise((resolve) => {
+        const child = spawn(command, { shell: true, cwd, env: process.env })
+        child.stdout?.on("data", (buf) => {
+          emitter.emit("event", { type: "shell.output", sessionID, shellID, stream: "stdout", chunk: buf.toString() })
+        })
+        child.stderr?.on("data", (buf) => {
+          emitter.emit("event", { type: "shell.output", sessionID, shellID, stream: "stderr", chunk: buf.toString() })
+        })
+        child.on("error", (err) => {
+          emitter.emit("event", { type: "shell.output", sessionID, shellID, stream: "stderr", chunk: `[spawn error] ${err.message}\n` })
+        })
+        child.on("close", (code, signal) => {
+          emitter.emit("event", { type: "shell.done", sessionID, shellID, exitCode: code, signal })
+          resolve({ shellID, exitCode: code })
+        })
+      })
+    }
+
     async function listSessions(): Promise<Array<{ id: string; title: string; updatedAt?: number }>> {
       try {
         const token = readToken()
@@ -146,7 +171,12 @@ export const { use: useSDK, provider: SDKProvider } = createSimpleContext({
         fork: async (_opts: any) => ({ data: undefined, error: new Error("not supported") }),
         abort: async (_opts: any) => {},
         prompt: async (_opts: any) => {},
-        shell: async (_opts: any) => {},
+        shell: async (opts: { sessionID?: string; command?: string; cwd?: string }) => {
+          if (!opts?.command) return { data: undefined }
+          const sid = opts.sessionID || (await createSession())
+          const r = await runShell(sid, opts.command, opts.cwd)
+          return { data: r }
+        },
         command: async (_opts: any) => {},
         refresh: async () => {},
         update: async (_opts: any) => ({ data: undefined }),
@@ -180,6 +210,7 @@ export const { use: useSDK, provider: SDKProvider } = createSimpleContext({
       streamChat,
       createSession,
       listSessions,
+      runShell,
     }
   },
 })

package/src/tui/context/sync-apx.tsx

@@ -13,10 +13,15 @@ export type ApxSession = {
 export type ApxMessage = {
   id: string
   sessionID: string
-  role: "user" | "assistant"
+  role: "user" | "assistant" | "shell"
   text: string
   streaming?: boolean
   error?: boolean
+  // Shell-specific
+  shellID?: string
+  command?: string
+  cwd?: string
+  exitCode?: number | null
 }
 
 export const { use: useApxSync, provider: ApxSyncProvider } = createSimpleContext({
@@ -78,6 +83,55 @@ export const { use: useApxSync, provider: ApxSyncProvider } = createSimpleContex
         setStore("previousMessages", (prev) => [...prev, { role: "assistant", content: e.text }])
       }
 
+      if (ev.type === "shell.start") {
+        const e = ev
+        setStore(
+          "messages",
+          produce((draft) => {
+            ;(draft[e.sessionID] ??= []).push({
+              id: e.shellID,
+              sessionID: e.sessionID,
+              role: "shell",
+              text: "",
+              streaming: true,
+              shellID: e.shellID,
+              command: e.command,
+              cwd: e.cwd,
+            })
+          }),
+        )
+      }
+
+      if (ev.type === "shell.output") {
+        const e = ev
+        setStore(
+          "messages",
+          produce((draft) => {
+            const msgs = draft[e.sessionID]
+            if (!msgs) return
+            const target = msgs.find((m) => m.role === "shell" && m.shellID === e.shellID)
+            if (target) target.text += e.chunk
+          }),
+        )
+      }
+
+      if (ev.type === "shell.done") {
+        const e = ev
+        setStore(
+          "messages",
+          produce((draft) => {
+            const msgs = draft[e.sessionID]
+            if (!msgs) return
+            const target = msgs.find((m) => m.role === "shell" && m.shellID === e.shellID)
+            if (target) {
+              target.streaming = false
+              target.exitCode = e.exitCode
+              if (e.signal) target.text += `\n[killed by signal ${e.signal}]`
+            }
+          }),
+        )
+      }
+
       if (ev.type === "error") {
         const e = ev
         setStore(
@@ -121,6 +175,11 @@ export const { use: useApxSync, provider: ApxSyncProvider } = createSimpleContex
       return id
     }
 
+    async function runShell(command: string, cwd?: string) {
+      const sessionID = await ensureSession()
+      await sdk.runShell(sessionID, command, cwd ?? process.cwd())
+    }
+
     async function sendMessage(text: string) {
       const sessionID = await ensureSession()
       const userMsg: ApxMessage = {
@@ -172,6 +231,7 @@ export const { use: useApxSync, provider: ApxSyncProvider } = createSimpleContex
         async refresh() {},
       },
       sendMessage,
+      runShell,
       ensureSession,
     }
   },

package/src/tui/routes/session/index.tsx

@@ -47,6 +47,35 @@ function AssistantBubble(props: { msg: ApxMessage }) {
   )
 }
 
+function ShellBubble(props: { msg: ApxMessage }) {
+  const { theme } = useTheme()
+  const header = () => {
+    const code = props.msg.exitCode
+    const status = props.msg.streaming
+      ? "running"
+      : code === 0
+        ? "exit 0"
+        : code == null
+          ? "ended"
+          : `exit ${code}`
+    return `$ ${props.msg.command ?? ""}  · ${status}`
+  }
+  const body = () => props.msg.text || (props.msg.streaming ? "…" : "(no output)")
+  return (
+    <box flexDirection="column" marginBottom={1} paddingLeft={2} paddingRight={2}>
+      <text color={theme.warning ?? theme.primary} bold>
+        {header()}
+      </text>
+      <text
+        color={props.msg.exitCode && props.msg.exitCode !== 0 ? theme.error : theme.text}
+        wrap
+      >
+        {body()}
+      </text>
+    </box>
+  )
+}
+
 export function Session() {
   const dims = useTerminalDimensions()
   const { theme } = useTheme()
@@ -109,7 +138,11 @@ export function Session() {
     inputEl.clear()
     setSending(true)
     try {
-      await sync.sendMessage(text)
+      if (text.startsWith("!") && text.length > 1) {
+        await sync.runShell(text.slice(1).trim())
+      } else {
+        await sync.sendMessage(text)
+      }
     } catch (e) {
       toast.error(e instanceof Error ? e : new Error(String(e)))
     } finally {
@@ -132,17 +165,17 @@ export function Session() {
             fallback={
               <box paddingLeft={2} paddingTop={2}>
                 <text color={theme.textMuted} italic>
-                  Type a message and press Enter to start chatting.
+                  Type a message to chat, or prefix with ! to run a shell command (e.g. !ls).
                 </text>
               </box>
             }
           >
             <For each={messages()}>
-              {(msg) => (
-                <Show when={msg.role === "user"} fallback={<AssistantBubble msg={msg} />}>
-                  <UserBubble msg={msg} />
-                </Show>
-              )}
+              {(msg) => {
+                if (msg.role === "user") return <UserBubble msg={msg} />
+                if (msg.role === "shell") return <ShellBubble msg={msg} />
+                return <AssistantBubble msg={msg} />
+              }}
             </For>
           </Show>
           <box height={1} />
@@ -163,7 +196,7 @@ export function Session() {
               inputEl = r
               promptRef.set(makeRef(r))
             }}
-            placeholder={sending() ? "Waiting for response…" : "Ask anything... (Enter to send)"}
+            placeholder={sending() ? "Waiting for response…" : "Ask anything... (prefix ! to run shell, e.g. !ls)"}
             placeholderColor={theme.textMuted}
             textColor={theme.text}
             focusedTextColor={theme.text}