@agimon-ai/po-codemode 0.0.0-stage → 0.0.1-alpha.0

package/package.json

@@ -1,6 +1,100 @@
 {
   "name": "@agimon-ai/po-codemode",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1-alpha.0",
+  "description": "Code mode for Po sessions: discover and exec over namespaces other packages contribute",
+  "keywords": [
+    "ai",
+    "code-mode",
+    "coding-agent",
+    "developer-tools",
+    "pi-coding-agent",
+    "po",
+    "typescript"
+  ],
+  "homepage": "https://agimon.ai",
+  "license": "BUSL-1.1",
+  "author": "Vuong Ngo",
+  "files": [
+    "dist",
+    "src/prompts",
+    "llms.txt",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./apiContracts": {
+      "types": "./dist/apiContracts.d.mts",
+      "import": "./dist/apiContracts.mjs",
+      "require": "./dist/apiContracts.cjs"
+    },
+    "./extensions/server": {
+      "types": "./dist/extensions/server.d.mts",
+      "import": "./dist/extensions/server.mjs",
+      "require": "./dist/extensions/server.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agimon-ai/po-core": "0.0.0-alpha.27",
+    "@deepseek-ai/cordis": "4.0.5",
+    "typebox": "1.3.37"
+  },
+  "devDependencies": {
+    "@agimon-ai/po-build": "0.0.0-alpha.27",
+    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.27",
+    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@types/node": "26.6.5",
+    "@vitest/coverage-v8": "5.0.4",
+    "tsdown": "0.23.1",
+    "typescript": "7.0.2",
+    "vitest": "5.0.4"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "1.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "poServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    },
+    "provides": {
+      "session": [
+        "po/codemode"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
 }

package/src/prompts/po-use-codemode/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: po-use-codemode
+description: 'Use @agimon-ai/po-codemode: run TypeScript against live Po objects with the discover and exec tools. Use when a task needs several steps on a namespace such as browser in one call.'
+---
+
+# Use code mode
+
+Code mode gives you two tools.
+
+- `discover`: with no arguments, lists the namespaces this session has (for example `browser`) and their members, plus reusable scripts from the active domains and this session's saved scripts (capped, newest first). `discover({ namespace })` shows full TypeScript declarations; `discover({ query })` finds members, script names and script descriptions.
+- `exec`: runs a TypeScript async function body. Namespaces are in scope as globals. `return` a value, use `console.log` for notes, `image(data, mimeType)` to send back a screenshot, and `sleep(ms)` to wait.
+
+```ts
+// exec({ code })
+const snapshot = await browser.snapshot({ search: 'Sign in' });
+console.log(snapshot);
+return 'done';
+```
+
+## Saved scripts and chaining
+
+Every `exec` body is saved, even when it fails, as `<session temp folder>/codemode/exec-<n>.ts`. The result ends with `Saved as session:exec-<n> (<absolute path>)`, so you can fix the file and rerun it.
+
+A saved script becomes an async function of one parameter, `args`, when you import it; its `return` is the call's result. `.default` is the same function.
+
+```ts
+// exec({ code })
+const titles = await import('session:exec-3');
+return await titles({ url: 'https://example.com' });
+```
+
+Specifiers: an absolute path; `./name` or `name.ts`, relative to the session `codemode/` folder; `session:<name>`; or `<domain>/<name>` for an active domain's script. Use `await import(...)`; a static `import ... from` statement is a compile error. Imported code shares the run's deadline and namespaces, and its errors name the imported file and line. The edge host cannot import.
+
+## Promote a script
+
+To keep a useful script, copy the saved file with normal file tools to `plugins/<domain>/codemode/<name>.ts`. Start it with a `/** ... */` comment whose first paragraph says what it does and what `args` it takes; `discover` shows that paragraph. Sessions with that domain active then call it as `<domain>/<name>`.
+
+## Rules
+
+- Keep each `exec` call to one logical step, then look at the result before the next.
+- Scripts stop at their deadline (30 s by default, `timeoutMs` up to 120 s). Long loops and recursion are stopped too.
+- Objects you get from a namespace are live. Listeners you add and the objects themselves stop working when the run ends; keep state in the namespace, not in script variables.
+- `exec` runs inside the Po server with full trust, like `bash`. Do not use it to bypass a blocked tool.
+- There is no `eval`, `Function`, `setTimeout`, `fetch`, `require` or `process` inside a script.