@zclaudia/plugin-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ZClaudia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER 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.

package/README.md

@@ -0,0 +1,64 @@
+# @zclaudia/plugin-sdk
+
+Public contracts and lightweight development helpers for building ZClaudia plugins.
+
+The SDK defines the host/plugin boundary: manifests, lifecycle APIs, permissions, and external
+agent runtime adapters. It intentionally has no dependency on the ZClaudia application monorepo
+or on a provider/model SDK.
+
+## Install
+
+```bash
+pnpm add -D @zclaudia/plugin-sdk
+```
+
+Use it as a development dependency when all imports are type-only. Keep it as a runtime dependency
+if your compiled plugin calls helpers such as `definePlugin` or `validatePluginManifest`.
+
+## Runtime plugin example
+
+```ts
+import { definePlugin } from '@zclaudia/plugin-sdk/runtime';
+import type {
+  ExternalAgentAdapter,
+  ExternalAgentRunContext,
+  ProviderRuntimeEvent,
+} from '@zclaudia/plugin-sdk/providers';
+
+class ExampleAdapter implements ExternalAgentAdapter {
+  readonly type = 'example';
+
+  async *run(
+    input: string,
+    context: ExternalAgentRunContext
+  ): AsyncGenerator<ProviderRuntimeEvent, void, void> {
+    yield { type: 'init', sessionId: context.sessionId };
+    yield { type: 'assistant_delta', content: input };
+    yield { type: 'provider_turn_finished', isComplete: true };
+  }
+}
+
+export default definePlugin({
+  activate(context) {
+    context.agentRuntimes?.register(new ExampleAdapter());
+  },
+  deactivate() {},
+});
+```
+
+The corresponding `plugin.json` must declare the same runtime type under
+`contributes.agentRuntimes` and request `provider.register`.
+
+## Package boundaries
+
+- `@zclaudia/protocol` owns JSON-serializable transport contracts.
+- `@zclaudia/plugin-sdk` owns plugin lifecycle and host capability contracts.
+- Provider-specific packages own their CLI/SDK integrations.
+
+The SDK may reuse protocol DTOs in the future, but the protocol package must never depend on the
+plugin SDK.
+
+## Compatibility
+
+The package follows semantic versioning. Additive fields are minor changes. Removing or changing a
+public field, callback, manifest contribution, or adapter method is a major change.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './interactions.js';
+export * from './manifest.js';
+export * from './providers.js';
+export * from './runtime.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './interactions.js';
+export * from './manifest.js';
+export * from './providers.js';
+export * from './runtime.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/interactions.d.ts

@@ -0,0 +1,16 @@
+export interface PermissionRequest {
+    requestId: string;
+    toolName: string;
+    toolInput: unknown;
+    detail: string;
+    timeoutSeconds: number;
+    /** Behavior when the request expires. The host defaults to deny. */
+    timeoutBehavior?: 'approve' | 'deny';
+}
+export interface PermissionDecision {
+    behavior: 'allow' | 'deny';
+    updatedInput?: unknown;
+    message?: string;
+}
+export type PermissionCallback = (request: PermissionRequest) => Promise<PermissionDecision>;
+//# sourceMappingURL=interactions.d.ts.map

package/dist/interactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../src/interactions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,eAAe,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/interactions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interactions.js.map

package/dist/interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../src/interactions.ts"],"names":[],"mappings":""}

package/dist/manifest.d.ts

@@ -0,0 +1,165 @@
+import type { AgentRuntimeContribution } from './providers.js';
+import type { SkillExecutionSelection, SkillSelection, ThinkingLevel, ToolSelection } from './types.js';
+export type Permission = 'session.read' | 'project.read' | 'storage' | 'fs.read' | 'network.fetch' | 'timer' | 'provider.call' | 'fs.write' | 'session.write' | 'notification' | 'clipboard.read' | 'clipboard.write' | 'shell.execute' | 'provider.register';
+export interface CommandContribution {
+    command: string;
+    title: string;
+    category?: string;
+    icon?: string;
+}
+export interface ToolContribution {
+    id: string;
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    scope?: Array<'agent-assistant' | 'main-session' | 'command-palette'>;
+    permissions?: Permission[];
+}
+export interface SettingsContribution {
+    id: string;
+    label: string;
+    icon?: string;
+    schema?: Record<string, unknown>;
+    defaults?: Record<string, unknown>;
+}
+export interface PanelContribution {
+    id: string;
+    label: string;
+    location: 'bottom' | 'sidebar' | 'right';
+    icon?: string;
+    size?: number;
+    frontend?: string;
+    order?: number;
+}
+export interface HookContribution {
+    event: string;
+    handler: string;
+    priority?: number;
+}
+export interface MenuContribution {
+    id: string;
+    location: 'context-menu' | 'toolbar' | 'status-bar';
+    label: string;
+    command?: string;
+    icon?: string;
+    when?: string;
+}
+export interface KeybindingContribution {
+    command: string;
+    key: string;
+    when?: string;
+}
+export interface UIExtensionPoint {
+    id: string;
+    location: 'sidebar' | 'panel' | 'toolbar' | 'context-menu' | 'status-bar';
+    component?: string;
+    when?: string;
+}
+export interface WorkflowStepContribution {
+    id: string;
+    name: string;
+    description: string;
+    category?: string;
+    icon?: string;
+    configSchema?: Record<string, unknown>;
+}
+export interface TriggerSourceContribution {
+    id: string;
+    name: string;
+    description: string;
+    eventPattern: string;
+    category?: string;
+    icon?: string;
+}
+export interface NotchTabContribution {
+    id: string;
+    label: string;
+    icon?: string;
+    order?: number;
+}
+export interface SkillContribution {
+    path: string;
+}
+export interface AgentProfileContribution {
+    id: string;
+    name: string;
+    description?: string;
+    systemPrompt?: string;
+    model?: string;
+    toolSelection?: ToolSelection;
+    skillSelection?: SkillSelection;
+    skillExecution?: SkillExecutionSelection;
+    thinkingLevel?: ThinkingLevel;
+    llmProfileStrategy?: 'default' | 'first-available';
+    runtimeType?: string;
+}
+export interface PluginContributes {
+    commands?: CommandContribution[];
+    tools?: ToolContribution[];
+    settings?: SettingsContribution;
+    panels?: PanelContribution[];
+    hooks?: HookContribution[];
+    uiExtensions?: UIExtensionPoint[];
+    menus?: MenuContribution[];
+    keybindings?: KeybindingContribution[];
+    workflowSteps?: WorkflowStepContribution[];
+    triggerSources?: TriggerSourceContribution[];
+    skills?: SkillContribution[];
+    agentProfiles?: AgentProfileContribution[];
+    notchTabs?: NotchTabContribution[];
+    agentRuntimes?: AgentRuntimeContribution[];
+}
+export interface McpRequirement {
+    server: string;
+    tools?: string[];
+    required?: boolean;
+}
+export interface PluginRequirements {
+    mcp?: McpRequirement[];
+    plugins?: Array<{
+        id: string;
+        required?: boolean;
+    }>;
+    providers?: {
+        required?: boolean;
+    };
+}
+export interface PluginAuthor {
+    name: string;
+    email?: string;
+    url?: string;
+}
+export interface PluginEngines {
+    claudia: string;
+}
+export type ExecutionMode = 'main' | 'worker' | 'sandbox';
+export type PluginPlatform = 'universal' | 'desktop';
+export interface PluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    author?: PluginAuthor;
+    icon?: string;
+    main?: string;
+    frontend?: string;
+    permissions?: Permission[];
+    contributes?: PluginContributes;
+    platform?: PluginPlatform;
+    executionMode?: ExecutionMode;
+    activationEvents?: string[];
+    engines?: PluginEngines;
+    dependencies?: Record<string, string>;
+    requires?: PluginRequirements;
+}
+export interface PluginValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/** Validate the portable parts of a plugin manifest before host installation. */
+export declare function validatePluginManifest(manifest: unknown): PluginValidationResult;
+export declare function resolvePluginPlatform(manifest: PluginManifest): PluginPlatform;
+/** Identity helper that preserves literal types while checking the manifest contract. */
+export declare function definePluginManifest<const T extends PluginManifest>(manifest: T): T;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}

package/dist/manifest.js

@@ -0,0 +1,96 @@
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function requireString(value, field, label, errors) {
+    if (typeof value[field] !== 'string' || value[field].length === 0) {
+        errors.push(`${label} missing "${field}" field`);
+    }
+}
+/** Validate the portable parts of a plugin manifest before host installation. */
+export function validatePluginManifest(manifest) {
+    const errors = [];
+    const warnings = [];
+    if (!isRecord(manifest)) {
+        return { valid: false, errors: ['Manifest must be an object'], warnings };
+    }
+    if (typeof manifest.id !== 'string' || !manifest.id) {
+        errors.push('Missing required field: id');
+    }
+    else if (!/^[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)*$/.test(manifest.id)) {
+        errors.push('Invalid id format (use reverse domain notation, e.g., com.example.plugin)');
+    }
+    if (typeof manifest.name !== 'string' || !manifest.name) {
+        errors.push('Missing required field: name');
+    }
+    if (typeof manifest.version !== 'string' || !manifest.version) {
+        errors.push('Missing required field: version');
+    }
+    else if (!/^\d+\.\d+\.\d+(-[\w.]+)?$/.test(manifest.version)) {
+        warnings.push('Version should follow semver format (e.g., 1.0.0)');
+    }
+    if (typeof manifest.description !== 'string' || !manifest.description) {
+        errors.push('Missing required field: description');
+    }
+    if (manifest.platform !== undefined &&
+        !['universal', 'desktop'].includes(String(manifest.platform))) {
+        errors.push('Invalid platform (expected "universal" or "desktop")');
+    }
+    if (manifest.executionMode !== undefined &&
+        !['main', 'worker', 'sandbox'].includes(String(manifest.executionMode))) {
+        errors.push('Invalid executionMode (expected "main", "worker", or "sandbox")');
+    }
+    if (manifest.engines !== undefined) {
+        if (!isRecord(manifest.engines) || typeof manifest.engines.claudia !== 'string') {
+            warnings.push('engines.claudia should specify a semver range');
+        }
+    }
+    if (manifest.contributes !== undefined && !isRecord(manifest.contributes)) {
+        errors.push('contributes must be an object');
+    }
+    else if (isRecord(manifest.contributes)) {
+        const contributionChecks = [
+            ['commands', 'Command contribution', ['command', 'title']],
+            ['tools', 'Tool contribution', ['id', 'name', 'description']],
+            ['notchTabs', 'NotchTab contribution', ['id', 'label']],
+            ['workflowSteps', 'WorkflowStep contribution', ['id', 'name', 'description']],
+            ['agentProfiles', 'AgentProfile contribution', ['id', 'name']],
+            ['agentRuntimes', 'AgentRuntime contribution', ['type', 'label']],
+        ];
+        for (const [key, label, fields] of contributionChecks) {
+            const entries = manifest.contributes[key];
+            if (entries === undefined)
+                continue;
+            if (!Array.isArray(entries)) {
+                errors.push(`contributes.${key} must be an array`);
+                continue;
+            }
+            for (const entry of entries) {
+                if (!isRecord(entry)) {
+                    errors.push(`${label} must be an object`);
+                    continue;
+                }
+                for (const field of fields)
+                    requireString(entry, field, label, errors);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+export function resolvePluginPlatform(manifest) {
+    if (manifest.platform)
+        return manifest.platform;
+    if (manifest.frontend)
+        return 'desktop';
+    const c = manifest.contributes;
+    const hasUI = !!c?.panels?.length ||
+        !!c?.uiExtensions?.length ||
+        !!c?.menus?.length ||
+        !!c?.keybindings?.length ||
+        !!c?.notchTabs?.length;
+    return hasUI ? 'desktop' : 'universal';
+}
+/** Identity helper that preserves literal types while checking the manifest contract. */
+export function definePluginManifest(manifest) {
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}

package/dist/providers.d.ts

@@ -0,0 +1,164 @@
+import type { PermissionCallback } from './interactions.js';
+import type { ContextWindowSource, ProviderUsage, RuntimeCapabilityMode, ThinkingLevel, ThinkingLevelMode, ModelConfigKind, ToolEffect, ToolSemantic } from './types.js';
+export type { PermissionCallback, PermissionDecision, PermissionRequest } from './interactions.js';
+export type PCPCapabilityId = 'chat.generate' | 'chat.stream' | 'tool.call' | 'tool.inject' | 'interaction.form' | 'interaction.approval' | 'interaction.todo' | 'input.image' | 'input.text_file' | 'input.binary_file' | 'permission.mode' | 'session.abort' | 'session.steer' | 'session.background_task';
+export type CapabilityMode = 'native' | 'bridged' | 'emulated';
+export type ReliabilityTier = 'strict' | 'best_effort' | 'display_only';
+export type DegradationPolicy = 'reject' | 'fallback_to_text' | 'fallback_to_notice' | 'server_emulation';
+export type PCPPermissionMode = 'supervised' | 'auto_edit' | 'autonomous' | 'plan_only';
+export type ProviderRuntimeKind = 'cli' | 'sdk' | 'http' | 'bridge';
+export interface PCPCapabilityDescriptor {
+    id: PCPCapabilityId;
+    supported: boolean;
+    mode?: CapabilityMode;
+    reliability?: ReliabilityTier;
+    degradation?: DegradationPolicy;
+    limits?: Record<string, string | number | boolean>;
+    notes?: string;
+}
+export interface PCPProviderManifest {
+    id: string;
+    name: string;
+    version: string;
+    apiVersion: 'pcp/v1';
+    providerType: string;
+    runtime: ProviderRuntimeKind;
+    capabilities: PCPCapabilityDescriptor[];
+    permissionModeMap?: Partial<Record<PCPPermissionMode, string>>;
+}
+export interface ProviderAuthErrorHint {
+    matchAny: Array<string | string[]>;
+    message: string;
+}
+export interface ProviderPolicy {
+    nativeInteractionTools?: string[];
+    emptyResultFallback?: string;
+    sessionCwdPolicy?: 'pinned' | 'requested';
+    modeSwitchSessionPolicy?: 'reset' | 'preserve';
+    authErrorHint?: ProviderAuthErrorHint;
+    escalateAlwaysTools?: string[];
+}
+/** Static, JSON-serializable runtime metadata declared in plugin.json. */
+export interface AgentRuntimeDescriptor {
+    type: string;
+    label: string;
+    model: {
+        kind: ModelConfigKind;
+        multimodalFallback: boolean;
+        thinkingLevel: ThinkingLevelMode;
+    };
+    hasCliPath: boolean;
+    capabilities: {
+        tools: RuntimeCapabilityMode;
+        providers: RuntimeCapabilityMode;
+        skills: RuntimeCapabilityMode;
+    };
+    authNote?: string;
+    manifest: PCPProviderManifest;
+    policy?: ProviderPolicy;
+}
+export type AgentRuntimeContribution = AgentRuntimeDescriptor;
+export interface ModeTransition {
+    mode: string;
+    reason: 'enter' | 'exit';
+    plan?: string;
+    sourceToolUseId?: string;
+}
+export type ToolInteractionKind = 'todo_update';
+export interface SystemInfo {
+    model?: string;
+    contextWindow?: number;
+    contextWindowSource?: ContextWindowSource;
+    contextWindowMatchedProvider?: string;
+    claudeCodeVersion?: string;
+    cwd?: string;
+    tools?: string[];
+    mcpServers?: {
+        name: string;
+        status: string;
+    }[];
+    permissionMode?: string;
+    apiKeySource?: string;
+    slashCommands?: string[];
+    agents?: string[];
+}
+export declare const PROVIDER_RUNTIME_EVENT_TYPES: readonly ["init", "assistant_delta", "tool_started", "tool_finished", "provider_turn_finished", "provider_error", "task_notification", "tool_activity", "mode_transition", "thinking_delta", "retry_scheduled"];
+export type ProviderRuntimeEventType = (typeof PROVIDER_RUNTIME_EVENT_TYPES)[number];
+export type LegacyProviderRuntimeEventType = 'assistant' | 'result' | 'tool_use' | 'tool_result' | 'error';
+export interface ProviderRuntimeEvent {
+    type: ProviderRuntimeEventType | LegacyProviderRuntimeEventType;
+    retryInfo?: {
+        attempt: number;
+        maxAttempts: number;
+        delayMs: number;
+        status?: number;
+    };
+    sessionId?: string;
+    content?: string;
+    systemInfo?: SystemInfo;
+    toolUseId?: string;
+    toolName?: string;
+    toolInput?: unknown;
+    toolEffect?: ToolEffect;
+    toolInteractionKind?: ToolInteractionKind;
+    toolSemantic?: ToolSemantic;
+    toolResult?: unknown;
+    isToolError?: boolean;
+    error?: string;
+    errorCode?: string;
+    usage?: ProviderUsage;
+    isComplete?: boolean;
+    taskId?: string;
+    taskStatus?: string;
+    taskMessage?: string;
+    taskToolUseId?: string;
+    modeTransition?: ModeTransition;
+    thinkingContent?: string;
+    thinkingSignature?: string;
+    thinkingRedacted?: boolean;
+}
+export interface ProviderAssistantDeltaEvent extends ProviderRuntimeEvent {
+    type: 'assistant_delta' | 'assistant';
+    content: string;
+}
+export interface ProviderToolStartedEvent extends ProviderRuntimeEvent {
+    type: 'tool_started' | 'tool_use';
+}
+export interface ProviderTurnFinishedEvent extends ProviderRuntimeEvent {
+    type: 'provider_turn_finished' | 'result';
+}
+export interface ProviderToolBridgeEntry {
+    name: string;
+    /** Config shape is owned by the external agent SDK. */
+    config: unknown;
+}
+export interface ProviderToolBridgeRequest {
+    serverPort?: number;
+    sessionId?: string;
+}
+export interface ExternalAgentRunContext {
+    cwd: string;
+    sessionId?: string;
+    env?: Record<string, string>;
+    mode?: string;
+    systemPrompt?: string;
+    sessionTitle?: string;
+    serverPort?: number;
+    claudiaSessionId?: string;
+    thinkingLevel?: ThinkingLevel;
+    model?: string;
+    cliPath?: string;
+    abortController?: AbortController;
+}
+export interface ExternalAgentRunState {
+    providerSessionId?: string;
+    providerCwd: string;
+}
+export interface ExternalAgentAdapter {
+    readonly type: string;
+    run(input: string, context: ExternalAgentRunContext, onPermission: PermissionCallback): AsyncGenerator<ProviderRuntimeEvent, void, void>;
+    abort?(sessionId: string, cwd: string): Promise<void>;
+    getRunState?(context: ExternalAgentRunContext): ExternalAgentRunState;
+    setSessionMode?(sessionId: string, mode: string): void;
+}
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"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"}

package/dist/providers.js

@@ -0,0 +1,14 @@
+export const PROVIDER_RUNTIME_EVENT_TYPES = [
+    'init',
+    'assistant_delta',
+    'tool_started',
+    'tool_finished',
+    'provider_turn_finished',
+    'provider_error',
+    'task_notification',
+    'tool_activity',
+    'mode_transition',
+    'thinking_delta',
+    'retry_scheduled',
+];
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AA2HA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,MAAM;IACN,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,wBAAwB;IACxB,gBAAgB;IAChB,mBAAmB;IACnB,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;CACT,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,279 @@
+import type { PermissionCallback } from './interactions.js';
+import type { Permission, PluginManifest } from './manifest.js';
+import type { ExternalAgentAdapter, ProviderToolBridgeEntry, ProviderToolBridgeRequest } from './providers.js';
+export type EventHandler = (data: unknown) => void | Promise<void>;
+export interface EventAPI {
+    on(event: string, handler: EventHandler): () => void;
+    once(event: string, handler: EventHandler): void;
+    off(event: string, handler: EventHandler): void;
+    emit(event: string, data: unknown): Promise<void>;
+}
+export interface StorageAPI {
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(): Promise<string[]>;
+    clear(): Promise<void>;
+}
+export interface LogAPI {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+export interface FileSystemAPI {
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    readdir(path: string): Promise<string[]>;
+    mkdir(path: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+}
+export interface NetworkAPI {
+    fetch(url: string, options?: Record<string, unknown>): Promise<{
+        ok: boolean;
+        status: number;
+        body: string;
+    }>;
+}
+export interface NotificationAPI {
+    show(title: string, body: string, options?: {
+        notchTab?: string;
+    }): Promise<void>;
+}
+export interface ClipboardAPI {
+    read(): Promise<string>;
+    write(text: string): Promise<void>;
+}
+export interface ShellAPI {
+    execute(command: string, args?: string[], options?: {
+        cwd?: string;
+    }): Promise<{
+        stdout: string;
+        stderr: string;
+        code: number;
+    }>;
+}
+export interface SessionAPI {
+    getActive(): Promise<{
+        id: string;
+        projectId: string;
+    } | null>;
+    getById(id: string): Promise<unknown>;
+    list(): Promise<unknown[]>;
+}
+export interface ProjectAPI {
+    getActive(): Promise<{
+        id: string;
+        name: string;
+        path: string;
+    } | null>;
+    getById(id: string): Promise<unknown>;
+    list(): Promise<unknown[]>;
+}
+export interface UIComponents {
+    Button: unknown;
+    Input: unknown;
+    Card: unknown;
+    Badge: unknown;
+}
+export interface UIAPI {
+    components: UIComponents;
+    showPanel(panelId: string): void;
+    showNotification(message: string): void;
+}
+export interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface ProviderInfo {
+    id: string;
+    name: string;
+    type: string;
+    models: string[];
+    isDefault?: boolean;
+}
+export interface ProviderCallOptions {
+    providerId: string;
+    modelOverride?: string;
+    messages: ChatMessage[];
+    systemPrompt?: string;
+    maxTokens?: number;
+    temperature?: number;
+    stream?: boolean;
+}
+export interface ProviderCallResult {
+    content: string;
+    model: string;
+    providerId: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    metadata?: Record<string, unknown>;
+    isComplete?: boolean;
+    suggestedNextSteps?: string[];
+}
+export interface ProviderStreamChunk {
+    type: 'content' | 'usage' | 'done' | 'error';
+    content?: string;
+    delta?: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    error?: string;
+}
+export interface ProviderAPI {
+    list(): Promise<ProviderInfo[]>;
+    get(providerId: string): Promise<ProviderInfo | undefined>;
+    call(options: ProviderCallOptions): Promise<ProviderCallResult>;
+    callStream(options: ProviderCallOptions): AsyncGenerator<ProviderStreamChunk>;
+}
+export interface McpServerInfo {
+    name: string;
+    enabled: boolean;
+    description?: string;
+}
+export interface McpToolInfo {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface McpAPI {
+    listServers(): Promise<McpServerInfo[]>;
+    listTools(serverName: string): Promise<McpToolInfo[]>;
+    callTool<T = unknown>(serverName: string, tool: string, args: Record<string, unknown>): Promise<T>;
+}
+export interface PluginSchedulerTask {
+    id: string;
+    name: string;
+    intervalMs: number;
+    immediate?: boolean;
+}
+export interface PluginSchedulerAPI {
+    register(task: PluginSchedulerTask, handler: () => Promise<void> | void): () => void;
+    unregister(taskId: string): void;
+    trigger(taskId: string): Promise<void>;
+}
+export interface PermissionAPI {
+    hasPermission(permission: Permission): boolean;
+    hasAllPermissions(permissions: Permission[]): boolean;
+    requestPermission(permission: Permission): Promise<boolean>;
+    requestPermissions(permissions: Permission[]): Promise<boolean>;
+    getGrantedPermissions(): Permission[];
+}
+export type WorkflowStepHandler = (config: Record<string, unknown>, context: {
+    projectId?: string;
+    projectRootPath?: string;
+    providerId?: string;
+    stepRunId: string;
+    runId: string;
+}) => Promise<{
+    status: 'completed' | 'failed';
+    output: Record<string, unknown>;
+    error?: string;
+}>;
+export interface WorkflowStepsAPI {
+    registerWorkflowStep(stepId: string, handler: WorkflowStepHandler): void;
+    unregisterWorkflowStep(stepId: string): void;
+}
+export interface AgentRuntimesAPI {
+    register(adapter: ExternalAgentAdapter): void;
+    unregister(type: string): void;
+    createToolBridge(request: ProviderToolBridgeRequest): Promise<ProviderToolBridgeEntry | null>;
+}
+export interface CapabilityNegotiationResult {
+    satisfied: boolean;
+    mcp: Record<string, {
+        server: string;
+        available: boolean;
+        availableTools?: string[];
+        missingTools?: string[];
+        error?: string;
+    }>;
+    plugins: Record<string, {
+        available: boolean;
+    }>;
+    providers: {
+        available: boolean;
+    };
+    unsatisfiedReasons: string[];
+}
+export type CommandHandler = (args: string[], context?: Record<string, unknown>) => Promise<unknown> | unknown;
+export type ToolHandler = (args: Record<string, unknown>, context?: Record<string, unknown>) => Promise<string> | string;
+export interface ToolRegistration {
+    id: string;
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    handler: ToolHandler;
+    scope?: Array<'agent-assistant' | 'main-session' | 'command-palette'>;
+    permissions?: Permission[];
+}
+export interface UIExtensionRegistration {
+    id: string;
+    location: 'sidebar' | 'panel' | 'toolbar' | 'context-menu' | 'status-bar';
+    component: unknown;
+    when?: (context: unknown) => boolean;
+}
+export interface PluginContext {
+    pluginId: string;
+    /** Installed manifest version. */
+    version: string;
+    /** Absolute path of the installed plugin. */
+    extensionPath: string;
+    events: EventAPI;
+    commands: {
+        registerCommand(command: string, handler: CommandHandler): void;
+        unregisterCommand(command: string): void;
+    };
+    tools: {
+        registerTool(meta: ToolRegistration): void;
+        unregisterTool(toolId: string): void;
+    };
+    registerUIExtension(extension: UIExtensionRegistration): void;
+    workflowSteps: WorkflowStepsAPI;
+    permissions: PermissionAPI;
+    storage: StorageAPI;
+    fs?: FileSystemAPI;
+    network?: NetworkAPI;
+    notification?: NotificationAPI;
+    clipboard?: ClipboardAPI;
+    shell?: ShellAPI;
+    scheduler?: PluginSchedulerAPI;
+    session?: SessionAPI;
+    project?: ProjectAPI;
+    ui?: UIAPI;
+    providers?: ProviderAPI;
+    agentRuntimes?: AgentRuntimesAPI;
+    mcp?: McpAPI;
+    capabilities?: CapabilityNegotiationResult;
+    exports<T>(api: T): void;
+    getPluginAPI<T>(pluginId: string): T | undefined;
+    log: LogAPI;
+    env: {
+        isDesktop: boolean;
+        isServer: boolean;
+        appVersion: string;
+        platform: 'darwin' | 'win32' | 'linux';
+    };
+}
+export interface PluginInstance {
+    manifest: PluginManifest;
+    path: string;
+    isActive: boolean;
+    module?: unknown;
+    error?: string;
+    pendingPermissions?: string[];
+    capabilities?: CapabilityNegotiationResult;
+}
+export interface PluginModule {
+    activate(context: PluginContext): Promise<void> | void;
+    deactivate?(): Promise<void> | void;
+}
+/** Identity helper that preserves a plugin module's concrete type. */
+export declare function definePlugin<const T extends PluginModule>(plugin: T): T;
+/** Convenience type for adapters that accept permission callbacks directly. */
+export type RuntimePermissionCallback = PermissionCallback;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/dist/runtime.js

@@ -0,0 +1,5 @@
+/** Identity helper that preserves a plugin module's concrete type. */
+export function definePlugin(plugin) {
+    return plugin;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAqTA,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAA+B,MAAS;IAClE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,114 @@
+/** Thinking effort understood by ZClaudia agent profiles. */
+export type ThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+/** Normalized side effect produced by a provider tool call. */
+export interface FileChangeEffectFile {
+    path: string;
+    changeKind?: 'add' | 'modify' | 'delete' | 'rename' | 'unknown';
+    summary?: string;
+}
+export type ToolEffect = {
+    kind: 'file_change';
+    files: FileChangeEffectFile[];
+} | {
+    kind: 'shell';
+    command: string;
+};
+/** Provider-declared meaning of a tool call, independent of provider-specific names. */
+export type ToolSemantic = 'plan_proposal' | 'plan_enter' | 'plan_exit';
+export type ContextWindowSource = 'profile_entry' | 'pi_ai_registry' | 'openai_compat_default' | 'fallback';
+export interface ProviderUsageCost {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    total: number;
+}
+/** Provider-neutral token usage. This deliberately does not depend on a model SDK. */
+export interface ProviderUsage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    totalTokens: number;
+    cost: ProviderUsageCost;
+}
+export type ModelConfigKind = 'llm-profile' | 'native' | 'none';
+export type RuntimeCapabilityMode = 'profile' | 'external' | 'native-readonly' | 'unsupported';
+export type ThinkingLevelMode = 'off' | 'auto' | 'selectable';
+export type BuiltinToolSetId = 'read-only' | 'coding' | 'web' | 'full';
+export type ToolSetRef = {
+    source: 'builtin';
+    id: BuiltinToolSetId;
+} | {
+    source: 'plugin';
+    pluginId: string;
+    id: string;
+};
+export type ToolRef = {
+    source: 'builtin';
+    id: string;
+} | {
+    source: 'plugin';
+    pluginId: string;
+    id: string;
+} | {
+    source: 'mcp';
+    serverId: string;
+    id: string;
+} | {
+    source: 'mcp-resource';
+    serverId: string;
+    id: string;
+} | {
+    source: 'mcp-prompt';
+    serverId: string;
+    id: string;
+} | {
+    source: 'interaction';
+    id: string;
+};
+export type ExternalToolProviderRef = {
+    source: 'mcp';
+    serverId: string;
+} | {
+    source: 'plugin';
+    pluginId: string;
+    providerId?: string;
+};
+export interface ToolSelection {
+    sets: ToolSetRef[];
+    providers?: ExternalToolProviderRef[];
+    include: ToolRef[];
+    exclude: ToolRef[];
+}
+export type SkillSource = 'workspace' | 'external' | 'plugin';
+export interface SkillRef {
+    source: SkillSource;
+    id: string;
+}
+export type SkillSourceRef = {
+    source: 'workspace';
+} | {
+    source: 'external';
+} | {
+    source: 'plugin';
+    pluginId?: string;
+};
+export interface SkillSelection {
+    providers?: SkillSourceRef[];
+    include?: SkillRef[];
+    exclude?: SkillRef[];
+    pinned?: SkillRef[];
+}
+export type SkillExecutionMode = 'inline' | 'fork';
+export type SkillForkToolPolicy = 'read-only' | 'web' | 'workspace-edit' | 'agent-default';
+export interface SkillExecutionOverride {
+    ref: SkillRef;
+    allowedModes?: SkillExecutionMode[];
+    defaultMode?: SkillExecutionMode;
+    forkToolPolicy?: SkillForkToolPolicy;
+}
+export interface SkillExecutionSelection {
+    overrides?: SkillExecutionOverride[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@zclaudia/plugin-sdk",
+  "version": "0.1.0",
+  "description": "Public contracts and development helpers for ZClaudia plugins.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./interactions": {
+      "types": "./dist/interactions.d.ts",
+      "import": "./dist/interactions.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "import": "./dist/manifest.js"
+    },
+    "./providers": {
+      "types": "./dist/providers.d.ts",
+      "import": "./dist/providers.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist coverage",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pack:check": "npm pack --dry-run",
+    "prepublishOnly": "pnpm clean && pnpm test && pnpm build"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "packageManager": "pnpm@9.15.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zclaudia/zclaudia-plugin-sdk.git"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.8"
+  }
+}