@kvell007/embed-labs-protocol 0.1.0-alpha.9 → 0.1.0-alpha.90

package/README.md

@@ -62,10 +62,10 @@ and validation matrix types are not hardware support claims by themselves.
 Hardware detection, probing, and guarded flash behavior live in
 `@embed-labs/local-bridge`.
 
-Destructive TaishanPi flashing is not enabled by these contracts. The current
-local bridge can produce guarded planning evidence, but real TaishanPi flashing
-remains blocked until the relevant hardware profile and Board Pack command
-templates are accepted.
+Destructive TaishanPi flashing is enabled only by the Local Bridge guarded
+runtime, not by these contracts alone. The bridge validates the installed SDK
+image set, resolves `parameter.txt` offsets, and requires explicit user
+approval before executing `rkdeveloptool`.
 
 ## Runtime Requirements
 

package/dist/index.d.ts

@@ -51,6 +51,7 @@ export interface BoardDeployRequest {
     user?: string;
     artifact_path: string;
     remote_path?: string;
+    run_command?: string;
     run?: boolean;
     timeout_seconds?: number;
     approved?: boolean;
@@ -120,6 +121,7 @@ export interface AccountStatus {
     account_id: string;
     email: string;
     display_name?: string;
+    device_limit?: number;
     created_at: string;
     updated_at: string;
 }
@@ -138,12 +140,16 @@ export type AuthContextInfo = {
     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;
@@ -159,6 +165,10 @@ 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;
@@ -172,6 +182,10 @@ export interface TokenUsageRecord {
 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;
@@ -186,6 +200,10 @@ export interface McpToolEventRecord {
     account_id?: string;
     user_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;
     client: string;
     tool_name: string;
     mode: string;
@@ -200,6 +218,10 @@ export interface McpToolEventRecord {
 }
 export interface McpToolEventCreateRequest {
     account_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;
     client?: string;
     tool_name: string;
     mode?: string;
@@ -212,6 +234,45 @@ 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;
@@ -518,7 +579,24 @@ export interface BoardKnowledgeFile {
     content_base64: string;
     observed_at: string;
 }
-export type BoardServerMethodOperation = "workspace.provision" | "source.list" | "source.read" | "source.write" | "app.build" | "app.compile" | "image.build" | "artifact.download" | "workspace.release";
+export interface BoardKnowledgeSearchMatch {
+    source: BoardKnowledgeSource;
+    path: string;
+    title: string;
+    content_type: string;
+    sha256: string;
+    score: number;
+    excerpt: string;
+}
+export interface BoardKnowledgeSearchResult {
+    template_id: string;
+    board_id: string;
+    variant_id: string;
+    query: string;
+    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 interface BoardServerMethodSummary {
     method_id: string;
@@ -869,7 +947,7 @@ export interface AgentTaskCreateRequest {
     kind?: string;
 }
 export interface DeviceLocator {
-    transport: "usb" | "serial" | "ssh" | "usbecm" | "uf2-volume" | "rockusb" | "unknown";
+    transport: "usb" | "serial" | "tcp" | "ssh" | "usbecm" | "uf2-volume" | "rockusb" | "unknown";
     path?: string;
     host?: string;
     port?: number;
@@ -895,6 +973,7 @@ export interface SerialPortInfo {
 }
 export interface DeviceSummary {
     device_id: string;
+    local_device_id?: string;
     board_id?: string;
     variant_id?: string;
     hardware_profile_id?: string;
@@ -984,7 +1063,7 @@ export interface DebugToolScanResult {
     warnings?: ErrorEnvelope[];
 }
 export type ToolRuntime = "local_bridge" | "cloud" | "mcp" | "hosted";
-export type ToolCapabilityId = "debug.tools.scan" | "device.scan" | "device.probe" | "wifi.scan" | "bluetooth.scan" | "chip.cpu.frequency" | "chip.temperature" | "qml.runtime.status" | "qml.runtime.start" | "flash.plan" | "flash.run" | "taishanpi.deploy" | (string & {});
+export type ToolCapabilityId = "debug.tools.scan" | "device.scan" | "device.probe" | "wifi.scan" | "bluetooth.scan" | "chip.cpu.frequency" | "chip.temperature" | "qml.runtime.status" | "qml.runtime.start" | "rp2350.monitor.capabilities" | "rp2350.monitor.status" | "rp2350.monitor.operation" | "rp2350.monitor.gpio.read" | "rp2350.monitor.gpio.write" | "rp2350.monitor.uart.write" | "rp2350.monitor.i2c.transfer" | "rp2350.monitor.logic.capture" | "rp2350.monitor.logic.decode" | "rp2350.monitor.spi.transfer" | "rp2350.monitor.wifi.manage" | "rp2350.monitor.probe.debug" | "rp2350.monitor.command" | "flash.plan" | "flash.run" | "taishanpi.deploy" | (string & {});
 export interface ToolCapabilitySummary {
     capability_id: ToolCapabilityId;
     display_name: string;
@@ -1020,6 +1099,8 @@ export interface ToolInvokeResult {
 export interface AgentLocalToolRunRequest {
     prompt: string;
     account_id?: string;
+    client_device_id?: string;
+    local_device_id?: string;
     workspace_id?: string;
     provider?: AgentProviderInput;
     model?: string;
@@ -1038,6 +1119,11 @@ export interface AgentLocalToolPlan {
     plan_id: string;
     request_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;
     workspace_id?: string;
     provider: AgentProvider;
     model: string;

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kvell007/embed-labs-protocol",
-  "version": "0.1.0-alpha.9",
+  "version": "0.1.0-alpha.90",
   "description": "Shared TypeScript protocol contracts for Embed Labs Cloud. Experimental npm publish.",
   "private": false,
   "type": "module",