@anhlp/alp-paseo 0.0.1-beta.7 → 0.0.1-beta.8

package/README.md

@@ -64,13 +64,13 @@ This follows [Paseo's native archive contract](https://github.com/getpaseo/paseo
 
 ## Install
 
-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
+This is the beta `0.0.1-beta.8` (npm's `beta` and `latest` tags; check with
 `npm view @anhlp/alp-paseo dist-tags`); name it when you install (`@beta`, or
-exactly `@0.0.1-beta.3`). See the
+exactly `@0.0.1-beta.8`). 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 <1.0.0` (the published `0.0.1-beta.3` declares `<0.13.0`, so 0.11.x or 0.12.x), Node.js 22 (22.12 or later) or 24 on Linux or macOS
+Requires Paseo `>=0.11.1 <1.0.0` (from `0.0.1-beta.4`; `0.0.1-beta.3` declared `<0.13.0`), 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.
 
@@ -168,7 +168,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.1-beta.3`)**: it needs `@anhlp/alp-gateway`, which is not
+Remote mode is **not part of the beta (`0.0.1-beta.8`)**: 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

package/client/compact.ts

@@ -0,0 +1,41 @@
+import type { PluginAgentCommandContext, PluginClientContext } from '@getpaseo/plugin/client';
+import { agentCompact } from '../shared/compact';
+
+/**
+ * Compact context for an ALP agent (t-de1a): main writes a checkpoint, then its context is compacted
+ * natively or replaced by a fresh conversation seeded with it, now or at the end of its turn. The
+ * runtime's own notice in the timeline says when it starts and ends; a refusal is thrown to the host.
+ */
+export async function compactAgent({ agent, paseo, rpc }: Pick<PluginAgentCommandContext, 'agent' | 'paseo' | 'rpc'>) {
+  if (agent.provider !== 'alp') throw new Error('Compact context is for ALP agents only');
+  // The provider knows a session by the id in its persistence handle, which is not the agent's id.
+  let persisted: string | undefined;
+  try {
+    const handle = paseo.agents.ref(agent.id);
+    if (!handle.current()) await handle.refresh();
+    persisted = handle.current()?.persistence?.sessionId ?? undefined;
+  } catch { /* the agent id alone */ }
+  const sessions = [...new Set([persisted, agent.id].filter((id): id is string => Boolean(id)))];
+  return rpc(agentCompact, { sessions });
+}
+
+/** The command-center item and the "/alp-compact" slash command of an ALP agent. */
+export function addCompactCommands(client: PluginClientContext) {
+  const removeItem = client.addCommandCenterItem({
+    id: 'alp-compact-agent',
+    title: 'Compact ALP agent context',
+    icon: 'Shrink',
+    keywords: ['compact', 'context', 'checkpoint', 'alp'],
+    context: 'agent',
+    async onSelect(context) { await compactAgent(context); },
+  });
+  // Not "/compact": Claude Code has its own, which skips ALP's checkpoint.
+  const removeSlash = client.addSlashCommand({
+    name: 'alp-compact',
+    description: 'Compact this ALP agent\'s context after a checkpoint',
+    argumentHint: '',
+    context: 'agent',
+    async onSubmit(context) { await compactAgent(context); },
+  });
+  return () => { removeItem(); removeSlash(); };
+}

package/index.client.tsx

@@ -3,6 +3,7 @@ import { TasksPanel, TasksScreen } from './client/tasks-panel';
 import { TASKS_SCREEN, addTaskPills, tasksScreen } from './client/task-pills';
 import { LibrarySettings, ProjectLibraryPanel, TeamsSettings, AgentsSettings, SkillsSettings, HooksSettings, McpSettings } from './client/library';
 import { UsageScreen } from './client/usage';
+import { addCompactCommands } from './client/compact';
 
 /**
  * ALP's client contributions: the Tasks panel of a workspace's project, the Tasks screen
@@ -38,6 +39,8 @@ export default function contribute(client: PluginClientContext) {
     context: 'agent',
     onSubmit({ workspace, args, openScreen }) { openScreen(tasksScreen(workspace.id, workspace.directory || workspace.projectRootPath, args.trim() || undefined)); },
   });
+  // Compact context (t-de1a): a command-center item and "/alp-compact" for an ALP agent.
+  const removeCompact = addCompactCommands(client);
   const removeSettings = client.addSettingsScreen({ id: 'alp-settings', title: 'ALP', icon: 'Bot', Component: LibrarySettings });
   const removeHostSettings = [
     { id: 'alp-templates', title: 'Templates', icon: 'Users', Component: TeamsSettings },
@@ -49,5 +52,5 @@ export default function contribute(client: PluginClientContext) {
   const removeUsage = client.addSettingsScreen({ id: 'alp-usage', title: 'Usage', icon: 'ChartNoAxesCombined', Component: UsageScreen });
   const removeUsagePanel = client.addWorkspacePanel({ id: 'alp-usage', title: 'Usage', icon: 'ChartNoAxesCombined', context: 'workspace', Component: UsageScreen });
   const removeProject = client.addWorkspacePanel({ id: 'alp-project', title: 'ALP project', icon: 'Bot', context: 'workspace', Component: ProjectLibraryPanel });
-  return () => { removePanel(); removeScreen(); removePills(); removeCommand(); removeScreenCommand(); removeSlash(); removeSettings(); removeHostSettings.forEach(remove => remove()); removeProject(); removeUsage(); removeUsagePanel(); };
+  return () => { removePanel(); removeScreen(); removePills(); removeCommand(); removeScreenCommand(); removeSlash(); removeCompact(); removeSettings(); removeHostSettings.forEach(remove => remove()); removeProject(); removeUsage(); removeUsagePanel(); };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anhlp/alp-paseo",
-  "version": "0.0.1-beta.7",
+  "version": "0.0.1-beta.8",
   "type": "module",
   "files": [
     "paseo-plugin.json",
@@ -16,12 +16,12 @@
     "@anthropic-ai/claude-agent-sdk": "0.3.292",
     "@anthropic-ai/sdk": "0.131.0",
     "@modelcontextprotocol/sdk": "1.32.1",
-    "zod": "4.4.3",
-    "@anhlp/alp-protocol": "0.0.1-beta.7",
-    "@anhlp/alp-core": "0.0.1-beta.7",
-    "@anhlp/alp-runtime": "0.0.1-beta.7",
-    "@anhlp/alp-daemon": "0.0.1-beta.7",
-    "@anhlp/alp-client": "0.0.1-beta.7",
+    "zod": "4.6.7",
+    "@anhlp/alp-protocol": "0.0.1-beta.8",
+    "@anhlp/alp-core": "0.0.1-beta.8",
+    "@anhlp/alp-runtime": "0.0.1-beta.8",
+    "@anhlp/alp-daemon": "0.0.1-beta.8",
+    "@anhlp/alp-client": "0.0.1-beta.8",
     "ws": "^8.22.0"
   },
   "peerDependencies": {

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

@@ -922,7 +922,7 @@ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ================================================================================
-zod@4.4.3 (MIT)
+zod@4.6.7 (MIT)
 ================================================================================
 
 MIT License