@kvell007/embed-labs-protocol 0.1.0-alpha.97 → 0.1.0-alpha.99

package/README.md

@@ -1,7 +1,7 @@
 # @embed-labs/protocol
 
-Shared TypeScript contracts for Embed Labs Cloud clients, services, the CLI,
-and the local bridge.
+Shared TypeScript contracts for EmbedLabs local Agent clients, services, the
+CLI, and the local bridge.
 
 ## Package Status
 
@@ -13,16 +13,30 @@ are complete.
 ## What It Provides
 
 - API success and failure envelopes.
-- Cloud task, project, event, artifact, and validation evidence contracts.
-- Server build template, workspace, resource lease, and execution mode
-  contracts.
 - Local bridge device, serial, probe, job, approval, and flash plan contracts.
 - Board Pack manifest and validation matrix types.
+- BoardPack catalog/profile metadata used by the local Agent and Cloud download
+  metadata services.
 - Small `ok()` and `fail()` helpers for consistent API responses.
 
 The package is types-first and has no direct hardware, network, filesystem, or
 process side effects.
 
+## Retired Internal Contracts
+
+Some exported types still describe historical Cloud task, project, artifact,
+token-usage, build-template, server-workspace, source-sync, resource-lease, and
+execution-mode prototypes. They are retained only so the current Cloud API can
+read migration evidence, raw diagnostics, and retired records while those code
+paths are being cleaned up.
+
+Those legacy types are not a current public product contract. New client code,
+plugins, BoardPacks, SDK installers, and user-facing docs must not use them to
+create server workspaces, cloud compile flows, platform API-key login, token
+usage metering, recharge, quota, billing, or artifact-download workflows.
+Current user workflows go through the local Native Agent, GoLocalBridge,
+BoardPacks, local SDK/toolchains, and redacted public reports.
+
 ## Install
 
 After the package is approved for public release:
@@ -40,16 +54,15 @@ import {
   fail,
   ok,
   type DeviceScanResult,
-  type FlashPlan,
-  type TaskStatus
+  type FlashPlan
 } from "@embed-labs/protocol";
 
 export function health() {
   return ok({ service: "example", status: "ok" });
 }
 
-export function missingTask(taskId: string) {
-  return fail("task_not_found", `No task found for ${taskId}.`, {
+export function missingLocalDevice(localDeviceId: string) {
+  return fail("local_device_not_found", `No local device found for ${localDeviceId}.`, {
     retryable: false
   });
 }

package/dist/index.d.ts

@@ -51,7 +51,12 @@ export interface BoardDeployRequest {
     user?: string;
     artifact_path: string;
     remote_path?: string;
+    remote_dir?: string;
+    remote_file?: string;
     run_command?: string;
+    wrapper_script?: string;
+    run_script?: string;
+    wrapper_remote_path?: string;
     run?: boolean;
     timeout_seconds?: number;
     approved?: boolean;
@@ -63,14 +68,24 @@ export interface BoardDeployResult {
     artifact_path: string;
     artifact_size_bytes?: number;
     remote_path: string;
+    remote_dir?: string;
+    remote_file?: string;
     deployed: boolean;
     ran: boolean;
+    run_status?: "not_requested" | "running" | "run_failed" | string;
+    run_command?: string;
+    wrapper_script?: string;
+    wrapper_remote_path?: string;
     remote_pid?: string;
+    app_pid?: string;
+    wrapper_pid?: string;
     log_path?: string;
     exit_code?: number | null;
     stdout?: string;
     stderr?: string;
     output_tail?: string[];
+    process_check?: unknown;
+    error?: ErrorEnvelope | Record<string, unknown>;
     observed_at: string;
 }
 export type TaishanPiDeployRequest = BoardDeployRequest;
@@ -87,6 +102,11 @@ export interface ValidationEvidence {
     artifact_ids?: string[];
     verdict: "pass" | "fail" | "inconclusive";
 }
+/**
+ * @deprecated Retired Cloud task prototype contract. Current user-facing
+ * EmbedLabs flows use the local Native Agent, GoLocalBridge jobs, BoardPacks,
+ * local SDK/toolchains, and redacted public reports instead of server tasks.
+ */
 export interface TaskStatus {
     task_id: string;
     state: TaskState;
@@ -104,6 +124,10 @@ export interface TaskStatus {
     created_at: string;
     updated_at: string;
 }
+/**
+ * @deprecated Retired project/workspace prototype contract. Do not use for new
+ * local Agent, plugin, BoardPack, SDK, or Cloud API product flows.
+ */
 export interface ProjectStatus {
     project_id: string;
     name: string;
@@ -112,102 +136,46 @@ export interface ProjectStatus {
     created_at: string;
     updated_at: string;
 }
+/**
+ * @deprecated Retired project/workspace prototype contract. Current product
+ * paths must not create server-side user projects or workspaces.
+ */
 export interface ProjectCreateRequest {
     name: string;
     board_id?: string;
     workspace_path?: string;
 }
-export interface AccountStatus {
-    account_id: string;
-    email: string;
-    display_name?: string;
-    device_limit?: number;
-    created_at: string;
-    updated_at: string;
-}
-export interface AccountCreateRequest {
-    email: string;
-    display_name?: string;
-}
-export type AuthContextInfo = {
+export interface AuthContextInfo {
     kind: "admin";
     roles?: string[];
-} | {
-    kind: "user";
-    account_id: string;
-    user_id: string;
-} | {
-    kind: "api_key";
-    account_id: string;
-    api_key_id: string;
-    client_device_id?: string;
-    device_id?: string;
-};
-export interface ApiKeySummary {
-    api_key_id: string;
-    account_id: string;
-    name?: string;
-    key_prefix: string;
-    api_key?: string;
-    secret_available?: boolean;
-    created_at: string;
-    last_used_at?: string;
-    revoked_at?: string;
-}
-export interface ApiKeyCreateRequest {
-    name?: string;
-}
-export interface ApiKeyCreateResult {
-    api_key: string;
-    api_key_record: ApiKeySummary;
 }
+/**
+ * @deprecated Retired platform token-usage prototype. Current reporting is
+ * product-improvement telemetry and redacted public experience, not account
+ * billing, recharge, quota, or finance-grade token metering.
+ */
 export interface TokenUsageRecord {
     usage_id: string;
-    account_id: string;
-    api_key_id: string;
     client_device_id?: string;
     local_device_id?: string;
-    /** @deprecated Use client_device_id for account_devices rows. */
-    device_id?: string;
     provider?: string;
     model: string;
     operation?: string;
     input_tokens: number;
     output_tokens: number;
     total_tokens: number;
-    task_id?: string;
     request_id?: string;
     created_at: string;
 }
-export interface TokenUsageCreateRequest {
-    api_key?: string;
-    api_key_id?: string;
-    client_device_id?: string;
-    local_device_id?: string;
-    /** @deprecated Use client_device_id for account_devices rows or local_device_id for boards. */
-    device_id?: string;
-    provider?: string;
-    model: string;
-    operation?: string;
-    input_tokens: number;
-    output_tokens: number;
-    task_id?: string;
-    request_id?: string;
-    created_at?: string;
-}
 export interface McpToolEventRecord {
     event_id: string;
-    account_id?: string;
-    user_id?: string;
-    api_key_id?: string;
+    client_installation_id?: string;
     client_device_id?: string;
+    client_installation?: Record<string, unknown>;
     local_device_id?: string;
-    /** @deprecated Use client_device_id for account_devices rows. */
-    device_id?: string;
     client: string;
     tool_name: string;
     mode: string;
-    server_model_used: boolean;
     success: boolean;
     request_id?: string;
     duration_ms?: number;
@@ -217,15 +185,13 @@ export interface McpToolEventRecord {
     created_at: string;
 }
 export interface McpToolEventCreateRequest {
-    account_id?: string;
+    client_installation_id?: string;
     client_device_id?: string;
+    client_installation?: Record<string, unknown>;
     local_device_id?: string;
-    /** @deprecated Use client_device_id for account_devices rows or local_device_id for boards. */
-    device_id?: string;
     client?: string;
     tool_name: string;
     mode?: string;
-    server_model_used?: boolean;
     success?: boolean;
     request_id?: string;
     duration_ms?: number;
@@ -234,286 +200,11 @@ export interface McpToolEventCreateRequest {
     metadata?: Record<string, unknown>;
     created_at?: string;
 }
-export interface ClientDeviceContext {
-    device_id: string;
-    fingerprint_hash: string;
-    platform?: string;
-    arch?: string;
-    label?: string;
-}
-export interface ClientDeviceRegistrationRequest {
-    fingerprint_hash: string;
-    public_key: string;
-    label?: string;
-    platform?: string;
-    arch?: string;
-    hostname_hash?: string;
-    client_name?: string;
-    client_version?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface AccountDeviceRecord {
-    device_id: string;
-    account_id: string;
-    api_key_id?: string;
-    fingerprint_hash: string;
-    public_key?: string;
-    label?: string;
-    platform?: string;
-    arch?: string;
-    hostname_hash?: string;
-    status: "active" | "revoked";
-    first_seen_at: string;
-    last_seen_at: string;
-    revoked_at?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface ClientDeviceRegistrationResult {
-    device: AccountDeviceRecord;
-    device_limit: number;
-    active_device_count: number;
-}
-export interface TokenUsageModelSummary {
-    model: string;
-    input_tokens: number;
-    output_tokens: number;
-    total_tokens: number;
-    event_count: number;
-}
-export interface TokenUsageSummary {
-    account_id?: string;
-    api_key_id?: string;
-    from?: string;
-    to?: string;
-    input_tokens: number;
-    output_tokens: number;
-    total_tokens: number;
-    event_count: number;
-    by_model: TokenUsageModelSummary[];
-}
-export interface TokenUsageEventList {
-    account_id: string;
-    api_key_id?: string;
-    from?: string;
-    to?: string;
-    limit?: number;
-    usage_events: TokenUsageRecord[];
-}
-export interface BillingStatementLine {
-    provider?: string;
-    model: string;
-    input_tokens: number;
-    output_tokens: number;
-    total_tokens: number;
-    event_count: number;
-    input_cost_microusd: number;
-    output_cost_microusd: number;
-    total_cost_microusd: number;
-}
-export interface BillingStatement {
-    account_id: string;
-    from?: string;
-    to?: string;
-    currency: "USD";
-    rate_source: "env";
-    input_microusd_per_token: number;
-    output_microusd_per_token: number;
-    input_tokens: number;
-    output_tokens: number;
-    total_tokens: number;
-    event_count: number;
-    input_cost_microusd: number;
-    output_cost_microusd: number;
-    total_cost_microusd: number;
-    line_items: BillingStatementLine[];
-    generated_at: string;
-}
-export interface BillingSnapshot {
-    billing_snapshot_id: string;
-    account_id: string;
-    from?: string;
-    to?: string;
-    currency: "USD";
-    rate_source: "env";
-    input_microusd_per_token: number;
-    output_microusd_per_token: number;
-    input_tokens: number;
-    output_tokens: number;
-    total_tokens: number;
-    event_count: number;
-    input_cost_microusd: number;
-    output_cost_microusd: number;
-    total_cost_microusd: number;
-    line_items: BillingStatementLine[];
-    statement_generated_at: string;
-    created_at: string;
-}
-export type BillingPaymentProvider = "mock" | "stripe" | "onchain";
-export type BillingRechargeSessionStatus = "pending" | "confirming" | "paid" | "expired" | "cancelled" | "manual_review";
-export interface AccountCreditBalance {
-    account_id: string;
-    currency: "USD";
-    balance_cents: number;
-    pending_recharge_cents: number;
-    updated_at: string;
-    source: "local";
-}
-export type TokenLedgerEntryKind = "recharge_credit" | "model_usage_debit" | "storage_debit";
-export interface AccountTokenBalance {
-    account_id: string;
-    balance_tokens: number;
-    updated_at: string;
-    source: "local";
-}
-export interface TokenLedgerEntry {
-    ledger_entry_id: string;
-    account_id: string;
-    kind: TokenLedgerEntryKind;
-    token_delta: number;
-    balance_after_tokens: number;
-    created_at: string;
-    idempotency_key: string;
-    usage_id?: string;
-    api_key_id?: string;
-    provider?: string;
-    model?: string;
-    task_id?: string;
-    workspace_id?: string;
-    metered_from?: string;
-    metered_to?: string;
-    description?: string;
-}
-export interface TokenLedgerEntryList {
-    entries: TokenLedgerEntry[];
-}
-export interface WorkspaceStorageUsage {
-    workspace_id: string;
-    account_id: string;
-    project_id: string;
-    template_id: string;
-    quota_mb: number;
-    allocated_bytes: number;
-    used_bytes: number;
-    age_seconds: number;
-    storage_token_rate_per_gb_hour: number;
-    accrued_storage_tokens: number;
-    created_at: string;
-    updated_at: string;
-    last_storage_settled_at?: string;
-    observed_at: string;
-}
-export interface AccountStorageSummary {
-    account_id: string;
-    quota_mb: number;
-    allocated_mb: number;
-    allocated_bytes: number;
-    used_bytes: number;
-    workspace_count: number;
-    storage_token_rate_per_gb_hour: number;
-    accrued_storage_tokens: number;
-    observed_at: string;
-    workspaces: WorkspaceStorageUsage[];
-}
-export interface StorageSettlementRequest {
-    dry_run?: boolean;
-}
-export interface StorageSettlementWorkspaceLine {
-    workspace_id: string;
-    project_id: string;
-    template_id: string;
-    quota_mb: number;
-    metered_from: string;
-    metered_to: string;
-    duration_seconds: number;
-    storage_token_rate_per_gb_hour: number;
-    tokens: number;
-}
-export interface StorageSettlementResult {
-    account_id: string;
-    dry_run: boolean;
-    settled_at: string;
-    balance_before_tokens: number;
-    balance_after_tokens: number;
-    tokens_debited: number;
-    ledger_entries: TokenLedgerEntry[];
-    workspaces: StorageSettlementWorkspaceLine[];
-}
-export interface BillingRechargeSessionCreateRequest {
-    account_id?: string;
-    amount_cents?: number;
-    amount_usd?: string | number;
-    currency?: "USD";
-    provider?: BillingPaymentProvider;
-    chain?: string;
-    token_symbol?: string;
-    success_url?: string;
-    cancel_url?: string;
-}
-export interface BillingOnchainPaymentDetails {
-    chain: string;
-    chain_id?: string;
-    token_symbol: string;
-    token_contract?: string;
-    token_decimals: number;
-    token_amount: string;
-    token_amount_units: string;
-    receive_address: string;
-    payment_uri: string;
-    required_confirmations: number;
-    tx_hash?: string;
-    received_at?: string;
-    confirmed_at?: string;
-    explorer_url?: string;
-}
-export interface BillingRechargeSessionTxSubmitRequest {
-    tx_hash?: string;
-    transaction_hash?: string;
-}
-export interface BillingRechargeSession {
-    recharge_session_id: string;
-    account_id: string;
-    provider: BillingPaymentProvider;
-    amount_cents: number;
-    currency: "USD";
-    status: BillingRechargeSessionStatus;
-    checkout_url: string;
-    qr_payload: string;
-    supported_payment_method_policy: "provider_dynamic" | "onchain_wallet_only";
-    provider_session_id?: string;
-    onchain?: BillingOnchainPaymentDetails;
-    created_at: string;
-    expires_at: string;
-    paid_at?: string;
-}
-export interface BillingRechargeSessionList {
-    recharge_sessions: BillingRechargeSession[];
-}
-export interface BillingOnchainPaymentObservation {
-    chain: string;
-    token_symbol: string;
-    token_contract?: string;
-    receive_address: string;
-    token_amount_units: string;
-    tx_hash: string;
-    confirmations: number;
-    observed_at?: string;
-    block_height?: number;
-}
-export interface BillingOnchainPaymentObservationResult {
-    observation_id: string;
-    status: "confirming" | "paid" | "manual_review" | "duplicate";
-    reason?: string;
-    recharge_session?: BillingRechargeSession;
-    matched_session_ids: string[];
-    required_confirmations?: number;
-    confirmations: number;
-    observed_at: string;
-}
 export interface BuildTemplateWorkspace {
     root_kind: string;
     seed_relative_path: string;
-    user_workspace_relative_path: string;
-    artifact_relative_path: string;
+    local_project_relative_path: string;
+    build_output_relative_path: string;
     cache_relative_path: string;
     copy_strategy: string;
     ignored_names?: string[];
@@ -551,9 +242,18 @@ export interface BuildTemplate {
     hardware_profile_id: string;
     default_build_profile_id: string;
     image_build_profile_id?: string;
+    execution_plane: "local_toolchain" | "local_bridge" | string;
     workspace: BuildTemplateWorkspace;
-    docker: BuildTemplateDocker;
-    resource_limits: BuildTemplateResourceLimits;
+    /**
+     * @deprecated Retired server-workspace prototype. Current build templates are
+     * local toolchain metadata and must not require Docker workers.
+     */
+    docker?: BuildTemplateDocker;
+    /**
+     * @deprecated Retired server-workspace prototype. Current build templates are
+     * local toolchain metadata and must not allocate server resource limits.
+     */
+    resource_limits?: BuildTemplateResourceLimits;
     outputs: string[];
     validation: BuildTemplateValidation;
 }
@@ -596,8 +296,9 @@ export interface BoardKnowledgeSearchResult {
     matches: BoardKnowledgeSearchMatch[];
     observed_at: string;
 }
-export type BoardServerMethodOperation = "workspace.provision" | "source.list" | "source.read" | "source.write" | "app.build" | "app.compile" | "image.build" | "artifact.download" | "workspace.release" | "local_toolchain.list" | "local_toolchain.latest" | "local_toolchain.install" | "local_toolchain.validate" | "local.compile" | "local.qt_smoke" | "board.status" | "board.deploy" | "image.logo.package" | "image.logo.compose" | "monitor.capabilities" | "monitor.status" | "monitor.gpio.read" | "monitor.gpio.write" | "monitor.uart.write" | "monitor.i2c.transfer" | "monitor.spi.transfer" | "monitor.logic.capture" | "monitor.logic.decode" | "monitor.wifi.manage" | "monitor.probe.debug" | "monitor.firmware.flash" | "initial_firmware.flash" | "flash.plan" | "flash.run";
-export type ProductAccessTier = "free_registered" | "paid_resource" | "paid_managed_model";
+export type BoardServerMethodOperation = "local_toolchain.list" | "local_toolchain.latest" | "local_toolchain.install" | "local_toolchain.validate" | "local.compile" | "local.qt_smoke" | "board.status" | "board.deploy" | "image.logo.update" | "image.logo.compose" | "monitor.capabilities" | "monitor.status" | "monitor.gpio.read" | "monitor.gpio.write" | "monitor.uart.write" | "monitor.i2c.transfer" | "monitor.spi.transfer" | "monitor.logic.capture" | "monitor.logic.decode" | "monitor.wifi.manage" | "monitor.probe.debug" | "monitor.firmware.flash" | "initial_firmware.flash" | "artifact.download" | "flash.plan" | "flash.run";
+export type ProductAccessTier = "local_native_agent" | "local_advanced" | "admin_service_agent";
+export type CapabilityMeter = "none" | "local_diagnostics" | "download_distribution" | "admin_review";
 export interface BoardServerMethodSummary {
     method_id: string;
     operation: BoardServerMethodOperation;
@@ -611,10 +312,10 @@ export interface BoardServerMethodSummary {
     requires_approval: boolean;
     status: "available" | "mvp_stub" | "mvp_direct" | "planned";
     access_tier?: ProductAccessTier;
-    free_for_registered_users?: boolean;
+    uses_local_installation_identity?: boolean;
     allocates_server_workspace?: boolean;
     allocates_server_resource_lease?: boolean;
-    meters?: ServiceModeMeter[];
+    meters?: CapabilityMeter[];
     input_schema: Record<string, unknown>;
     output_artifact_kinds?: ArtifactMetadata["kind"][];
     notes?: string[];
@@ -636,6 +337,11 @@ export interface BoardServerProfileList {
     profiles: BoardServerProfile[];
 }
 export type BuildWorkspaceCopyMode = "auto" | "copy" | "symlink" | "skeleton";
+/**
+ * @deprecated Retired server-workspace prototype. Current normal users do not
+ * provision Cloud workspaces; source, build, flash, deploy, and debug run
+ * locally through the Native Agent.
+ */
 export interface BuildWorkspaceProvisionRequest {
     account_id: string;
     project_id: string;
@@ -644,6 +350,10 @@ export interface BuildWorkspaceProvisionRequest {
     require_seed?: boolean;
     dry_run?: boolean;
 }
+/**
+ * @deprecated Retired server-workspace prototype retained only for migration
+ * evidence and raw diagnostics.
+ */
 export interface BuildWorkspaceProvisionResult {
     workspace_id?: string;
     template_id: string;
@@ -666,6 +376,10 @@ export interface BuildWorkspaceProvisionResult {
     created_at?: string;
     updated_at?: string;
 }
+/**
+ * @deprecated Retired server-workspace prototype retained only for migration
+ * evidence and raw diagnostics.
+ */
 export interface BuildWorkspaceRecord {
     workspace_id: string;
     template_id: string;
@@ -688,32 +402,34 @@ export interface BuildWorkspaceRecord {
     storage_settled_at?: string;
     released_at?: string;
 }
+/**
+ * @deprecated Retired server-workspace prototype retained only for migration
+ * evidence and raw diagnostics.
+ */
 export interface BuildWorkspaceList {
     workspaces: BuildWorkspaceRecord[];
 }
-export interface BuildWorkspaceReleaseRequest {
-    dry_run?: boolean;
-    settle_storage?: boolean;
-}
-export interface BuildWorkspaceReleaseResult {
-    workspace_id: string;
-    account_id: string;
-    project_id: string;
-    dry_run: boolean;
-    released_at?: string;
-    deleted_paths: string[];
-    storage_settlement?: StorageSettlementResult;
-}
+/**
+ * @deprecated Retired server-workspace source-sync prototype. Current source
+ * files stay on the user's computer and are handled by local toolchains.
+ */
 export interface BuildWorkspaceSourceFile {
     path: string;
     content_base64: string;
     size_bytes?: number;
     sha256?: string;
 }
+/**
+ * @deprecated Retired server-workspace source-sync prototype. Do not upload
+ * user source trees through this contract in current product flows.
+ */
 export interface BuildWorkspaceSourceSyncRequest {
     account_id?: string;
     files: BuildWorkspaceSourceFile[];
 }
+/**
+ * @deprecated Retired server-workspace source-sync prototype.
+ */
 export interface BuildWorkspaceSourceSyncResult {
     workspace_id: string;
     source_path: string;
@@ -722,6 +438,9 @@ export interface BuildWorkspaceSourceSyncResult {
     written_files: string[];
     updated_at: string;
 }
+/**
+ * @deprecated Retired server-workspace source-list prototype.
+ */
 export interface BuildWorkspaceSourceListResult {
     workspace_id: string;
     source_path: string;
@@ -733,6 +452,9 @@ export interface BuildWorkspaceSourceListResult {
     }>;
     updated_at: string;
 }
+/**
+ * @deprecated Retired server-workspace source-read prototype.
+ */
 export interface BuildWorkspaceSourceReadResult {
     workspace_id: string;
     source_path: string;
@@ -742,11 +464,17 @@ export interface BuildWorkspaceSourceReadResult {
     sha256: string;
     updated_at: string;
 }
+/**
+ * @deprecated Retired server-workspace source-search prototype.
+ */
 export interface BuildWorkspaceSourceSearchRequest {
     query: string;
     glob?: string;
     max_results?: number;
 }
+/**
+ * @deprecated Retired server-workspace source-search prototype.
+ */
 export interface BuildWorkspaceSourceSearchMatch {
     path: string;
     line: number;
@@ -757,6 +485,9 @@ export interface BuildWorkspaceSourceSearchMatch {
     size_bytes: number;
     sha256: string;
 }
+/**
+ * @deprecated Retired server-workspace source-search prototype.
+ */
 export interface BuildWorkspaceSourceSearchResult {
     workspace_id: string;
     source_path: string;
@@ -770,6 +501,9 @@ export interface BuildWorkspaceSourceSearchResult {
     matches: BuildWorkspaceSourceSearchMatch[];
     updated_at: string;
 }
+/**
+ * @deprecated Retired server-workspace source-patch prototype.
+ */
 export interface BuildWorkspaceSourcePatchFile {
     path: string;
     content_base64?: string;
@@ -777,17 +511,27 @@ export interface BuildWorkspaceSourcePatchFile {
     size_bytes?: number;
     sha256?: string;
 }
+/**
+ * @deprecated Retired server-workspace source-patch prototype. Current Agent
+ * edits local files only; public reports must stay redacted.
+ */
 export interface BuildWorkspaceSourcePatchRequest {
     account_id?: string;
     patch?: string;
     files?: BuildWorkspaceSourcePatchFile[];
 }
+/**
+ * @deprecated Retired server-workspace source-patch prototype.
+ */
 export interface BuildWorkspaceSourcePatchedFile {
     path: string;
     operation: "created" | "updated" | "deleted";
     size_bytes?: number;
     sha256?: string;
 }
+/**
+ * @deprecated Retired server-workspace source-patch prototype.
+ */
 export interface BuildWorkspaceSourcePatchResult {
     workspace_id: string;
     source_path: string;
@@ -795,8 +539,18 @@ export interface BuildWorkspaceSourcePatchResult {
     modified_files: BuildWorkspaceSourcePatchedFile[];
     updated_at: string;
 }
+/**
+ * @deprecated Retired server build execution prototype. Current local Agent
+ * build execution uses local SDK/toolchains, not Cloud workers.
+ */
 export type BuildExecutionMode = "cloud_worker" | "local_bridge" | "dry_run";
+/**
+ * @deprecated Retired server resource-lease prototype.
+ */
 export type BuildResourceLeaseStatus = "active" | "released" | "expired";
+/**
+ * @deprecated Retired server resource-lease prototype.
+ */
 export interface BuildResourceLeaseRequest {
     workspace_id: string;
     account_id?: string;
@@ -806,6 +560,9 @@ export interface BuildResourceLeaseRequest {
     worker_pool?: string;
     purpose?: string;
 }
+/**
+ * @deprecated Retired server resource-lease prototype.
+ */
 export interface BuildResourceLeaseIsolation {
     workspace_path: string;
     source_path: string;
@@ -818,6 +575,9 @@ export interface BuildResourceLeaseIsolation {
     mounts: BuildTemplateDockerMount[];
     resource_limits: BuildTemplateResourceLimits;
 }
+/**
+ * @deprecated Retired server resource-lease prototype.
+ */
 export interface BuildResourceLeaseRecord {
     lease_id: string;
     status: BuildResourceLeaseStatus;
@@ -834,15 +594,30 @@ export interface BuildResourceLeaseRecord {
     expires_at: string;
     released_at?: string;
 }
+/**
+ * @deprecated Retired server resource-lease prototype.
+ */
 export interface BuildResourceLeaseReleaseRequest {
     reason?: string;
 }
+/**
+ * @deprecated Retired server application-build prototype.
+ */
 export interface BuildApplicationStubRequest {
     workspace_id: string;
     account_id?: string;
 }
+/**
+ * @deprecated Retired server application-build prototype.
+ */
 export type BuildApplicationCompileMode = "server_direct" | "docker_worker" | "dry_run";
+/**
+ * @deprecated Retired server application-build prototype.
+ */
 export type BuildApplicationCompiler = "auto" | "cc" | "gcc" | "clang" | "aarch64-linux-gnu-gcc";
+/**
+ * @deprecated Retired server application-build prototype.
+ */
 export interface BuildApplicationCompileRequest {
     workspace_id: string;
     account_id?: string;
@@ -853,75 +628,11 @@ export interface BuildApplicationCompileRequest {
 }
 export type AgentProvider = "stub" | "openai" | "bai" | "claude-code";
 export type AgentProviderInput = AgentProvider | "b.ai" | "cc";
-export type ModelProviderStatus = "available" | "configured" | "not_configured" | "not_implemented";
-export interface ModelProviderSummary {
-    provider: AgentProvider;
-    display_name: string;
-    model: string;
-    status: ModelProviderStatus;
-    default: boolean;
-    supports_tools: boolean;
-    supports_streaming: boolean;
-    notes?: string[];
-}
-export interface ModelCatalog {
-    default_provider: AgentProvider;
-    default_model: string;
-    models: ModelProviderSummary[];
-    observed_at: string;
-}
-export interface ModelDefault {
-    provider: AgentProvider;
-    model: string;
-    status: ModelProviderStatus;
-    observed_at: string;
-}
-export type ServiceModeId = "managed-model-token" | "bring-your-own-model" | "resource-only";
-export type ServiceModeStatus = "available" | "not_configured" | "planned";
-export type ServiceModeModelTokenSource = "embed_labs" | "user" | "none";
-export type ServiceModeMeter = "managed_model_tokens" | "workspace_storage_tokens" | "build_compute_tokens" | "artifact_storage_tokens" | "local_tool_service_tokens" | "subscription";
-export interface ServiceModeSummary {
-    mode: ServiceModeId;
-    display_name: string;
-    status: ServiceModeStatus;
-    default: boolean;
-    model_token_source: ServiceModeModelTokenSource;
-    includes_model_gateway: boolean;
-    includes_server_build_resources: boolean;
-    supports_external_cli_agents: boolean;
-    meters: ServiceModeMeter[];
-    notes?: string[];
-}
-export interface ProductCapabilityPolicy {
-    policy_id: string;
-    display_name: string;
-    access_tier: ProductAccessTier;
-    runtime: "local_bridge" | "cloud_api" | "scheduler_worker" | "hosted" | "mcp";
-    requires_registered_account: boolean;
-    requires_server_workspace: boolean;
-    allocates_server_workspace: boolean;
-    allocates_server_resource_lease: boolean;
-    destructive: boolean;
-    requires_approval: boolean;
-    meters: ServiceModeMeter[];
-    examples?: string[];
-    notes?: string[];
-}
-export interface ServiceModeCatalog {
-    default_mode: ServiceModeId;
-    observed_at: string;
-    modes: ServiceModeSummary[];
-    boundaries: {
-        model_gateway: string;
-        server_resource_orchestration: string;
-        local_bridge: string;
-        free_registered_operations: string;
-        paid_server_operations: string;
-    };
-    allocation_rule: string;
-    free_registered_capabilities: ProductCapabilityPolicy[];
-    paid_capabilities: ProductCapabilityPolicy[];
-}
+/**
+ * @deprecated Retired server application-generation prototype. Current Agent
+ * source generation/editing happens in the user's local project and local
+ * toolchain environment.
+ */
 export interface BuildApplicationGenerateRequest {
     workspace_id: string;
     account_id?: string;
@@ -930,6 +641,10 @@ export interface BuildApplicationGenerateRequest {
     provider?: AgentProviderInput;
     model?: string;
 }
+/**
+ * @deprecated Retired server image-generation prototype. Current image/logo
+ * composition and flashing are local Agent and GoLocalBridge workflows.
+ */
 export interface BuildImageGenerateRequest {
     workspace_id: string;
     account_id?: string;
@@ -940,6 +655,10 @@ export interface BuildImageGenerateRequest {
     execution_mode?: BuildExecutionMode;
     worker_pool?: string;
 }
+/**
+ * @deprecated Retired Cloud task creation prototype. Current public Agent
+ * tasks run through the local Native Agent action layer.
+ */
 export interface AgentTaskCreateRequest {
     prompt: string;
     project_id?: string;
@@ -1073,12 +792,11 @@ export interface ToolCapabilitySummary {
     destructive: boolean;
     requires_approval: boolean;
     access_tier?: ProductAccessTier;
-    free_for_registered_users?: boolean;
-    requires_registered_account?: boolean;
+    uses_local_installation_identity?: boolean;
     requires_server_workspace?: boolean;
     allocates_server_workspace?: boolean;
     allocates_server_resource_lease?: boolean;
-    meters?: ServiceModeMeter[];
+    meters?: CapabilityMeter[];
     status?: "available" | "planned";
     input_schema: Record<string, unknown>;
 }
@@ -1098,10 +816,10 @@ export interface ToolInvokeResult {
 }
 export interface AgentLocalToolRunRequest {
     prompt: string;
-    account_id?: string;
+    local_installation_id?: string;
     client_device_id?: string;
     local_device_id?: string;
-    workspace_id?: string;
+    local_project_id?: string;
     provider?: AgentProviderInput;
     model?: string;
     max_tool_calls?: number;
@@ -1118,13 +836,10 @@ export interface AgentLocalToolCall {
 export interface AgentLocalToolPlan {
     plan_id: string;
     request_id: string;
-    account_id?: string;
-    api_key_id?: string;
+    local_installation_id?: string;
     client_device_id?: string;
     local_device_id?: string;
-    /** @deprecated Use client_device_id for account_devices rows. */
-    device_id?: string;
-    workspace_id?: string;
+    local_project_id?: string;
     provider: AgentProvider;
     model: string;
     prompt: string;
@@ -1144,8 +859,8 @@ export interface AgentLocalToolResultItem {
 export interface AgentLocalToolCompleteRequest {
     plan_id: string;
     prompt: string;
-    account_id?: string;
-    workspace_id?: string;
+    local_installation_id?: string;
+    local_project_id?: string;
     provider?: AgentProviderInput;
     model?: string;
     tool_results: AgentLocalToolResultItem[];
@@ -1163,7 +878,7 @@ export interface AgentLocalToolCompleteResult {
     created_at: string;
 }
 export type DoctorCheckStatus = "ready" | "not_ready" | "unreachable" | "warning";
-export type DoctorCheckId = "cli_runtime" | "auth" | "bridge_health" | "device_scan" | "debug_tools" | "cloud_api_health" | (string & {});
+export type DoctorCheckId = "cli_runtime" | "installation_identity" | "agent_persistence" | "model_config" | "bridge_health" | "ide_plugins" | "device_scan" | "debug_tools" | "cloud_api_health" | (string & {});
 export interface DoctorCheck<T = unknown> {
     id: DoctorCheckId;
     label: string;
@@ -1246,7 +961,7 @@ export interface FlashRunRequest extends FlashPlanRequest {
     approved: boolean;
 }
 export interface BootLogoPackageRequest {
-    account_id?: string;
+    local_installation_id?: string;
     project_id?: string;
     board_id: string;
     variant_id?: string;
@@ -1261,7 +976,7 @@ export interface BootLogoPackageRequest {
 }
 export interface BootLogoPackageResult {
     task_id: string;
-    account_id: string;
+    local_installation_id?: string;
     project_id: string;
     board_id: string;
     variant_id?: string;
@@ -1274,14 +989,14 @@ export interface BootLogoPackageResult {
     server_generated: true;
     requires_server_workspace: false;
     allocates_server_resource_lease: false;
-    free_for_registered_users: true;
+    uses_local_installation_identity: true;
     local_merge_required: true;
     full_image_download_required: false;
     observed_at: string;
     summary_for_user: string;
 }
 export interface DtbPackageRequest {
-    account_id?: string;
+    local_installation_id?: string;
     project_id?: string;
     board_id: string;
     variant_id?: string;
@@ -1292,7 +1007,7 @@ export interface DtbPackageRequest {
 }
 export interface DtbPackageResult {
     task_id: string;
-    account_id: string;
+    local_installation_id?: string;
     project_id: string;
     board_id: string;
     variant_id?: string;
@@ -1305,7 +1020,7 @@ export interface DtbPackageResult {
     server_generated: true;
     requires_server_workspace: false;
     allocates_server_resource_lease: false;
-    free_for_registered_users: true;
+    uses_local_installation_identity: true;
     local_merge_required: true;
     full_image_download_required: false;
     observed_at: string;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmsDA,MAAM,UAAU,EAAE,CAAI,IAAO;IAC3B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAe,EAAE,UAAmD,EAAE;IACvG,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA63CA,MAAM,UAAU,EAAE,CAAI,IAAO;IAC3B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,OAAe,EAAE,UAAmD,EAAE;IACvG,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC;AAC7D,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kvell007/embed-labs-protocol",
-  "version": "0.1.0-alpha.97",
-  "description": "Shared TypeScript protocol contracts for Embed Labs Cloud. Experimental npm publish.",
+  "version": "0.1.0-alpha.99",
+  "description": "Shared TypeScript protocol contracts for EmbedLabs local Agent and server infrastructure. Experimental npm publish.",
   "private": false,
   "type": "module",
   "main": "dist/index.js",