@anhlp/alp-paseo 0.0.0-beta.1 → 0.0.1-beta.3

package/README.md

@@ -45,12 +45,13 @@ and project overrides.
 
 ## Install
 
-This is the beta `0.0.0-beta.1` (not published yet); name it when you install (`@beta`, or
-exactly `@0.0.0-beta.1`). See the
+This is the beta `0.0.1-beta.3` (until it is on npm, `@beta` installs `0.0.0-beta.2`, which Paseo 0.12 refuses; check with
+`npm view @anhlp/alp-paseo dist-tags`); name it when you install (`@beta`, or
+exactly `@0.0.1-beta.3`). See the
 [release notes](https://github.com/phucanh08/alp/blob/main/docs/alp/beta-release-notes.md) and
 [install, upgrade and removal steps](https://github.com/phucanh08/alp/blob/main/docs/alp/beta-install.md).
 
-Requires Paseo `>=0.11.1 <0.12.0`, Node.js 22 (22.12 or later) or 24 on Linux or macOS
+Requires Paseo `>=0.11.1 <0.13.0` (0.11.x or 0.12.x), Node.js 22 (22.12 or later) or 24 on Linux or macOS
 (Windows and Node.js 26 are experimental), and an authenticated native Codex or Claude Code
 executable on PATH.
 
@@ -74,6 +75,16 @@ paseo plugin add npm:@anhlp/alp-paseo@beta
 paseo provider models alp
 ```
 
+This works from `0.0.0-beta.2`, which ships no type declarations. In `0.0.0-beta.1` the `npm:`
+source fails: Paseo installs it without peers and cannot resolve the `@getpaseo/*` types the
+plugin's declarations import ([#111](https://github.com/phucanh08/alp/issues/111)). With beta.1,
+install it with npm and add it by path:
+
+```sh
+npm install -g @anhlp/alp-paseo@beta
+paseo plugin add "$(npm root -g)/@anhlp/alp-paseo"
+```
+
 From then on the plugin keeps alpd running while Paseo runs. It starts alpd when
 Paseo starts, checks every 5 seconds, and starts it again when alpd is down; with
 `alp daemon install` (experimental), it starts alpd through that service. Sessions open in Paseo
@@ -118,7 +129,7 @@ for existing projects, model selection, permissions, and runtime limitations.
 
 ## Remote mode (deferred, not in the beta)
 
-Remote mode is **not part of `0.0.0-beta.1`**: it needs `@anhlp/alp-gateway`, which is not
+Remote mode is **not part of the beta (`0.0.1-beta.3`)**: it needs `@anhlp/alp-gateway`, which is not
 published. The text below describes the code in this repository for development only.
 
 To use ALP running on another machine, start the daemon process that loads this plugin with
@@ -159,7 +170,19 @@ Do not use `--legacy-peer-deps` for a standalone installation unless you supply
 peers explicitly. The binary is also discoverable on PATH, so registration is optional
 for a global install. For a local install, run
 `./node_modules/.bin/alp-web-integration --register` with the intended `ALP_HOME`.
-The existing `paseo plugin add npm:@anhlp/alp-paseo@beta` route for a Paseo host remains
+
+A plugin directory managed by `paseo plugin add npm:…` is not a standalone web
+installation. Paseo installs it without peers and supplies `@getpaseo/plugin` through
+its plugin loader. Running `node <managed-plugin>/server/dist/main.js --register`
+directly bypasses that loader and can fail with `ERR_MODULE_NOT_FOUND` for
+`@getpaseo/plugin`; this invocation from the managed directory is unsupported
+([#154](https://github.com/phucanh08/alp/issues/154)). Use the normal npm installation
+and `alp-web-integration --register` shown above. For a local npm installation with
+required peers, use `./node_modules/.bin/alp-web-integration --register` with the
+intended `ALP_HOME`. Registration records the entry path; it does not install missing
+peers or turn a host-managed plugin into a standalone installation.
+
+Adding the plugin to a Paseo host (`npm:` from beta.2; by path in beta.1, see above) remains
 available independently of this standalone web process.
 
 Core upgrades no longer update a bundled plugin: upgrade `@anhlp/alp-paseo`

package/client/library.tsx

@@ -55,7 +55,7 @@ export const LANGUAGES = [
   { label: 'Deutsch', value: 'German' }, { label: 'Español', value: 'Spanish' },
 ];
 /** librarySkills: for agents, the skills the library gives it by name (role-skills.json). */
-type Entry = { kind: Kind; name: string; source: string; overrides?: string; content: Content; revision: string | null; usedBy: string[]; librarySkills?: string[] };
+type Entry = { kind: Kind; name: string; source: string; overrides?: string; content: Content; revision: string | null; usedBy: string[]; librarySkills?: string[]; secrets?: string[] };
 /** `readOnly`: the library can only be looked at from here (ALP remote mode), and why. */
 type Where = { projectRoot: string | null; library: string; readOnly?: { reason: string; unlisted?: string } } | null;
 
@@ -189,7 +189,7 @@ type WorkspaceProps = {
 };
 
 /** The aside's groups: General (the library only), Organisation, Capabilities and Runtimes, each kind with its entries. */
-export function navGroups(scope: Scope, lists: Lists, readOnly = false): NavGroup[] {
+export function navGroups(scope: Scope, lists: Lists): NavGroup[] {
   const groups: NavGroup[] = scope === 'library' ? [{ key: 'General', label: 'General', items: [{ key: 'language', label: 'Language', icon: 'Languages' }] }] : [];
   for (const item of shownIn(scope)) {
     let group = groups.find(candidate => candidate.label === item.group);
@@ -197,8 +197,7 @@ export function navGroups(scope: Scope, lists: Lists, readOnly = false): NavGrou
     const rows = lists[item.kind];
     group.items.push({
       key: item.kind, label: item.title, icon: item.icon, ...(rows ? { count: rows.length } : {}),
-      // A read-only library's entries cannot be opened, so the aside lists kinds only.
-      children: readOnly ? [] : (rows ?? []).map(row => ({ key: row.name, label: row.name, tone: sourceTone(row.source) })),
+      children: (rows ?? []).map(row => ({ key: row.name, label: row.name, tone: sourceTone(row.source) })),
     });
   }
   return groups;
@@ -209,7 +208,7 @@ export function LibraryWorkspace({ theme, compact, scope, where, lists, error, s
   const styles = useMemo(() => makeStyles(theme, compact), [theme, compact]);
   const title = scope === 'library' ? 'ALP library' : 'ALP project';
   const subtitle = scope === 'library' ? where?.library : where?.projectRoot ?? undefined;
-  const groups = navGroups(scope, lists, !!where?.readOnly);
+  const groups = navGroups(scope, lists);
   const onSelect = (kind: string, name?: string) => actions.select(kind === 'language' ? { kind } : { kind: kind as Kind, ...(name ? { name } : {}) });
   if (scope === 'project' && where?.readOnly?.unlisted) {
     return <View style={styles.screen}><Text style={styles.muted}>{where.readOnly.unlisted}</Text></View>;
@@ -221,6 +220,23 @@ export function LibraryWorkspace({ theme, compact, scope, where, lists, error, s
     return <LanguageSettings theme={theme} compact={compact} language={language ?? null} error={error} actions={actions} layout={{ title, subtitle, groups, onSelect, initialCollapsed, embedded }} styles={styles} />;
   }
   const kind = kindOf(selection.kind);
+  if (where?.readOnly && (selection.name || selection.creating)) {
+    // A selection can change before its async get resolves; never label the previous entry as the new one.
+    const viewed = !where.readOnly.unlisted && entry && entry.name === selection.name && entry.kind === selection.kind ? entry : null;
+    return <SideNavLayout theme={theme} compact={compact} title={title} subtitle={subtitle} groups={groups} active={{ item: selection.kind, ...(selection.name ? { child: selection.name } : {}) }} onSelect={onSelect} initialCollapsed={initialCollapsed} embedded={embedded}
+      breadcrumb={[kind.title, selection.name ?? 'Read only']}
+      badges={viewed ? <Pill theme={theme} label={sourceLabel(viewed.source)} tone={sourceTone(viewed.source)} /> : null}
+      actions={<Button theme={theme} icon="ArrowLeft" label={`All ${kind.title.toLowerCase()}`} onPress={() => actions.select({ kind: selection.kind })} />}>
+      <Text style={styles.muted}>{where.readOnly.reason}</Text>
+      {error || where.readOnly.unlisted ? <Text style={styles.muted}>{error ?? where.readOnly.unlisted}</Text> : selection.creating ? <Text style={styles.muted}>Create entries on the ALP host.</Text> : !viewed ? <Text style={styles.muted}>Loading…</Text> : <>
+        {viewed.overrides ? <Text style={styles.small}>Overrides {sourceLabel(viewed.overrides)}.</Text> : null}
+        {viewed.usedBy.length ? <Text style={styles.small}>Used by {viewed.usedBy.join(', ')}.</Text> : null}
+        {viewed.librarySkills?.length ? <Text style={styles.small}>Library skills: {viewed.librarySkills.join(', ')}.</Text> : null}
+        {viewed.secrets?.length ? <Text style={styles.muted}>Secrets hidden: {viewed.secrets.join(', ')}. Secret markers stand for values kept on the ALP host.</Text> : null}
+        <Text selectable style={styles.small}>{JSON.stringify(viewed.content, null, 2)}</Text>
+      </>}
+    </SideNavLayout>;
+  }
   if (selection.name || selection.creating) {
     return <EntryEditor key={`${selection.kind}/${selection.name ?? 'new'}/${entry?.revision ?? 'new'}/${(entry?.librarySkills ?? []).join(',')}`} theme={theme} compact={compact} scope={scope} kind={selection.kind} entry={selection.creating ? null : entry}
       lists={lists} actions={actions} layout={{ title, subtitle, groups, onSelect, initialCollapsed, embedded }} />;
@@ -306,7 +322,7 @@ export function KindOverview({ theme, compact, scope, kind, rows, error, where,
         <View style={styles.table}>
           {shown.map((row, index) => (
             <View key={row.name} style={[styles.tableRow, index ? styles.tableRowRule : null]}>
-              <Pressable accessibilityRole={readOnly ? undefined : 'button'} accessibilityLabel={`${readOnly ? '' : 'Open '}${one} ${row.name}`} disabled={!!readOnly} onPress={() => actions.select({ kind, name: row.name })} style={styles.rowMain}>
+              <Pressable accessibilityRole="button" accessibilityLabel={`Open ${one} ${row.name}`} onPress={() => actions.select({ kind, name: row.name })} style={styles.rowMain}>
                 <View style={styles.rowTitle}>
                   <Text style={styles.name}>{row.name}</Text>
                   <Pill theme={theme} label={sourceLabel(row.source)} tone={sourceTone(row.source)} />

package/client/task-pills.ts

@@ -1,8 +1,12 @@
-import type { PaseoAgent, PaseoAgentListResult } from '@getpaseo/client';
 import type { PluginButton, PluginButtonMenuEntry, PluginButtonRegistration, PluginClientContext, PluginOpenScreenInput } from '@getpaseo/plugin/client';
 import { tasksList, type TaskRow } from '../shared/tasks';
 import { stateOf } from './tasks-panel';
 
+// Through the host SDK, not `@getpaseo/client`: that is only a peer, which `paseo plugin add npm:`
+// does not install, and Paseo resolves every type import of a plugin's sources (#111).
+type PaseoAgentListResult = Awaited<ReturnType<PluginClientContext['paseo']['agents']['list']>>;
+type PaseoAgent = PaseoAgentListResult['entries'][number]['agent'];
+
 /**
  * The Tasks pill in the composer of each ALP agent. On a phone the workspace's "+" tab,
  * and with it the Tasks panel, is out of reach, but the composer is not. The pill shows

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anhlp/alp-paseo",
-  "version": "0.0.0-beta.1",
+  "version": "0.0.1-beta.3",
   "type": "module",
   "files": [
     "paseo-plugin.json",
@@ -16,20 +16,20 @@
     "@anthropic-ai/sdk": "0.131.0",
     "@modelcontextprotocol/sdk": "1.32.1",
     "zod": "4.4.3",
-    "@anhlp/alp-protocol": "0.0.0-beta.1",
-    "@anhlp/alp-core": "0.0.0-beta.1",
-    "@anhlp/alp-runtime": "0.0.0-beta.1",
-    "@anhlp/alp-daemon": "0.0.0-beta.1",
-    "@anhlp/alp-client": "0.0.0-beta.1",
+    "@anhlp/alp-protocol": "0.0.1-beta.3",
+    "@anhlp/alp-core": "0.0.1-beta.3",
+    "@anhlp/alp-runtime": "0.0.1-beta.3",
+    "@anhlp/alp-daemon": "0.0.1-beta.3",
+    "@anhlp/alp-client": "0.0.1-beta.3",
     "ws": "^8.22.0"
   },
   "peerDependencies": {
-    "@getpaseo/plugin": ">=0.11.1 <0.12.0",
+    "@getpaseo/plugin": ">=0.11.1 <0.13.0",
     "react": ">=19 <20",
     "react-native": ">=0.81 <0.82",
-    "@getpaseo/client": ">=0.11.1 <0.12.0",
-    "@getpaseo/protocol": ">=0.11.1 <0.12.0",
-    "@getpaseo/relay": ">=0.11.1 <0.12.0",
+    "@getpaseo/client": ">=0.11.1 <0.13.0",
+    "@getpaseo/protocol": ">=0.11.1 <0.13.0",
+    "@getpaseo/relay": ">=0.11.1 <0.13.0",
     "ws": "*"
   },
   "peerDependenciesMeta": {
@@ -69,35 +69,29 @@
   },
   "exports": {
     ".": {
-      "types": "./server/dist/index.d.ts",
       "default": "./server/dist/index.js"
     },
     "./main": {
-      "types": "./server/dist/main.d.ts",
       "default": "./server/dist/main.js"
     },
     "./web": {
-      "types": "./server/dist/web.d.ts",
       "default": "./server/dist/web.js"
     },
     "./remote": {
-      "types": "./server/dist/remote/index.d.ts",
       "default": "./server/dist/remote/index.js"
     },
     "./paseo/*": {
-      "types": "./server/dist/paseo/*.d.ts",
       "default": "./server/dist/paseo/*.js"
     },
     "./panel/*": {
-      "types": "./server/dist/panel/*.d.ts",
       "default": "./server/dist/panel/*.js"
     }
   },
   "devDependencies": {
-    "@getpaseo/client": "0.11.1",
-    "@getpaseo/plugin": "0.11.1",
-    "@getpaseo/protocol": "0.11.2",
-    "@getpaseo/relay": "0.11.1",
+    "@getpaseo/client": "0.12.0",
+    "@getpaseo/plugin": "0.12.0",
+    "@getpaseo/protocol": "0.12.0",
+    "@getpaseo/relay": "0.12.0",
     "esbuild": "0.25.12",
     "react-dom": "19.1.0"
   }

package/paseo-plugin.json

@@ -1,5 +1,5 @@
 {
   "id": "alp-provider",
   "description": "Run filesystem-defined ALP agents",
-  "requirements": { "paseo": ">=0.11.1 <0.12.0" }
+  "requirements": { "paseo": ">=0.11.1 <0.13.0" }
 }

package/server/dist/THIRD-PARTY-NOTICES.txt

@@ -4,7 +4,7 @@ The bundled files of this package include code from the packages below; each kee
 its own licence, reproduced here.
 
 ================================================================================
-@getpaseo/protocol@0.11.2 (Apache-2.0)
+@getpaseo/protocol@0.12.0 (Apache-2.0)
 ================================================================================
 
 Copyright (c) 2025-present Mohamed Boudra
@@ -220,7 +220,7 @@ Portions of this software are licensed as follows:
    limitations under the License.
 
 ================================================================================
-@getpaseo/relay@0.11.1 (Apache-2.0)
+@getpaseo/relay@0.12.0 (Apache-2.0)
 ================================================================================
 
 Copyright (c) 2025-present Mohamed Boudra