@aibolabs/plugin-protocol 0.1.8

package/dist/semantic.d.ts

@@ -0,0 +1,85 @@
+/** Versioned wire contract. JSON only; local renderer interfaces live elsewhere. */
+export declare const SEMANTIC_SCHEMA = "aibo.semantic-view/v1";
+export type Context = {
+    workspaceId: string | null;
+    sessionId?: string;
+    contributionId: string;
+    generation: string;
+    revision: number;
+};
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type ReadAction = {
+    id: 'refresh' | 'inspect' | 'open-diff' | 'back' | 'next' | 'previous';
+    label: string;
+    intent: 'refresh' | 'inspect' | 'navigate';
+    enabled: boolean;
+};
+export type Action = ReadAction | {
+    id: string;
+    label: string;
+    intent: 'execute';
+    enabled: boolean;
+    input: {
+        [key: string]: JsonValue;
+    };
+};
+export type ActionMessage = {
+    context: Context;
+    actionId: Action['id'];
+    itemId: string | null;
+};
+/** Input sent by the host to a semantic contribution's read provider. */
+export type SemanticQuery = {
+    actionId: ReadAction['id'];
+    itemId: string | null;
+    offset: number;
+};
+export type Property = {
+    key: string;
+    label: string;
+    type: 'text' | 'enum';
+    values: string[];
+};
+export type Item = {
+    id: string;
+    values: Record<string, string>;
+};
+export type Collection = {
+    kind: 'collection';
+    properties: Property[];
+    items: Item[];
+    selection: string | null;
+    page: {
+        offset: number;
+        size: number;
+        total: number;
+        truncated: boolean;
+    };
+};
+export type Detail = {
+    kind: 'detail' | 'inspector' | 'settings';
+    itemId: string;
+    properties: {
+        label: string;
+        value: string;
+    }[];
+    content: string;
+    truncated: boolean;
+};
+export type Snapshot = {
+    schema: typeof SEMANTIC_SCHEMA | 'aibo.semantic-view/v1.1' | 'aibo.semantic-view/experimental-v1';
+    context: Context;
+    contribution: {
+        id: string;
+        extensionPoint: 'workspace.tool' | 'session.context' | 'session.action' | 'settings.page' | 'command';
+        title: string;
+    };
+    state: {
+        status: 'ready' | 'loading' | 'empty' | 'error' | 'unavailable';
+        message: string;
+    };
+    view: Collection | Detail;
+    actions: Action[];
+};

package/dist/semantic.js

@@ -0,0 +1,2 @@
+/** Versioned wire contract. JSON only; local renderer interfaces live elsewhere. */
+export const SEMANTIC_SCHEMA = 'aibo.semantic-view/v1';

package/dist/session.d.ts

@@ -0,0 +1,65 @@
+import type { JsonValue } from './semantic.js';
+/** Session identity comes from CapabilityInvocation.scope, never plugin input. */
+export declare const SESSION_CAPABILITY_VERSION = "1.0.0";
+export type SessionOpenInput = {
+    mode: 'create' | 'resume';
+    executionProfile: {
+        schema?: string;
+        interactionMode?: 'ask' | 'plan' | 'edit';
+        approvalPolicy?: string;
+        approvalReviewer?: string;
+        filesystemPolicy?: string;
+        commandPolicy?: string;
+        networkPolicy?: string;
+        model?: string | null;
+        reasoningEffort?: string | null;
+    };
+    recovery?: Record<string, JsonValue> | null;
+};
+export type SessionOpenOutput = {
+    nativeSessionId: string;
+    recovery: Record<string, JsonValue>;
+    capabilities: string[];
+};
+export type SessionTurnInput = {
+    text: string;
+    attachments?: Record<string, JsonValue>[];
+};
+export type SessionTurnOutput = {
+    status: 'completed' | 'interrupted' | 'failed';
+    recovery: Record<string, JsonValue> | null;
+};
+export type SessionToolResponse = {
+    requestId: string;
+    result: JsonValue;
+    error?: never;
+} | {
+    requestId: string;
+    error: string;
+    result?: never;
+};
+export type SessionDomainEvent = {
+    nativeSessionId: string;
+    turnId: string | null;
+    type: string;
+    correlation: Record<string, JsonValue> | null;
+    payload: Record<string, JsonValue>;
+};
+/** Declarative controls offered by a session contribution, never an authority grant. */
+export interface SessionControl {
+    id: string;
+    kind: 'permission' | 'mode';
+    label: string;
+    description: string;
+    command?: string;
+    /** Controls an approval inside a turn may switch to; the host commits the switch. */
+    transitions?: string[];
+    profile: {
+        interactionMode?: 'ask' | 'plan' | 'edit';
+        approvalPolicy?: 'never' | 'untrusted' | 'on-request' | 'trusted';
+        approvalReviewer?: 'user' | 'auto-review' | 'none';
+        filesystemPolicy?: 'read-only' | 'workspace-write' | 'danger-full-access' | 'agent-managed';
+        commandPolicy?: 'disabled' | 'approved' | 'trusted' | 'agent-managed';
+        networkPolicy?: 'disabled' | 'agent-managed';
+    };
+}

package/dist/session.js

@@ -0,0 +1,2 @@
+/** Session identity comes from CapabilityInvocation.scope, never plugin input. */
+export const SESSION_CAPABILITY_VERSION = '1.0.0';

package/dist/settings.d.ts

@@ -0,0 +1,50 @@
+import type { CapabilityScope } from './capability.js';
+/** Ordinary configuration only. Credentials must not be stored in this protocol. */
+export type AgentSettingValue = string | number | boolean;
+export type AgentSettingField = {
+    key: string;
+    label: string;
+    description?: string;
+    type: 'text' | 'multiline' | 'boolean' | 'number' | 'select';
+    default: AgentSettingValue;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    min?: number;
+    max?: number;
+    maxLength?: number;
+};
+export type AgentSettingsDescriptor = {
+    schema: 'aibo.agent-settings/v1';
+    version: number;
+    title: string;
+    description?: string;
+    scopes: CapabilityScope['kind'][];
+    fields: AgentSettingField[];
+};
+export type AgentSettingsTarget = {
+    installationId: string;
+    contributionId: string;
+    scope: CapabilityScope;
+};
+export type AgentSettingsSnapshot = {
+    target: AgentSettingsTarget;
+    descriptor: AgentSettingsDescriptor;
+    revision: number;
+    values: Record<string, AgentSettingValue>;
+    effectiveValues: Record<string, AgentSettingValue>;
+    inheritedValues: Record<string, AgentSettingValue>;
+};
+/** Replace overrides at this scope. Omitted fields inherit; {} resets the scope. */
+export type AgentSettingsSave = AgentSettingsTarget & {
+    version: number;
+    expectedRevision: number;
+    values: Record<string, AgentSettingValue>;
+};
+/** Host-resolved immutable snapshot for this invocation, never caller-supplied input. */
+export type AgentSettingsContext = {
+    schema: 'aibo.agent-settings/v1';
+    version: number;
+    values: Record<string, AgentSettingValue>;
+};

package/dist/settings.js

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@aibolabs/plugin-protocol",
+  "version": "0.1.8",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chldu2000/aibo.git",
+    "directory": "packages/plugin-protocol"
+  },
+  "type": "module",
+  "description": "Aibo JSON semantic and presentation contracts, independent of UI frameworks",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./semantic": {
+      "types": "./dist/semantic.d.ts",
+      "import": "./dist/semantic.js"
+    },
+    "./presentation": {
+      "types": "./dist/presentation.d.ts",
+      "import": "./dist/presentation.js"
+    },
+    "./renderer": {
+      "types": "./dist/renderer.d.ts",
+      "import": "./dist/renderer.js"
+    },
+    "./settings": {
+      "types": "./dist/settings.d.ts",
+      "import": "./dist/settings.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}