@aibolabs/plugin-protocol 0.1.8

package/dist/presentation-git.d.ts

@@ -0,0 +1,148 @@
+interface WorkspaceFileChange {
+    stagedStats?: {
+        additions: number;
+        deletions: number;
+    } | null;
+    unstagedStats?: {
+        additions: number;
+        deletions: number;
+    } | null;
+    path: string;
+    previousPath: string | null;
+    kind: 'added' | 'modified' | 'deleted' | 'renamed';
+    staged: boolean;
+    unstaged: boolean;
+    untracked: boolean;
+    conflicted: boolean;
+}
+interface WorkspaceChanges {
+    workspaceId: string;
+    head: string | null;
+    branch: string | null;
+    dirty: boolean;
+    capturedAt: string;
+    files: WorkspaceFileChange[];
+    captureStatus: 'captured' | 'unsupported' | 'failed';
+    captureError: string | null;
+}
+interface WorkspaceFileDiff {
+    path: string;
+    staged: boolean;
+    available: boolean;
+    truncated: boolean;
+    diff: string;
+    hunks: TurnDiffHunk[];
+    reason: string | null;
+}
+interface TurnDiffHunk {
+    index: number;
+    header: string;
+    content: string;
+}
+interface GitBranch {
+    name: string;
+    current: boolean;
+    commit: string | null;
+}
+interface GitCommit {
+    hash: string;
+    shortHash: string;
+    subject: string;
+    author: string;
+    authoredAt: string;
+}
+interface GitCommitFile {
+    path: string;
+    previousPath: string | null;
+    kind: 'added' | 'modified' | 'deleted' | 'renamed';
+}
+interface GitCommitFileList {
+    commit: string;
+    files: GitCommitFile[];
+    total: number;
+}
+interface GitRemoteStatus {
+    branch: string | null;
+    upstream: string | null;
+    ahead: number;
+    behind: number;
+}
+interface GitStashEntry {
+    reference: string;
+    message: string;
+}
+export type PresentationGitDrafts = {
+    commitMessage: string;
+    branchDraft: string;
+    gitSection: 'changes' | 'history';
+    selectedCommit: string | null;
+};
+export type GitRepository = {
+    id: string;
+    name: string;
+    relativePath: string;
+    kind: 'repository' | 'submodule' | 'worktree';
+    externalRoot: boolean;
+};
+export type GitRepositoryState = GitRepository & {
+    changes: WorkspaceChanges | null;
+    error: string | null;
+};
+export type GitRepositoryDiscovery = {
+    repositories: GitRepository[];
+    limited: boolean;
+    warnings: string[];
+    scanBudget: number;
+};
+export type PresentationGit = {
+    repositories?: GitRepositoryState[];
+    repositoryId?: string | null;
+    repositorySearch?: string;
+    repositoryPickerOpen?: boolean;
+    collapsedRepositories?: string[];
+    discoveryLimited?: boolean;
+    discoveryWarnings?: string[];
+    workspace: {
+        id: string;
+        label: string;
+        path: string;
+        trust: string;
+    } | null;
+    sessionId: string | null;
+    desktop: boolean;
+    open: boolean;
+    activeView: 'context' | 'git';
+    changes: WorkspaceChanges | null;
+    loading: boolean;
+    error: string | null;
+    branches: GitBranch[];
+    history: GitCommit[];
+    historyHasMore?: boolean;
+    historyLoadingMore?: boolean;
+    historyLoadMoreError?: string | null;
+    metadataLoading: boolean;
+    metadataError: string | null;
+    commitFiles: GitCommitFileList | null;
+    commitFilesLoading: boolean;
+    remoteStatus: GitRemoteStatus | null;
+    stashes: GitStashEntry[];
+    operationBusy: boolean;
+    reviewBusy: boolean;
+    canRequestReview: boolean;
+    draft: PresentationGitDrafts;
+    preview: {
+        fileDiff: WorkspaceFileDiff | null;
+        loading: boolean;
+        error: string | null;
+        selectedPath: string | null;
+        staged: boolean;
+        contextLabel: string | null;
+    };
+};
+export type PresentationGitAction = {
+    token: string;
+    operation: 'togglePanel' | 'selectView' | 'selectSection' | 'refresh' | 'refreshMetadata' | 'commitMessage' | 'branchDraft' | 'commit' | 'createBranch' | 'checkoutBranch' | 'stageFile' | 'unstageFile' | 'stageAll' | 'unstageAll' | 'openDiff' | 'closeDiff' | 'selectCommit' | 'loadMoreHistory' | 'loadMoreCommitFiles' | 'openCommitDiff' | 'fetch' | 'pull' | 'push' | 'saveStash' | 'applyStash' | 'requestReview' | 'selectRepository' | 'repositorySearch' | 'toggleRepository' | 'continueDiscovery' | 'repositoryDiff' | 'repositoryStage' | 'repositoryUnstage' | 'repositoryStageAll' | 'repositoryUnstageAll';
+    event: 'click' | 'input';
+    args: readonly (string | null)[];
+};
+export {};

package/dist/presentation-git.js

@@ -0,0 +1 @@
+export {};

package/dist/presentation-inspector.d.ts

@@ -0,0 +1,218 @@
+import type { PresentationConversation } from './presentation-conversation.js';
+import type { PresentationGit } from './presentation-git.js';
+type ProjectActionKind = 'test' | 'lint' | 'build' | 'custom';
+interface CapabilityEntry {
+    name: string;
+    source: string;
+}
+interface WorkspaceCapabilityInventory {
+    workspaceId: string;
+    inspectedAt: string;
+    instructions: CapabilityEntry[];
+    skills: CapabilityEntry[];
+    tools: CapabilityEntry[];
+    mcpServers: CapabilityEntry[];
+    warnings: string[];
+}
+interface ChangeSetState {
+    head: string | null;
+    dirty: boolean | null;
+    capturedAt: string | null;
+}
+interface FileChange {
+    path: string;
+    previousPath: string | null;
+    kind: 'added' | 'modified' | 'deleted' | 'renamed';
+    baselineExists: boolean;
+    baselineHash: string | null;
+    baselineSize: number | null;
+    baselineDirty: boolean;
+    resultExists: boolean;
+    resultHash: string | null;
+    resultSize: number | null;
+}
+interface CommandRunRef {
+    id: string;
+    toolName: string | null;
+    command: string | null;
+    cwd: string | null;
+    exitCode: number | null;
+    status: 'streaming' | 'completed' | 'failed' | string;
+    output: string;
+}
+interface VerificationRef {
+    id: string;
+    status: 'running' | 'passed' | 'failed' | string;
+    output: string;
+}
+interface TurnChangeSet {
+    id: string;
+    schema: 'aibo.turn-changeset/v1';
+    workspaceId: string;
+    sessionId: string;
+    turnId: string;
+    baseline: ChangeSetState;
+    result: ChangeSetState;
+    files: FileChange[];
+    commands: CommandRunRef[];
+    verification: VerificationRef[];
+    attribution: 'agent' | 'mixed' | 'unknown';
+    captureStatus: 'captured' | 'partial' | 'failed';
+    captureError: string | null;
+}
+interface RestoreOperation {
+    schema: 'aibo.restore-operation/v1';
+    id: string;
+    workspaceId: string;
+    sessionId: string;
+    turnId: string;
+    status: 'completed' | 'blocked' | 'failed';
+    restored: string[];
+    conflicts: string[];
+    unsupported: string[];
+    createdAt: string;
+}
+interface CheckpointFile {
+    schema: 'aibo.checkpoint/v1';
+    id: string;
+    workspaceId: string;
+    sessionId: string;
+    turnId: string;
+    path: string;
+    fileExists: boolean;
+    contentHash: string | null;
+    size: number | null;
+    storagePath: string | null;
+    baselineDirty: boolean;
+    available: boolean;
+    reason: string | null;
+    createdAt: string;
+}
+interface Artifact {
+    schema: 'aibo.artifact/v1';
+    id: string;
+    workspaceId: string;
+    sessionId: string;
+    turnId: string | null;
+    source: string;
+    mediaType: string;
+    size: number;
+    contentHash: string;
+    storagePath: string;
+    createdAt: string;
+}
+interface ArtifactContent {
+    artifact: Artifact;
+    content: string;
+    truncated: boolean;
+}
+interface ProjectAction {
+    schema: 'aibo.project-action/v1';
+    id: string;
+    workspaceId: string;
+    name: string;
+    kind: ProjectActionKind;
+    program: string;
+    args: string[];
+    cwd: string;
+    enabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ProjectActionRun {
+    schema: 'aibo.project-action-run/v1' | 'aibo.project-action-run/v2' | 'aibo.project-action-run/v3';
+    id: string;
+    actionId: string;
+    actionName?: string | null;
+    workspaceId: string;
+    sessionId: string | null;
+    status: 'completed' | 'failed' | 'timed_out' | string;
+    exitCode: number | null;
+    output: string;
+    artifactId: string | null;
+    startedAt: string;
+    completedAt: string | null;
+}
+interface TurnDiffHunk {
+    index: number;
+    header: string;
+    content: string;
+}
+interface TurnFileDiff {
+    path: string;
+    available: boolean;
+    diff: string;
+    hunks: TurnDiffHunk[];
+    reason: string | null;
+}
+export type PresentationArtifactPreview = {
+    sessionId: string | null;
+    artifactId: string | null;
+    content: ArtifactContent | null;
+    loading: boolean;
+    error: string | null;
+};
+export type PresentationInspector = {
+    workspace: PresentationGit['workspace'];
+    session: PresentationConversation['session'];
+    desktop: boolean;
+    open: boolean;
+    activeView: 'context' | 'git';
+    diagnostics: {
+        agent: string;
+        label: string;
+        status: string;
+        executable: string | null;
+        version: string | null;
+        capabilities: string[];
+        authState: string;
+        message: string | null;
+    }[];
+    workspaceCapabilities: WorkspaceCapabilityInventory | null;
+    threads: {
+        id: string;
+        title: string | null;
+        cwd: string | null;
+        status: string | null;
+        updatedAt: string | null;
+    }[];
+    executionProfile: PresentationConversation['executionProfile'];
+    attachments: PresentationConversation['attachments'];
+    artifacts: Artifact[];
+    artifactPreview: PresentationArtifactPreview;
+    projectEditor: PresentationProjectEditor;
+    runningActionId: string | null;
+    projectActions: ProjectAction[];
+    projectActionRuns: ProjectActionRun[];
+    changeSet: TurnChangeSet | null;
+    checkpoints: CheckpointFile[];
+    restoreOperations: RestoreOperation[];
+    workspaceChanges: PresentationGit['changes'];
+    fileDiff: TurnFileDiff | null;
+    fileDiffLoading: boolean;
+    fileDiffError: string | null;
+    threadBusy: boolean;
+    busy: boolean;
+    running: boolean;
+    archiving: boolean;
+};
+export type PresentationInspectorAction = {
+    token: string;
+    operation: 'selectView' | 'refresh' | 'syncThreads' | 'toggleArtifact' | 'closeArtifact' | 'showDiff' | 'restoreTurn' | 'fileAction' | 'hunkAction' | 'newProjectAction' | 'editProjectAction' | 'projectField' | 'projectKind' | 'saveProjectAction' | 'closeProjectEditor' | 'deleteProjectAction' | 'runProjectAction' | 'cancelProjectAction';
+    event: 'click' | 'input';
+    args: readonly (string | null)[];
+};
+export type PresentationProjectEditor = {
+    generation: number;
+    open: boolean;
+    actionId: string | null;
+    name: string;
+    kind: 'test' | 'lint' | 'build' | 'custom';
+    program: string;
+    args: string;
+    cwd: string;
+    enabled: boolean;
+    saving: boolean;
+    error: string | null;
+};
+export {};

package/dist/presentation-inspector.js

@@ -0,0 +1 @@
+export {};

package/dist/presentation-layout.d.ts

@@ -0,0 +1,21 @@
+export type PresentationLayout = {
+    navigation: {
+        width: number;
+        min: number;
+        max: number;
+    };
+    auxiliary: {
+        width: number;
+        min: number;
+        max: number;
+    };
+    auxiliaryOpen: boolean;
+    mode?: 'standard' | 'focus' | 'review';
+    switching?: boolean;
+};
+export type PresentationLayoutAction = {
+    token: string;
+    operation: 'resize' | 'selectMode';
+    event: 'input' | 'click';
+    args: readonly ('navigation' | 'auxiliary' | 'standard' | 'focus' | 'review')[];
+};

package/dist/presentation-layout.js

@@ -0,0 +1 @@
+export {};

package/dist/presentation-navigation.d.ts

@@ -0,0 +1,51 @@
+/** Data owned by the host; visual implementations never receive navigation callbacks. */
+export type PresentationNavigation = {
+    agentChoices?: {
+        id: string;
+        label: string;
+        icon?: import('./agent-icon.js').AgentIcon;
+    }[];
+    workspaces: {
+        id: string;
+        label: string;
+        path: string;
+        trust: string;
+    }[];
+    sessionsByWorkspace: Record<string, {
+        id: string;
+        workspaceId: string;
+        agent: string;
+        canSyncSnapshot?: boolean;
+        label: string;
+        state: string;
+        archived: boolean;
+        updatedAt: string;
+    }[]>;
+    selectedWorkspaceId: string | null;
+    selectedSessionId: string | null;
+    expandedWorkspaceIds: string[];
+    sessionsLoadingWorkspaceIds: string[];
+    busy: boolean;
+    threadBusy: boolean;
+    archivingWorkspaceId: string | null;
+    archivingSessionId: string | null;
+    /** Deprecated: fixed host global search owns this interaction; hosts send false. */
+    sessionSearchOpen: boolean;
+    sessionFilterOpen: boolean;
+    /** Deprecated compatibility field; hosts send an empty string. */
+    sessionSearch: string;
+    sessionFilter: string;
+    createSessionWorkspaceId: string | null;
+    renamingSessionId: string | null;
+    sessionLabelDraft: string;
+};
+export type PresentationNavigationOperation = 'toggleSearch' | 'toggleFilter' | 'search' | 'filter' | 'applyFilters' | 'addWorkspace' | 'selectWorkspace' | 'toggleSessionCreator' | 'toggleTrust' | 'removeWorkspace' | 'openWorkspace' | 'createAgent' | 'selectSession' | 'unarchiveSession' | 'archiveSession' | 'syncSession' | 'renameSession' | 'renameDraft' | 'saveRename' | 'cancelRename';
+export type PresentationNavigationAction = {
+    token: string;
+    operation: PresentationNavigationOperation;
+    targetId?: string;
+    choiceId?: string;
+    event: 'click' | 'input' | 'change';
+    /** Allowed values for a change event; the host rejects other values. */
+    options?: readonly string[];
+};

package/dist/presentation-navigation.js

@@ -0,0 +1 @@
+export {};

package/dist/presentation-package.d.ts

@@ -0,0 +1,28 @@
+/** Installable skin and full-workbench extensions share this data-only package. */
+export type PresentationPackageManifest = {
+    schema: 'aibo.presentation-package/v1';
+    id: string;
+    version: string;
+    displayName: string;
+    /** Controls introduced in a later version are only sent to packages declaring it. */
+    hostApi: '1.0.0' | '1.1.0';
+    coreSemantics: '1.0.0';
+    snapshotSchemas: readonly ('aibo.semantic-view/experimental-v1' | 'aibo.semantic-view/v1' | 'aibo.semantic-view/v1.1')[];
+    resources: readonly PresentationResource[];
+    themes?: readonly PresentationTheme[];
+    defaultThemeId?: string;
+    entry?: string;
+    surfaces?: readonly ('controls' | 'semantic' | 'workbench')[];
+};
+export type PresentationResource = {
+    path: string;
+    sha256: string;
+    bytes: number;
+    mediaType: 'text/javascript' | 'text/css' | 'image/png' | 'image/webp' | 'font/woff2';
+};
+export type PresentationTheme = {
+    id: string;
+    label: string;
+    colorScheme: 'dark' | 'light';
+    tokens: Readonly<Record<string, string>>;
+};

package/dist/presentation-package.js

@@ -0,0 +1 @@
+export {};

package/dist/presentation-runtime.d.ts

@@ -0,0 +1,60 @@
+import type { JsonValue } from './semantic.js';
+/** Visual trees are presentation output, never capability or semantic contributions. */
+export type PresentationNode = {
+    tag: 'div' | 'section' | 'main' | 'aside' | 'header' | 'footer' | 'nav' | 'article' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'span' | 'strong' | 'em' | 'del' | 'blockquote' | 'pre' | 'code' | 'ul' | 'ol' | 'li' | 'button' | 'input' | 'textarea' | 'label' | 'select' | 'option' | 'table' | 'thead' | 'tbody' | 'tr' | 'th' | 'td' | 'details' | 'summary' | 'hr' | 'img' | 'svg' | 'path' | 'circle' | 'rect' | 'line' | 'polyline' | 'polygon' | 'g';
+    key: string;
+    text?: string;
+    className?: string;
+    /** Bounded size hint exposed to skin CSS as --presentation-inline-size. */
+    inlineSize?: number;
+    /** Button-only horizontal splitter bound to a host input token. */
+    resize?: {
+        token: string;
+        value: number;
+        min: number;
+        max: number;
+        direction: 1 | -1;
+    };
+    /** Package image path or attachment:<id> from the current conversation; arbitrary URLs are rejected. */
+    resource?: string;
+    attrs?: Readonly<Record<string, string | boolean>>;
+    /** User events become intents; only the host decides whether to execute them. */
+    events?: Partial<Record<'click' | 'input' | 'change' | 'keydown', string>>;
+    /** Presentation-owned interaction, delivered only to the package Worker. */
+    localEvents?: Partial<Record<'click' | 'input' | 'change' | 'keydown', string>>;
+    /** Textarea-only primary-modifier Enter shortcut, using an existing host click token. */
+    primaryEnter?: string;
+    /** Opt into Enter submission and Shift/Ctrl+Enter newline; legacy shortcut behavior is the default. */
+    submitOnEnter?: boolean;
+    /** Textarea suggestion list; keys reference existing host-action buttons in listKey. */
+    suggestions?: {
+        listKey: string;
+        keys: readonly string[];
+        confirmWithTab?: boolean;
+        confirmWithPrimary?: boolean;
+        categories?: readonly {
+            key: string;
+            options: readonly string[];
+        }[];
+    };
+    children?: readonly PresentationNode[];
+};
+export type PresentationContext = {
+    workspaceId: string | null;
+    sessionId: string | null;
+    revision: number;
+};
+export type PresentationInput = {
+    surface: 'controls' | 'semantic' | 'workbench';
+    context: PresentationContext;
+    data: JsonValue;
+    theme: Readonly<Record<string, string>>;
+};
+export type PresentationIntent = {
+    id: string;
+    event?: 'click' | 'input' | 'change' | 'keydown';
+    editSequence?: number;
+    context: PresentationContext;
+    value?: string;
+    key?: string;
+};

package/dist/presentation-runtime.js

@@ -0,0 +1 @@
+export {};

package/dist/presentation.d.ts

@@ -0,0 +1,17 @@
+import type { Snapshot, ActionMessage } from './semantic.js';
+/** Experimental JSON messages; mounting and DOM handles belong to local adapters. */
+export type PresentationSnapshot<View = Snapshot> = {
+    schema: 'aibo.presentation/experimental-v1';
+    generation: number;
+    view: View;
+    recovery: {
+        selection: string | null;
+        detail: string | null;
+        focus: string | null;
+    };
+};
+export type PresentationAction<Action = ActionMessage> = {
+    schema: 'aibo.presentation-action/experimental-v1';
+    generation: number;
+    action: Action;
+};

package/dist/presentation.js

@@ -0,0 +1 @@
+export {};

package/dist/renderer.d.ts

@@ -0,0 +1,34 @@
+import type { Snapshot } from './semantic.js';
+/** Public data only. Executable renderer implementations stay in the trusted build. */
+export declare const CORE_SEMANTICS: readonly ["collection", "detail", "settings", "inspector"];
+export type CoreSemantic = typeof CORE_SEMANTICS[number];
+export declare const LEGACY_SNAPSHOT_SCHEMAS: readonly Snapshot['schema'][];
+export declare const SUPPORTED_SNAPSHOT_SCHEMAS: readonly Snapshot['schema'][];
+export type RendererDescriptor = {
+    id: string;
+    version: string;
+    /** Version of the required semantic vocabulary, distinct from snapshot wire versions. */
+    semanticVersion: '1.0.0';
+    /** Omission retains only the original read-only snapshot readers. */
+    snapshotSchemas?: readonly Snapshot['schema'][];
+    core: readonly CoreSemantic[];
+    optional: readonly {
+        id: string;
+        version: string;
+        semantic: CoreSemantic;
+    }[];
+};
+export type PresentationPreference = {
+    id: string;
+    version: string;
+};
+export type PresentationChoice = {
+    kind: 'specialized';
+    id: string;
+    snapshot: Snapshot;
+} | {
+    kind: 'core';
+    semantic: CoreSemantic;
+    snapshot: Snapshot;
+    reason: string | null;
+};

package/dist/renderer.js

@@ -0,0 +1,4 @@
+/** Public data only. Executable renderer implementations stay in the trusted build. */
+export const CORE_SEMANTICS = ['collection', 'detail', 'settings', 'inspector'];
+export const LEGACY_SNAPSHOT_SCHEMAS = ['aibo.semantic-view/experimental-v1', 'aibo.semantic-view/v1'];
+export const SUPPORTED_SNAPSHOT_SCHEMAS = [...LEGACY_SNAPSHOT_SCHEMAS, 'aibo.semantic-view/v1.1'];