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

package/README.md

@@ -45,13 +45,13 @@ and project overrides.
 
 ## Install
 
-This is the beta `0.0.0-beta.2` (until it is on npm, `@beta` installs `0.0.0-beta.1`; check with
+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.0-beta.2`). See the
+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.
 
@@ -129,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 the beta (`0.0.0-beta.2`)**: 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
@@ -170,6 +170,18 @@ 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`.
+
+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.
 

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anhlp/alp-paseo",
-  "version": "0.0.0-beta.2",
+  "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.2",
-    "@anhlp/alp-core": "0.0.0-beta.2",
-    "@anhlp/alp-runtime": "0.0.0-beta.2",
-    "@anhlp/alp-daemon": "0.0.0-beta.2",
-    "@anhlp/alp-client": "0.0.0-beta.2",
+    "@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": {
@@ -88,10 +88,10 @@
     }
   },
   "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