@anhlp/alp-protocol 0.0.0-beta.1 → 0.10.0

package/README.md

@@ -1,16 +1,6 @@
 # @anhlp/alp-protocol
 
-ALP JSON-RPC protocol v1: JSON Schemas, portable session/event DTOs, wire constants, a dependency-free
-schema checker, golden fixtures and a conformance runner. No Node, runtime or provider dependencies in
-the public contract (the conformance runner alone uses `node:net`).
-
-- Specification: [docs/protocol/alp-json-rpc-v1.md](../../docs/protocol/alp-json-rpc-v1.md)
-- Client integration: [docs/protocol/v1-client-integration.md](../../docs/protocol/v1-client-integration.md)
-- Normative schema: `schema/methods-v1.json` (methods, errors, capabilities, definitions); messages: `schema/ipc-v1.json`
-- Golden values: `fixtures/v1/cases.json` (`node scripts/fixtures.mjs` writes it)
-- Conformance: `node conformance/run.mjs --socket <path> [--profiles …]` against any implementation
-
-After editing `schema/methods-v1.json`, run `npm run generate --workspace=@anhlp/alp-protocol` (a test fails while `src/contract-v1.js` is stale).
+Stable JSON-RPC v1, portable session/event DTOs, JSON Schema and fixtures.
 
 Build: `npm run build --workspace=@anhlp/alp-protocol`. Test: `npm run test --workspace=@anhlp/alp-protocol`.
 

package/dist/dto.d.ts

@@ -34,71 +34,3 @@ export type Pin = {
     /** The task the claiming assignment works on. */
     task?: string;
 };
-/** A project's task as task screens show it (schema/methods-v1.json `taskRow`). */
-export type TaskRow = {
-    id: string;
-    title: string;
-    type: string;
-    priority: number;
-    status: 'open' | 'in_progress' | 'review' | 'closed';
-    /** Changes with every write; task.update and task.gate.resolve refuse an older one given as `ifRev`. */
-    rev: number;
-    parent?: string;
-    assignee?: string;
-    ready: boolean;
-    blockedBy?: string[];
-    waits?: string[];
-    approvals?: Array<{
-        gate: string;
-        note: string;
-    }>;
-    handoff?: {
-        outcome: string;
-        summary: string;
-        agent?: string;
-    };
-    closed?: {
-        reason: string;
-        summary?: string;
-        at: string;
-    };
-    description?: string;
-    labels?: string[];
-    paths?: string[];
-    progress?: {
-        done: number;
-        total: number;
-    };
-    createdAt?: string;
-    updatedAt: string;
-};
-export type LibraryKind = 'agents' | 'skills' | 'mcp' | 'hooks' | 'teams' | 'providers';
-export type LibraryScope = 'library' | 'project';
-export type LibrarySource = 'builtin' | 'library' | 'project';
-/** Letters, digits, '.', '_' or '-', not '.' or '..'. */
-export type EntryName = string;
-export type LibraryEntryRow = {
-    name: string;
-    source: LibrarySource;
-    overrides?: LibrarySource;
-    description?: string;
-    usedBy?: string[];
-};
-export type TeamRow = {
-    id: string;
-    label?: string;
-    description?: string;
-    source: LibrarySource;
-    overrides?: LibrarySource;
-    error?: string;
-};
-/** language null: unset, so `default` applies. */
-export type LanguageSetting = {
-    language: string | null;
-    applies: string;
-    default: string;
-};
-/** Stands for a stored secret in library.get content; sent back in library.save it keeps the stored value. */
-export type SecretMarker = {
-    $secret: 'keep';
-};

package/dist/events.d.ts

@@ -1,9 +1,7 @@
 import type { RuntimeKind, MailEvent, Pin } from './dto.js';
 /** Provider-neutral session events (plans/reference/ALPD.md §4). Viewers project them; the runtime never imports a viewer. */
-/** `code: 'outcome_unknown'` when the provider may or may not have received the request (ALPD §66). */
 export type AlpError = {
     message: string;
-    code?: string;
 };
 export type TimelineItem = {
     kind: 'user_message';
@@ -214,12 +212,6 @@ export type Envelope = {
     epoch: string;
     /** Strictly increasing per session. */
     seq: number;
-    /**
-     * Position in its tree's stored timeline, set by alpd on the events it keeps: strictly
-     * increasing per root across restarts, so `session.attach { after }` replays only what
-     * a reconnecting client missed (ALPD §66).
-     */
-    cursor?: number;
     ts: string;
     event: AlpEvent;
 };

package/dist/rpc.d.ts

@@ -1,8 +1,4 @@
 /** Portable JSON-RPC structures; implementations and provider SDKs stay outside protocol. */
-import type { RuntimeKind, Pin } from './dto.js';
-import type { AlpError, Envelope, SessionSnapshot, TreeStatus, UserQuestion } from './events.js';
-import type { PauseState, PromptContent, RecallAnswer, SessionPreview, SessionSpec, SessionSummary } from './session.js';
-import type { EntryName, LanguageSetting, LibraryEntryRow, LibraryKind, LibraryScope, LibrarySource, TaskRow, TeamRow } from './dto.js';
 export type RpcId = string | number | null;
 export type RpcErrorData = {
     code: number;
@@ -28,471 +24,5 @@ export type RpcResponse = {
 export type EventNotification = {
     jsonrpc: '2.0';
     method: 'event';
-    params: Envelope;
+    params: import('./events.js').Envelope;
 };
-/** Names a daemon may list in its daemon.hello result (schema/methods-v1.json `capabilities`). */
-export type Capability = 'attach.after' | 'prompt.receipts' | 'extension.methods' | 'team' | 'task' | 'library' | 'settings.language';
-/** `data.reason` values alpd sets on errors (docs/protocol/alp-json-rpc-v1.md §5.3). */
-export type ErrorReason = 'hello_required' | 'protocol_version' | 'invalid_params' | 'invalid_id' | 'batch_unsupported' | 'frame_too_large' | 'response_too_large' | 'persistence_failed' | 'outcome_unknown' | 'key_conflict' | 'invalid_path' | 'invalid_scope' | 'invalid_entry' | 'secret_marker' | 'not_alp_project' | 'unknown_task' | 'not_found' | 'unsafe_path' | 'revision_conflict' | 'task_state' | 'in_use' | 'busy' | 'unreadable';
-type Empty = Record<string, never>;
-/**
- * Params and result of every v1 method, as schema/methods-v1.json defines them; the protocol tests
- * type-check the golden fixtures against this map, so the two cannot drift. Results may carry
- * properties this map does not name: clients ignore them.
- */
-export type RpcMethodMap = {
-    'daemon.hello': {
-        params: {
-            protocolVersion: 1;
-            client?: {
-                name: string;
-                version: string;
-            };
-            capabilities?: string[];
-        };
-        result: {
-            protocolVersion: 1;
-            daemonVersion?: string;
-            pid?: number;
-            capabilities?: string[];
-        };
-    };
-    'daemon.status': {
-        params: Empty;
-        result: {
-            pid: number;
-            startedAt: string;
-            version: string;
-            protocolVersion: number;
-            sessions: number;
-            questions: number;
-            previousExit?: {
-                kind: 'clean' | 'crash';
-                at?: string;
-            };
-            persistence?: Record<string, unknown>;
-            health: {
-                live: boolean;
-                ready: boolean;
-                checks: Array<{
-                    id: string;
-                    ok: boolean;
-                    code?: string;
-                    message?: string;
-                }>;
-            };
-        };
-    };
-    'daemon.shutdown': {
-        params: Empty;
-        result: Empty;
-    };
-    'daemon.pause': {
-        params: {
-            runtime?: RuntimeKind;
-            now?: boolean;
-            reason?: string;
-        };
-        result: PauseState;
-    };
-    'daemon.resume': {
-        params: {
-            runtime?: RuntimeKind;
-        };
-        result: PauseState;
-    };
-    'daemon.pauses': {
-        params: Empty;
-        result: PauseState;
-    };
-    'daemon.usage': {
-        params: {
-            refresh?: boolean;
-        };
-        result: {
-            providers: Array<Record<string, unknown>>;
-        };
-    };
-    'catalog.get': {
-        params: Empty;
-        result: {
-            models: Array<Record<string, unknown>>;
-            modes: Array<Record<string, unknown>>;
-            thinkingOptions?: unknown;
-            defaultModel: string;
-        };
-    };
-    'assignment.recall': {
-        params: {
-            assignmentId?: string;
-            taskId?: string;
-            projectRoot?: string;
-            question: string;
-        };
-        result: RecallAnswer;
-    };
-    'board.list': {
-        params: {
-            projectRoot: string;
-        };
-        result: {
-            pins: Pin[];
-        };
-    };
-    'question.list': {
-        params: {
-            projectRoot?: string;
-        };
-        result: {
-            questions: UserQuestion[];
-        };
-    };
-    'question.answer': {
-        params: {
-            questionId: string;
-            text?: string;
-            dismiss?: boolean;
-            reason?: string;
-        };
-        result: {
-            questionId: string;
-        };
-    };
-    'session.create': {
-        params: {
-            sessionId?: string;
-            spec: SessionSpec;
-            history?: 'skip' | 'replay';
-            delegation?: boolean;
-            resume?: boolean;
-        };
-        result: {
-            session: SessionSnapshot;
-            attached: boolean;
-            resumed?: true;
-            durable?: boolean;
-        };
-    };
-    'session.preview': {
-        params: {
-            spec: SessionSpec;
-        };
-        result: {
-            preview: SessionPreview;
-        };
-    };
-    'session.attach': {
-        params: {
-            sessionId: string;
-            replay?: boolean;
-            after?: number;
-        };
-        result: {
-            session: SessionSummary;
-            cursor: number;
-            reset?: true;
-        };
-    };
-    'session.release': {
-        params: {
-            sessionId: string;
-        };
-        result: {
-            closed: boolean;
-        };
-    };
-    'session.prompt': {
-        params: {
-            sessionId: string;
-            clientMessageId: string;
-            delivery?: 'auto' | 'steer';
-            content: PromptContent;
-        };
-        /** `{}` from a daemon without prompt.receipts. */
-        result: {
-            outcome?: 'accepted' | 'failed';
-            error?: AlpError;
-            duplicate?: boolean;
-            durable?: boolean;
-        };
-    };
-    'session.interrupt': {
-        params: {
-            sessionId: string;
-        };
-        result: Empty;
-    };
-    'session.configure': {
-        params: {
-            sessionId: string;
-            mode?: string;
-        };
-        result: {
-            session: SessionSnapshot;
-        };
-    };
-    'session.close': {
-        params: {
-            sessionId: string;
-        };
-        result: Empty;
-    };
-    'session.rename': {
-        params: {
-            sessionId: string;
-            title: string;
-        };
-        result: {
-            session: SessionSummary;
-        };
-    };
-    'session.archive': {
-        params: {
-            sessionId: string;
-            archived?: boolean;
-        };
-        result: {
-            session: SessionSummary;
-        };
-    };
-    'session.get': {
-        params: {
-            sessionId: string;
-        };
-        result: {
-            session: SessionSummary;
-        };
-    };
-    'session.list': {
-        params: {
-            projectRoot?: string;
-            rootsOnly?: boolean;
-            includeClosed?: boolean;
-            includeArchived?: boolean;
-        };
-        result: {
-            sessions: SessionSummary[];
-        };
-    };
-    'session.status': {
-        params: {
-            sessionId: string;
-        };
-        result: {
-            status: TreeStatus;
-        };
-    };
-    'session.message': {
-        params: {
-            sessionId: string;
-            text: string;
-        };
-        result: Empty;
-    };
-    'session.log': {
-        params: {
-            sessionId: string;
-        };
-        result: {
-            rootId: string;
-            entries: Array<Record<string, unknown>>;
-        };
-    };
-    'extension.register': {
-        params: {
-            method: string;
-        };
-        result: {
-            registered: string;
-        };
-    };
-    'extension.unregister': {
-        params: {
-            method: string;
-        };
-        result: {
-            unregistered: string;
-        };
-    };
-    'team.list': {
-        params: {
-            projectRoot?: string;
-        };
-        result: {
-            projectRoot: string | null;
-            teams: TeamRow[];
-        };
-    };
-    'task.list': {
-        params: {
-            projectRoot: string;
-        };
-        result: {
-            projectRoot: string;
-            tasks: TaskRow[];
-            unreadable: Array<{
-                file: string;
-                error: string;
-            }>;
-            revision: string;
-        };
-    };
-    'task.create': {
-        params: {
-            projectRoot: string;
-            title: string;
-            priority?: number;
-            requestId?: string;
-        };
-        result: {
-            id: string;
-            duplicate?: true;
-        };
-    };
-    'task.update': {
-        params: {
-            projectRoot: string;
-            id: string;
-            action: 'close' | 'reopen';
-            note?: string;
-            ifRev?: number;
-        };
-        result: {
-            id: string;
-            status: string;
-            rev: number;
-            landed?: string;
-        };
-    };
-    'task.gate.resolve': {
-        params: {
-            projectRoot: string;
-            id: string;
-            gate: string;
-            note?: string;
-            ifRev?: number;
-        };
-        result: {
-            id: string;
-            status: string;
-            rev: number;
-        };
-    };
-    'library.list': {
-        params: {
-            kind: LibraryKind;
-            projectRoot?: string;
-        };
-        result: {
-            projectRoot: string | null;
-            entries: LibraryEntryRow[];
-        };
-    };
-    'library.get': {
-        params: {
-            kind: LibraryKind;
-            name: EntryName;
-            projectRoot?: string;
-            scope?: LibraryScope;
-        };
-        /** `content` carries `{ $secret: 'keep' }` in place of each secret value; `secrets` lists their JSON Pointers. */
-        result: {
-            kind: LibraryKind;
-            name: string;
-            source: LibrarySource;
-            overrides?: LibrarySource;
-            content: Record<string, unknown>;
-            revision: string | null;
-            usedBy: string[];
-            librarySkills?: string[];
-            secrets?: string[];
-        };
-    };
-    'library.save': {
-        params: {
-            kind: LibraryKind;
-            name: EntryName;
-            scope: LibraryScope;
-            projectRoot?: string;
-            content: Record<string, unknown>;
-            revision?: string | null;
-            sync?: 'none' | 'known-projects';
-        };
-        result: {
-            revision: string | null;
-            syncedProjects?: number;
-            syncErrors?: string[];
-        };
-    };
-    'library.delete': {
-        params: {
-            kind: LibraryKind;
-            name: EntryName;
-            scope: LibraryScope;
-            projectRoot?: string;
-            revision?: string;
-        };
-        result: {
-            removed: true;
-            now?: 'builtin' | 'library';
-        };
-    };
-    'library.duplicate': {
-        params: {
-            kind: LibraryKind;
-            from: EntryName;
-            to: EntryName;
-            scope: LibraryScope;
-            projectRoot?: string;
-        };
-        result: {
-            revision: string | null;
-        };
-    };
-    'library.rename': {
-        params: {
-            kind: LibraryKind;
-            from: EntryName;
-            to: EntryName;
-            scope: LibraryScope;
-            projectRoot?: string;
-        };
-        result: {
-            revision: string | null;
-        };
-    };
-    'library.skills.set': {
-        params: {
-            agent: EntryName;
-            skills: EntryName[];
-        };
-        result: {
-            skills: string[];
-        };
-    };
-    'library.models': {
-        params: Empty;
-        result: {
-            models: Array<{
-                id: string;
-                label: string;
-                efforts: string[];
-                effort?: string;
-            }>;
-        };
-    };
-    'settings.language.get': {
-        params: Empty;
-        result: LanguageSetting;
-    };
-    'settings.language.set': {
-        params: {
-            language: string | null;
-        };
-        result: LanguageSetting;
-    };
-};
-export type RpcMethod = keyof RpcMethodMap;
-export type RpcParams<M extends RpcMethod> = RpcMethodMap[M]['params'];
-export type RpcResult<M extends RpcMethod> = RpcMethodMap[M]['result'];
-export {};

package/dist/wire.d.ts

@@ -13,29 +13,7 @@ export class AlpRpcError extends Error {
 export const ERROR: Readonly<{
     failed: 1000;
     notFound: 1001;
-    forbidden: 1003;
     conflict: 1004;
-    unavailable: 1005;
     protocol: 1006;
 }>;
-/** The JSON-RPC 2.0 codes alpd answers with (docs/protocol/alp-json-rpc-v1.md §5). */
-export const RPC_ERROR: Readonly<{
-    parseError: -32700;
-    invalidRequest: -32600;
-    methodNotFound: -32601;
-    invalidParams: -32602;
-}>;
-/**
- * Features a daemon lists in its daemon.hello result. A client uses a feature only when listed;
- * a daemon that lists none (one older than this list) has none of them. Unknown names are ignored.
- */
-export const CAPABILITY: Readonly<{
-    attachAfter: "attach.after";
-    promptReceipts: "prompt.receipts";
-    extensionMethods: "extension.methods";
-    team: "team";
-    task: "task";
-    library: "library";
-    settingsLanguage: "settings.language";
-}>;
 export const RPC_METHODS: readonly string[];

package/dist/wire.js

@@ -8,10 +8,8 @@ var AlpRpcError = class extends Error {
     this.data = error?.data;
   }
 };
-var ERROR = Object.freeze({ failed: 1e3, notFound: 1001, forbidden: 1003, conflict: 1004, unavailable: 1005, protocol: 1006 });
-var RPC_ERROR = Object.freeze({ parseError: -32700, invalidRequest: -32600, methodNotFound: -32601, invalidParams: -32602 });
-var CAPABILITY = Object.freeze({ attachAfter: "attach.after", promptReceipts: "prompt.receipts", extensionMethods: "extension.methods", team: "team", task: "task", library: "library", settingsLanguage: "settings.language" });
-var RPC_METHODS = Object.freeze(["assignment.recall", "board.list", "catalog.get", "daemon.hello", "daemon.pause", "daemon.pauses", "daemon.resume", "daemon.shutdown", "daemon.status", "daemon.usage", "extension.register", "extension.unregister", "library.delete", "library.duplicate", "library.get", "library.list", "library.models", "library.rename", "library.save", "library.skills.set", "question.answer", "question.list", "session.archive", "session.attach", "session.close", "session.configure", "session.create", "session.get", "session.interrupt", "session.list", "session.log", "session.message", "session.preview", "session.prompt", "session.release", "session.rename", "session.status", "settings.language.get", "settings.language.set", "task.create", "task.gate.resolve", "task.list", "task.update", "team.list"]);
+var ERROR = Object.freeze({ failed: 1e3, notFound: 1001, conflict: 1004, protocol: 1006 });
+var RPC_METHODS = Object.freeze(["assignment.recall", "board.list", "catalog.get", "daemon.hello", "daemon.pause", "daemon.pauses", "daemon.resume", "daemon.shutdown", "daemon.status", "daemon.usage", "extension.register", "extension.unregister", "question.answer", "question.list", "session.archive", "session.attach", "session.close", "session.configure", "session.create", "session.get", "session.interrupt", "session.list", "session.log", "session.message", "session.preview", "session.prompt", "session.release", "session.rename", "session.status"]);
 function encodeFrame(value) {
   return `${JSON.stringify(value)}
 `;
@@ -21,11 +19,9 @@ function decodeFrame(line) {
 }
 export {
   AlpRpcError,
-  CAPABILITY,
   ERROR,
   MAX_FRAME,
   PROTOCOL_VERSION,
-  RPC_ERROR,
   RPC_METHODS,
   decodeFrame,
   encodeFrame