buckyos 0.7.138 → 0.7.142

package/cli/modules/aiws.ts

@@ -0,0 +1,294 @@
+import type { CommandDefinition, CommandModule, JsonSchema, OptionDefinition, PositionalDefinition } from '../core/command.ts'
+import type { CommandContext } from '../core/context.ts'
+import { ToolError, UsageError } from '../core/errors.ts'
+import { callService, expectObject, inputString, requiredInputString } from '../core/service.ts'
+import { getHost } from '../runtime/host.ts'
+
+// AI Workspace (`/kapi/aiworkspace`): reading a workspace, and the executor protocol of a wish run
+// (内核架构改进 M3): claim → heartbeat → report. Source of truth for the methods:
+// buckyos/src/frame/aiworkspace/README.md (Protocol).
+const SERVICE = 'aiworkspace'
+const OBJECT_OUTPUT: JsonSchema = { type: 'object', additionalProperties: true }
+const WORKSPACE_OPTION: OptionDefinition = { name: 'workspace', property: 'workspace_id', description: 'Workspace id (ws_…)', type: 'string', required: true }
+const RUN_OPTION: OptionDefinition = { name: 'run', property: 'run_id', description: 'Run id (run_…)', type: 'string', required: true }
+const ATTEMPT_OPTION: OptionDefinition = { name: 'attempt', property: 'attempt', description: 'The attempt number `run-claim` answered', type: 'integer', required: true }
+
+function workspaceInput(extra: Record<string, JsonSchema>, required: string[] = []): JsonSchema {
+  return { type: 'object', properties: { workspace_id: { type: 'string', minLength: 1 }, ...extra }, required: ['workspace_id', ...required], additionalProperties: false }
+}
+
+async function aiws(ctx: CommandContext, method: string, params: Record<string, unknown>): Promise<Record<string, unknown>> {
+  const result = expectObject(await callService<unknown>(ctx, SERVICE, method, params), method)
+  if (result.ok === false) {
+    const error = expectObject(result.error, `${method}.error`)
+    const code = typeof error.code === 'string' ? error.code : 'AIWS_ERROR'
+    const detail = typeof error.detail === 'string' ? error.detail : code
+    throw new ToolError(code, `${code}${typeof error.sub_code === 'string' ? `/${error.sub_code}` : ''}: ${detail}`)
+  }
+  return result
+}
+
+async function jsonInput(input: Record<string, unknown>, textKey: string, fileKey: string, label: string): Promise<unknown> {
+  const text = inputString(input, textKey)
+  const file = inputString(input, fileKey)
+  if (text && file) throw new UsageError('AIWS_USAGE', `${textKey} and ${fileKey} are exclusive`)
+  if (file) return JSON.parse(await getHost().readTextFile(file)) as unknown
+  if (text) return JSON.parse(text) as unknown
+  throw new UsageError('AIWS_USAGE', `${label}: pass --${textKey.replace(/_/g, '-')} or --${fileKey.replace(/_/g, '-')}`)
+}
+
+const readCommand: CommandDefinition = {
+  verb: 'read',
+  summary: 'Read one entity of a workspace (envelope and content)',
+  positionals: [{ name: 'entity_id', description: 'Entity id', required: true } satisfies PositionalDefinition],
+  options: [WORKSPACE_OPTION, { name: 'selector', property: 'selector', description: 'Selector JSON, e.g. {"kind":"table_record","record_id":"r1"}', type: 'string' }],
+  inputSchema: workspaceInput({ entity_id: { type: 'string', minLength: 1 }, selector: { type: 'string' } }, ['entity_id']),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'read' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws read orders --workspace ws_abc'],
+  handler: (ctx, input) => {
+    const selector = inputString(input, 'selector')
+    return aiws(ctx, 'doc.read', { workspace_id: requiredInputString(input, 'workspace_id'), entity_id: requiredInputString(input, 'entity_id'), ...(selector ? { selector: JSON.parse(selector) } : {}) })
+  },
+}
+
+const queryCommand: CommandDefinition = {
+  verb: 'query',
+  summary: 'Query the rows of a table (or through a saved view)',
+  options: [
+    WORKSPACE_OPTION,
+    { name: 'source', property: 'source_id', description: 'Table entity id', type: 'string' },
+    { name: 'view', property: 'view_id', description: 'Table view (Block) id', type: 'string' },
+    { name: 'filter', property: 'filter', description: 'Filter JSON (README: doc.query)', type: 'string' },
+    { name: 'limit', property: 'limit', description: 'Rows per page (≤ 1000)', type: 'integer' },
+    { name: 'cursor', property: 'cursor', description: 'Continue from a previous page', type: 'string' },
+  ],
+  inputSchema: workspaceInput({ source_id: { type: 'string' }, view_id: { type: 'string' }, filter: { type: 'string' }, limit: { type: 'integer' }, cursor: { type: 'string' } }),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'read' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws query --workspace ws_abc --source orders --limit 100'],
+  handler: (ctx, input) => {
+    const params: Record<string, unknown> = { workspace_id: requiredInputString(input, 'workspace_id') }
+    for (const key of ['source_id', 'view_id', 'cursor']) { const value = inputString(input, key); if (value) params[key] = value }
+    const filter = inputString(input, 'filter')
+    if (filter) params.filter = JSON.parse(filter)
+    if (typeof input.limit === 'number') params.limit = input.limit
+    if (!params.source_id && !params.view_id) throw new UsageError('AIWS_USAGE', 'pass --source or --view')
+    return aiws(ctx, 'doc.query', params)
+  },
+}
+
+const infoCommand: CommandDefinition = {
+  verb: 'info',
+  summary: 'Workspace info: versions, capabilities of the caller, usage, hosted execution configuration',
+  options: [WORKSPACE_OPTION],
+  inputSchema: workspaceInput({}),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'read' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws info --workspace ws_abc'],
+  handler: (ctx, input) => aiws(ctx, 'ws.get_info', { workspace_id: requiredInputString(input, 'workspace_id') }),
+}
+
+const runGetCommand: CommandDefinition = {
+  verb: 'run-get',
+  summary: 'A wish run: state, execution context, the brief an executor starts from, candidate and preview',
+  options: [WORKSPACE_OPTION, RUN_OPTION],
+  inputSchema: workspaceInput({ run_id: { type: 'string', minLength: 1 } }, ['run_id']),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'read' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws run-get --workspace ws_abc --run run_xyz'],
+  handler: (ctx, input) => aiws(ctx, 'proc.get', { workspace_id: requiredInputString(input, 'workspace_id'), run_id: requiredInputString(input, 'run_id') }),
+}
+
+const runClaimCommand: CommandDefinition = {
+  verb: 'run-claim',
+  summary: 'Take a run as its executor: starts an attempt, answers the attempt number, a run token and the lease',
+  options: [WORKSPACE_OPTION, RUN_OPTION, { name: 'claim-token', property: 'claim_token', description: 'The claim token the run was dispatched with (ct_…)', type: 'string', required: true, secret: true }],
+  inputSchema: workspaceInput({ run_id: { type: 'string', minLength: 1 }, claim_token: { type: 'string', minLength: 1 } }, ['run_id', 'claim_token']),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'write' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws run-claim --workspace ws_abc --run run_xyz --claim-token ct_…'],
+  handler: (ctx, input) => aiws(ctx, 'proc.claim', {
+    workspace_id: requiredInputString(input, 'workspace_id'), run_id: requiredInputString(input, 'run_id'), claim_token: requiredInputString(input, 'claim_token'),
+    executor: { kind: 'agent', principal: ctx.principal.id },
+  }),
+}
+
+const runHeartbeatCommand: CommandDefinition = {
+  verb: 'run-heartbeat',
+  summary: 'Keep the lease of a claimed run alive (every minute while working); optionally report progress',
+  options: [WORKSPACE_OPTION, RUN_OPTION, ATTEMPT_OPTION, { name: 'phase', property: 'phase', description: 'A short progress phase, e.g. "reading inputs"', type: 'string' }],
+  inputSchema: workspaceInput({ run_id: { type: 'string', minLength: 1 }, attempt: { type: 'integer', minimum: 1 }, phase: { type: 'string' } }, ['run_id', 'attempt']),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'write' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws run-heartbeat --workspace ws_abc --run run_xyz --attempt 1 --phase "reading inputs"'],
+  handler: (ctx, input) => {
+    const phase = inputString(input, 'phase')
+    return aiws(ctx, 'proc.heartbeat', { workspace_id: requiredInputString(input, 'workspace_id'), run_id: requiredInputString(input, 'run_id'), attempt: input.attempt, ...(phase ? { progress: { phase } } : {}) })
+  },
+}
+
+const runFilesCommand: CommandDefinition = {
+  verb: 'run-files',
+  summary: 'Write the stage of a claimed run into a directory: the snapshot (context/), request.json, the Renderer catalog and the program host (lib/)',
+  description: 'Run the program there the way the service does: `deno run -A lib/run.js` reads program/main.js and writes output/.aiws/results.json.',
+  options: [WORKSPACE_OPTION, RUN_OPTION, ATTEMPT_OPTION, { name: 'dir', property: 'dir', description: 'Directory to write into (created)', type: 'string', required: true }],
+  inputSchema: workspaceInput({ run_id: { type: 'string', minLength: 1 }, attempt: { type: 'integer', minimum: 1 }, dir: { type: 'string', minLength: 1 } }, ['run_id', 'attempt', 'dir']),
+  outputSchema: { type: 'object', properties: { dir: { type: 'string' }, files: { type: 'array', items: { type: 'string' } } }, required: ['dir', 'files'], additionalProperties: true },
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'read' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws run-files --workspace ws_abc --run run_xyz --attempt 1 --dir work'],
+  handler: async (ctx, input) => {
+    const result = await aiws(ctx, 'proc.files', { workspace_id: requiredInputString(input, 'workspace_id'), run_id: requiredInputString(input, 'run_id'), attempt: input.attempt })
+    const dir = requiredInputString(input, 'dir')
+    const host = getHost()
+    const written: string[] = []
+    for (const [path, file] of Object.entries(expectObject(result.files, 'proc.files.files'))) {
+      const f = expectObject(file, path)
+      if (typeof f.text !== 'string' && typeof f.base64 !== 'string') continue
+      const target = `${dir}/${path}`
+      await host.mkdir(target.slice(0, target.lastIndexOf('/')), { recursive: true })
+      if (typeof f.text === 'string') await host.writeTextFile(target, f.text)
+      else await host.writeFile(target, Uint8Array.from(atob(f.base64 as string), (c) => c.charCodeAt(0)))
+      written.push(path)
+    }
+    await host.mkdir(`${dir}/output`, { recursive: true })
+    await host.mkdir(`${dir}/program`, { recursive: true })
+    return { dir, files: written }
+  },
+}
+
+const runToolCommand: CommandDefinition = {
+  verb: 'run-tool',
+  summary: 'Call one stage tool of a claimed run (ws_profile, ws_read, ws_query, submit_analysis, put_result, check_results, finish, …): the service answers as it answers the model',
+  options: [WORKSPACE_OPTION, RUN_OPTION, ATTEMPT_OPTION, { name: 'name', property: 'name', description: 'Tool name (the claim answered the list, with their argument schemas)', type: 'string', required: true }, { name: 'args', property: 'args', description: 'Arguments JSON', type: 'string' }, { name: 'args-file', property: 'args_file', description: 'Path of a JSON file holding the arguments', type: 'string' }],
+  inputSchema: workspaceInput({ run_id: { type: 'string', minLength: 1 }, attempt: { type: 'integer', minimum: 1 }, name: { type: 'string', minLength: 1 }, args: { type: 'string' }, args_file: { type: 'string' } }, ['run_id', 'attempt', 'name']),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'write' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws run-tool --workspace ws_abc --run run_xyz --attempt 1 --name ws_profile --args \'{"target":"@B1"}\'', 'buckyos aiws run-tool --workspace ws_abc --run run_xyz --attempt 1 --name finish --args \'{"summary":"done"}\''],
+  handler: async (ctx, input) => {
+    const args = inputString(input, 'args') || inputString(input, 'args_file') ? await jsonInput(input, 'args', 'args_file', 'arguments') : {}
+    return aiws(ctx, 'proc.tool', { workspace_id: requiredInputString(input, 'workspace_id'), run_id: requiredInputString(input, 'run_id'), attempt: input.attempt, name: requiredInputString(input, 'name'), args })
+  },
+}
+
+const runProgramCommand: CommandDefinition = {
+  verb: 'run-program',
+  summary: 'Hand in a program run: the program source, what lib/run.js wrote to output/.aiws/results.json, the files under output/ and the log; the service validates it like its own run_program',
+  options: [
+    WORKSPACE_OPTION, RUN_OPTION, ATTEMPT_OPTION,
+    { name: 'dir', property: 'dir', description: 'The stage directory written by run-files (program/main.js, output/)', type: 'string', required: true },
+    { name: 'log-file', property: 'log_file', description: 'Path of the program log to attach (stdout/stderr of deno run)', type: 'string' },
+  ],
+  inputSchema: workspaceInput({ run_id: { type: 'string', minLength: 1 }, attempt: { type: 'integer', minimum: 1 }, dir: { type: 'string', minLength: 1 }, log_file: { type: 'string' } }, ['run_id', 'attempt', 'dir']),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'write' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: ['buckyos aiws run-program --workspace ws_abc --run run_xyz --attempt 1 --dir work --log-file work/run.log'],
+  handler: async (ctx, input) => {
+    const dir = requiredInputString(input, 'dir')
+    const host = getHost()
+    const source = await host.readTextFile(`${dir}/program/main.js`)
+    let results: unknown = null
+    try { results = JSON.parse(await host.readTextFile(`${dir}/output/.aiws/results.json`)) } catch { results = null }
+    const logFile = inputString(input, 'log_file')
+    const log = logFile ? await host.readTextFile(logFile).catch(() => '') : ''
+    const files: Record<string, unknown> = {}
+    const walk = async (rel: string) => {
+      for (const entry of await host.readDir(`${dir}/output${rel ? `/${rel}` : ''}`)) {
+        const name = rel ? `${rel}/${entry.name}` : entry.name
+        if (name === '.aiws' || name.startsWith('.aiws/')) continue
+        if (entry.isDirectory) await walk(name)
+        else {
+          const bytes = await host.readFile(`${dir}/output/${name}`)
+          let text: string | null = null
+          try { text = bytes.includes(0) ? null : new TextDecoder('utf-8', { fatal: true }).decode(bytes) } catch { text = null }
+          files[`output/${name}`] = text ?? { base64: btoa(Array.from(bytes, (b) => String.fromCharCode(b)).join('')) }
+        }
+      }
+    }
+    await walk('')
+    return aiws(ctx, 'proc.program', { workspace_id: requiredInputString(input, 'workspace_id'), run_id: requiredInputString(input, 'run_id'), attempt: input.attempt, source, results, log, files })
+  },
+}
+
+const runReportCommand: CommandDefinition = {
+  verb: 'run-report',
+  summary: 'End a claimed run: --finished after the stage tools accepted the work (submit_analysis / finish), or the candidate itself (results / analysis), or a failure',
+  description: 'The service validates and plans what is reported; the user confirms it in the workspace. A superseded attempt or a cancelled run gets RUN_REVOKED.',
+  options: [
+    WORKSPACE_OPTION, RUN_OPTION, ATTEMPT_OPTION,
+    { name: 'finished', property: 'finished', description: 'The stage is done: what the tools collected becomes the candidate', type: 'boolean' },
+    { name: 'results', property: 'results', description: 'Results JSON array (execute runs): [{ name, type, title?, content, config? }]', type: 'string' },
+    { name: 'results-file', property: 'results_file', description: 'Path of a JSON file holding the results array', type: 'string' },
+    { name: 'analysis', property: 'analysis', description: 'Analysis JSON (analyze runs, wish.analysis.v2)', type: 'string' },
+    { name: 'analysis-file', property: 'analysis_file', description: 'Path of a JSON file holding the analysis', type: 'string' },
+    { name: 'summary', property: 'summary', description: 'One paragraph on what was done', type: 'string' },
+    { name: 'warning', property: 'warnings', description: 'A warning for the user (repeatable)', type: 'string' },
+    { name: 'error', property: 'error', description: 'Report a failure instead: its reason', type: 'string' },
+  ],
+  inputSchema: workspaceInput({ run_id: { type: 'string', minLength: 1 }, attempt: { type: 'integer', minimum: 1 }, finished: { type: 'boolean' }, results: { type: 'string' }, results_file: { type: 'string' }, analysis: { type: 'string' }, analysis_file: { type: 'string' }, summary: { type: 'string' }, warnings: { type: 'string' }, error: { type: 'string' } }, ['run_id', 'attempt']),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: 'fixed', level: 'write' },
+  asyncMode: 'sync',
+  requiresSession: true,
+  examples: [
+    'buckyos aiws run-report --workspace ws_abc --run run_xyz --attempt 1 --finished',
+    'buckyos aiws run-report --workspace ws_abc --run run_xyz --attempt 1 --results-file out/results.json --summary "monthly totals and a commentary"',
+    'buckyos aiws run-report --workspace ws_abc --run run_xyz --attempt 1 --analysis-file out/analysis.json',
+    'buckyos aiws run-report --workspace ws_abc --run run_xyz --attempt 1 --error "the input table is empty"',
+  ],
+  handler: async (ctx, input) => {
+    const params: Record<string, unknown> = { workspace_id: requiredInputString(input, 'workspace_id'), run_id: requiredInputString(input, 'run_id'), attempt: input.attempt }
+    const error = inputString(input, 'error')
+    if (error) {
+      params.error = { code: 'EXECUTOR_FAILED', detail: error }
+    } else if (input.finished === true) {
+      params.finished = true
+    } else if (inputString(input, 'analysis') || inputString(input, 'analysis_file')) {
+      params.analysis = await jsonInput(input, 'analysis', 'analysis_file', 'an analysis')
+    } else {
+      params.results = await jsonInput(input, 'results', 'results_file', 'results')
+      params.read_set = []
+    }
+    const summary = inputString(input, 'summary')
+    if (summary) params.summary = summary
+    const warning = inputString(input, 'warnings')
+    if (warning) params.warnings = [warning]
+    return aiws(ctx, 'proc.report', params)
+  },
+}
+
+export function createAiwsModule(): CommandModule {
+  return {
+    name: 'aiws',
+    summary: 'AI Workspace: read a workspace, and execute wish runs as their executor (claim, heartbeat, report)',
+    commands: [infoCommand, readCommand, queryCommand, runGetCommand, runClaimCommand, runHeartbeatCommand, runFilesCommand, runToolCommand, runProgramCommand, runReportCommand],
+  }
+}

package/cli/modules/executor.ts

@@ -0,0 +1,98 @@
+import { ExecutorCommandStream } from 'buckyos/node'
+import type { CommandDefinition, CommandModule, JsonSchema } from '../core/command.ts'
+import type { CommandContext } from '../core/context.ts'
+import { ToolError } from '../core/errors.ts'
+import { getHost } from '../runtime/host.ts'
+
+const text = { type: 'string' as const, minLength: 1 }
+type ExecutorRoute = Parameters<typeof ExecutorCommandStream.connect>[0]
+type ExecutorOperationLocator = Parameters<InstanceType<typeof ExecutorCommandStream>['query']>[0]
+const object = { type: 'object' as const, additionalProperties: true }
+const targetProperties = {
+  executor_id: text, generation: { type: 'integer' as const, minimum: 1 },
+  profile_id: text, store_id: text, locator: text,
+}
+
+function call<T>(ctx: CommandContext, method: string, params: Record<string, unknown>): Promise<T> {
+  return ctx.clients.call('control-panel', method, params, {
+    traceId: ctx.traceId, signal: ctx.signal, timeoutMs: Math.max(1, (ctx.deadline ?? Date.now() + 30000) - Date.now()),
+  })
+}
+
+function management(verb: string, method: string, properties: Record<string, JsonSchema>, required: string[], write = false): CommandDefinition {
+  return {
+    verb, summary: `Executor ${verb}`, inputSchema: { ...object, properties, required, additionalProperties: false },
+    outputSchema: object, resultSchemaVersion: 1, access: { mode: 'fixed', level: write ? 'write' : 'read' },
+    asyncMode: 'sync', requiresSession: true,
+    options: Object.entries(properties).filter(([, schema]) => schema.type !== 'object').map(([name, schema]) => ({
+      name: name.replaceAll('_', '-'), property: name, description: name, type: schema.type === 'integer' ? 'integer' as const : 'string' as const,
+      required: required.includes(name),
+    })),
+    handler: (ctx, input) => call(ctx, method, input),
+  }
+}
+
+export function createExecutorModule(): CommandModule {
+  return {
+    name: 'executor', summary: 'Manage lightweight devices and explicitly target online command/file executors',
+    commands: [
+      management('create', 'executor.device.create', { name: text, profiles: object, limits: object, expires_at_ms: { type: 'integer' } }, ['name', 'profiles'], true),
+      management('list', 'executor.device.list', {}, []),
+      management('issue', 'executor.device.issue', { executor_id: text, expires_at_ms: { type: 'integer' } }, ['executor_id'], true),
+      management('revoke', 'executor.device.revoke', { executor_id: text }, ['executor_id'], true),
+      management('delete', 'executor.device.delete', { executor_id: text }, ['executor_id'], true),
+      management('online', 'executor.online.list', {}, []),
+      operation('exec', { cmd: text, cwd: text, env: object, execution_timeout_ms: { type: 'integer', minimum: 1 } }, ['cmd', 'cwd']),
+      operation('read', { path: text }, ['path']),
+      operation('write', { path: text, content: { type: 'string' }, mode: { type: 'string', enum: ['replace', 'append', 'create_new'] } }, ['path', 'content']),
+      operation('edit', { path: text, old_string: text, new_string: { type: 'string' } }, ['path', 'old_string', 'new_string']),
+      operation('query', { channel: { type: 'string', enum: ['stdout', 'stderr', 'content'] }, offset: { type: 'integer', minimum: 0 }, wait_ms: { type: 'integer', minimum: 0 } }, []),
+      operation('cancel', {}, []),
+    ],
+  }
+}
+
+function operation(verb: string, extra: Record<string, JsonSchema>, required: string[]): CommandDefinition {
+  const recovery = verb === 'query' || verb === 'cancel'
+  const properties: Record<string, JsonSchema> = { ...targetProperties, ...extra }
+  return {
+    verb, summary: `${verb} on an explicit executor; persist --locator before dispatch and query it after disconnection`,
+    inputSchema: { ...object, properties, required: [...Object.keys(targetProperties), ...required], additionalProperties: false },
+    outputSchema: object, resultSchemaVersion: 1,
+    access: { mode: 'fixed', level: ['read', 'query'].includes(verb) ? 'read' : 'write' },
+    asyncMode: 'sync', requiresSession: true,
+    options: Object.entries(properties).filter(([, schema]) => schema.type !== 'object').map(([name, schema]) => ({
+      name: name.replaceAll('_', '-'), property: name, description: name,
+      type: schema.type === 'integer' ? 'integer' as const : 'string' as const,
+      required: Object.keys(targetProperties).includes(name) || required.includes(name),
+    })),
+    handler: async (ctx, input) => {
+      const target = { executor_id: String(input.executor_id), generation: Number(input.generation), profile_id: String(input.profile_id), store_id: String(input.store_id) }
+      const path = String(input.locator)
+      const host = getHost()
+      let locator: ExecutorOperationLocator
+      if (recovery) locator = JSON.parse(await host.readTextFile(path))
+      else {
+        locator = { ...target, op_id: crypto.randomUUID(), run_id: ctx.traceId, call_id: ctx.idempotencyKey ?? crypto.randomUUID() }
+        await host.writeTextFile(path, JSON.stringify(locator) + '\n', { createNew: true, mode: 0o600 })
+      }
+      if (!ctx.session) throw new ToolError('AUTH_REQUIRED', 'An authenticated App session is required')
+      const { token } = await ctx.session.ensureValid()
+      const route = await call<ExecutorRoute>(ctx, 'executor.stream.open', { executor_id: target.executor_id, generation: target.generation, profile_id: target.profile_id })
+      const stream = await ExecutorCommandStream.connect(route, target, token, 'buckyos-cli', locator.run_id)
+      if (!stream) throw new ToolError('INVALID_SERVICE_RESPONSE', 'Executor stream did not initialize')
+      const abort = () => stream.close()
+      ctx.signal.addEventListener('abort', abort, { once: true })
+      try {
+        let reply
+        if (verb === 'exec') reply = await stream.exec(locator, String(input.cmd), String(input.cwd), (input.env ?? {}) as Record<string, string>, Number(input.execution_timeout_ms ?? 60000))
+        else if (verb === 'read') reply = await stream.read(locator, String(input.path))
+        else if (verb === 'write') reply = await stream.write(locator, String(input.path), new TextEncoder().encode(String(input.content)), (input.mode ?? 'replace') as 'replace' | 'append' | 'create_new')
+        else if (verb === 'edit') reply = await stream.edit(locator, String(input.path), [{ old_string: String(input.old_string), new_string: String(input.new_string) }])
+        else if (verb === 'cancel') reply = await stream.cancel(locator)
+        else reply = await stream.query(locator, input.channel as 'stdout' | 'stderr' | 'content' | undefined, Number(input.offset ?? 0), Number(input.wait_ms ?? 0))
+        return { locator, reply }
+      } finally { ctx.signal.removeEventListener('abort', abort); stream.close() }
+    },
+  }
+}

package/cli/version.ts

@@ -1,5 +1,5 @@
 // Generated by scripts/generate-cli-version.mjs. Do not edit.
-export const PACKAGE_VERSION = '0.7.138'
+export const PACKAGE_VERSION = '0.7.142'
 export const TOOL_VERSION = PACKAGE_VERSION
 export const SDK_VERSION = PACKAGE_VERSION
 export const PROTOCOL_VERSION = '1'

package/dist/account.d.ts

@@ -16,7 +16,6 @@ export interface BrowserUserInfo {
     /** Zone account type as verify-hub returned it; see `ZoneUserType`. */
     user_type: string;
 }
-export declare const LOGIN_EVENT = "onLogin";
 export declare function hashPassword(username: string, password: string, nonce?: number | null): string;
 export declare function cleanLocalAccountInfo(appId: string): void;
 export declare function saveLocalAccountInfo(appId: string, account_info: AccountInfo): void;
@@ -27,5 +26,4 @@ export declare function clearBrowserUserInfo(): void;
 export declare function saveBrowserIdentity(identity: unknown): void;
 export declare function getBrowserIdentityRaw(): unknown;
 export declare function clearBrowserIdentity(): void;
-export declare function getLocalAccountInfo(appId: string): AccountInfo | null;
 //# sourceMappingURL=account.d.ts.map

package/dist/account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACrB;AAyED,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,wBAAgB,YAAY,CAAC,QAAQ,EAAC,MAAM,EAAC,QAAQ,EAAC,MAAM,EAAC,KAAK,GAAC,MAAM,GAAC,IAAS,GAAE,MAAM,CAY1F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAC,MAAM,QAiBjD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAC,MAAM,EAAE,YAAY,EAAC,WAAW,QAe1E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAC,eAAe,QAE3D;AAED,wBAAgB,kBAAkB,IAAG,eAAe,GAAC,IAAI,CAExD;AAED,wBAAgB,oBAAoB,SAEnC;AAED,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,QAAQ,EAAC,OAAO,QAEnD;AAED,wBAAgB,qBAAqB,IAAG,OAAO,CAU9C;AAED,wBAAgB,oBAAoB,SAEnC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAC,MAAM,GAAE,WAAW,GAAC,IAAI,CAajE"}
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACrB;AAwCD,wBAAgB,YAAY,CAAC,QAAQ,EAAC,MAAM,EAAC,QAAQ,EAAC,MAAM,EAAC,KAAK,GAAC,MAAM,GAAC,IAAS,GAAE,MAAM,CAY1F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAC,MAAM,QAajD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAC,MAAM,EAAE,YAAY,EAAC,WAAW,QAe1E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAC,eAAe,QAE3D;AAED,wBAAgB,kBAAkB,IAAG,eAAe,GAAC,IAAI,CAExD;AAED,wBAAgB,oBAAoB,SAEnC;AAED,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,QAAQ,EAAC,OAAO,QAEnD;AAED,wBAAgB,qBAAqB,IAAG,OAAO,CAU9C;AAED,wBAAgB,oBAAoB,SAEnC"}

package/dist/aiworkspace_client.d.ts

@@ -0,0 +1,91 @@
+import type { kRPCClient } from './krpc_client';
+export declare const AIWORKSPACE_SERVICE_NAME = "aiworkspace";
+/** Business results of the AI Workspace service: `{ ok, ... }`, `{ ok: false, error }`, or a three-state commit result. */
+export interface AiwsError {
+    code: string;
+    retryable: boolean;
+    detail: string;
+    sub_code?: string;
+    data?: unknown;
+}
+export type AiwsResult<T> = (T & {
+    ok: true;
+}) | {
+    ok: false;
+    error: AiwsError;
+};
+export declare class AiwsFailure extends Error {
+    readonly code: string;
+    readonly subCode?: string;
+    readonly data?: unknown;
+    constructor(error: AiwsError);
+}
+/** A reference object (内核架构改进 D10): where, and which version. */
+export interface AiwsReference {
+    zone?: string;
+    workspace_id?: string;
+    entity_id: string;
+    selector?: Record<string, unknown>;
+    mode: 'live' | 'fixed';
+    version?: {
+        epoch: string;
+        seq: number;
+    } | {
+        content_root: string;
+        path?: string;
+    };
+}
+/** What an executor outside the service reports for a run (M3): results in the Mock executor's shape, or an analysis. */
+export interface AiwsRunReport {
+    run_id: string;
+    attempt: number;
+    progress?: Record<string, unknown>;
+    error?: {
+        code: string;
+        detail: string;
+    };
+    results?: Record<string, unknown>[];
+    read_set?: Record<string, unknown>[];
+    summary?: string;
+    warnings?: string[];
+    assumptions?: string[];
+    analysis?: Record<string, unknown>;
+}
+/**
+ * kRPC client of the AI Workspace service (`/kapi/aiworkspace`). Every method takes the business result out of
+ * `result` and throws `AiwsFailure` on `{ ok: false }`; commits return the three-state result as it is.
+ * Stable methods: see `src/frame/aiworkspace/README.md` (Protocol, method levels).
+ */
+export declare class AiWorkspaceClient {
+    private rpcClient;
+    constructor(rpcClient: kRPCClient);
+    call<T = Record<string, unknown>>(method: string, params: Record<string, unknown>): Promise<T>;
+    list(): Promise<Record<string, unknown>>;
+    info(workspace_id: string): Promise<Record<string, unknown>>;
+    getUserState(workspace_id: string): Promise<Record<string, unknown>>;
+    setUserState(workspace_id: string, entries: Record<string, unknown>, expect?: Record<string, number>): Promise<Record<string, unknown>>;
+    resolve(workspace_id: string, reference: AiwsReference | Record<string, unknown>): Promise<Record<string, unknown>>;
+    resolvePath(workspace_id: string, path: string): Promise<Record<string, unknown>>;
+    read(workspace_id: string, entity_id: string, selector?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    query(workspace_id: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    outline(workspace_id: string): Promise<Record<string, unknown>>;
+    prepare(workspace_id: string, request: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** The three-state commit result (`status: accepted | conflict | rejected`), never thrown. */
+    commit(workspace_id: string, request: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getSubmission(workspace_id: string, epoch: string, idempotency_key: string): Promise<Record<string, unknown>>;
+    runStart(workspace_id: string, program: string, params: Record<string, unknown>, idempotency_key: string): Promise<Record<string, unknown>>;
+    runGet(workspace_id: string, run_id: string, choices?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    runList(workspace_id: string, wish_id?: string, limit?: number): Promise<Record<string, unknown>>;
+    runClaim(workspace_id: string, run_id: string, claim_token: string, executor?: Record<string, unknown>): Promise<{
+        run_id: string;
+        attempt: number;
+        run_token: string;
+        lease_until: string;
+        lease_ms: number;
+    }>;
+    runHeartbeat(workspace_id: string, run_id: string, attempt: number, progress?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    runReport(workspace_id: string, report: AiwsRunReport): Promise<Record<string, unknown>>;
+    runApply(workspace_id: string, run_id: string, plan_digest: string, session_id?: string): Promise<Record<string, unknown>>;
+    runCancel(workspace_id: string, run_id: string): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=aiworkspace_client.d.ts.map

package/dist/aiworkspace_client.d.ts.map

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

package/dist/app-frame.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./content.cjs"),t=(e,t,i={})=>({protocol:"buckyos.app-frame",version:1,type:e,payload:t,...i}),i=e=>{if(!e||"object"!=typeof e)return!1;const t=e;return"buckyos.app-frame"===t.protocol&&1===t.version&&"string"==typeof t.type&&!!t.payload&&"object"==typeof t.payload};exports.AppFrameClient=class{constructor(e){if(this.options=e,this.listener=e=>{this.receive(e)},this.origin=new URL(e.shellOrigin).origin,this.nonce=new URLSearchParams(window.location.hash.slice(1)).get("bfp"),window.addEventListener("message",this.listener),window.parent!==window&&this.nonce){const i=()=>window.parent.postMessage(t("frame.hello",{nonce:this.nonce,appCapabilities:[...e.onOpen?["open"]:[],...e.onBeforeClose?["beforeClose"]:[],...e.onBack?["back"]:[]]}),this.origin);i(),this.helloTimer=setInterval(i,250),this.helloDeadline=setTimeout((()=>clearInterval(this.helloTimer)),1500)}}async receive(s){var n,o,r,a,l,p,c,h,d,u,y,f,w,m;if(s.source!==window.parent||s.origin!==this.origin||!i(s.data))return;const g=s.data,v=g.payload;if("frame.init"===g.type){if(!this.nonce||v.nonce!==this.nonce||"string"!=typeof v.locale||!v.theme||"string"!=typeof v.windowId||v.launch&&!e.isOpenRequest(v.launch))return;return clearInterval(this.helloTimer),clearTimeout(this.helloDeadline),this.init=v,void(null==(o=(n=this.options).onInit)||o.call(n,this.init))}if(!this.init)return;const b=e=>window.parent.postMessage(t(g.type+"Result",e,{replyTo:g.id}),this.origin);try{"frame.open"===g.type&&e.isOpenRequest(v.request)&&b(await(null==(a=(r=this.options).onOpen)?void 0:a.call(r,v.request))??{accepted:!1}),"frame.beforeClose"===g.type&&b({decision:await(null==(p=(l=this.options).onBeforeClose)?void 0:p.call(l,v.reason))??"allow"}),"frame.back"===g.type&&b({handled:await(null==(h=(c=this.options).onBack)?void 0:h.call(c))??!1}),"frame.themeChanged"!==g.type||"dark"!==v.mode&&"light"!==v.mode||null==(u=(d=this.options).onTheme)||u.call(d,v),"frame.localeChanged"===g.type&&"string"==typeof v.locale&&(null==(f=(y=this.options).onLocale)||f.call(y,v.locale)),"frame.focusChanged"===g.type&&(null==(m=(w=this.options).onFocus)||m.call(w,!0===v.focused))}catch{"frame.open"===g.type&&b({accepted:!1,fallback:"preview"}),"frame.beforeClose"===g.type&&b({decision:"deny"})}}send(e,i){this.init&&window.parent.postMessage(t(e,i),this.origin)}setTitle(e,t=!1){this.send("window.setTitle",{title:e,dirty:t})}requestClose(){this.send("window.requestClose",{})}openContent(e,t="default",i=!1){this.send("content.open",{request:e,target:t,newWindow:i})}dispose(){clearInterval(this.helloTimer),clearTimeout(this.helloDeadline),window.removeEventListener("message",this.listener)}},exports.AppFrameHost=class{constructor(e){this.options=e,this.ready=!1,this.capabilities=[],this.pending=new Map,this.listener=e=>this.receive(e),this.opens=[],window.addEventListener("message",this.listener)}receive(t){var s,n,o,r,a,l,p,c;if(t.source!==this.options.target()||t.origin!==this.options.origin||!i(t.data))return;const h=t.data,d=h.payload;if("frame.hello"===h.type){if(d.nonce!==this.options.init.nonce||!Array.isArray(d.appCapabilities))return;return this.ready=!0,this.capabilities=d.appCapabilities.filter((e=>"string"==typeof e)),this.send("frame.init",this.options.init),void(null==(n=(s=this.options).onReady)||n.call(s))}if(this.ready)if(h.replyTo){const e=this.pending.get(h.replyTo);e&&h.type===e.type+"Result"&&(clearTimeout(e.timer),this.pending.delete(h.replyTo),e.resolve(h.payload))}else if("window.setTitle"===h.type&&"string"==typeof d.title&&(null==(r=(o=this.options).onTitle)||r.call(o,d.title.slice(0,256),!0===d.dirty)),"window.requestClose"===h.type&&(null==(l=(a=this.options).onRequestClose)||l.call(a)),"content.open"===h.type&&("default"===d.target||"preview"===d.target)){const t={...d.request,requestId:crypto.randomUUID()};if(!e.isOpenRequest(t))return;if(this.opens=this.opens.filter((e=>e>Date.now()-1e4)),this.opens.length>=5)return;this.opens.push(Date.now()),null==(c=(p=this.options).onContentOpen)||c.call(p,t,d.target,!0===d.newWindow)}}update(e){this.options.init={...this.options.init,...e}}send(e,i){var s;this.ready&&(null==(s=this.options.target())||s.postMessage(t(e,i),this.options.origin))}request(e,i,s=3e3){if(!this.ready)return Promise.reject(new Error("App frame is not ready"));const n=crypto.randomUUID();return new Promise(((o,r)=>{var a;const l=setTimeout((()=>{this.pending.delete(n),r(new Error("App frame timed out"))}),s);this.pending.set(n,{resolve:o,reject:r,timer:l,type:e}),null==(a=this.options.target())||a.postMessage(t(e,i,{id:n}),this.options.origin)}))}async open(e){return this.capabilities.includes("open")?await this.request("frame.open",{request:e}):{accepted:!1}}async beforeClose(e="user"){if(!this.ready||!this.capabilities.includes("beforeClose"))return"allow";const t=await this.request("frame.beforeClose",{reason:e});return"allow"===t.decision||"pending"===t.decision?t.decision:"deny"}async back(){return!!this.capabilities.includes("back")&&!0===(await this.request("frame.back",{})).handled}dispose(){window.removeEventListener("message",this.listener),this.pending.forEach((e=>{clearTimeout(e.timer),e.reject(new Error("App frame disposed"))})),this.pending.clear(),this.ready=!1}};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./content.cjs"),t=(e,t,i={})=>({protocol:"buckyos.app-frame",version:1,type:e,payload:t,...i}),i=e=>{if(!e||"object"!=typeof e)return!1;const t=e;return"buckyos.app-frame"===t.protocol&&1===t.version&&"string"==typeof t.type&&!!t.payload&&"object"==typeof t.payload};const s="buckyos.preview-embed",n=(e,t)=>({protocol:s,version:1,type:e,payload:t}),o=e=>{const t=e;return!!t&&t.protocol===s&&1===t.version&&"string"==typeof t.type&&!!t.payload&&"object"==typeof t.payload},r="/embed/preview";exports.AppFrameClient=class{constructor(e){if(this.options=e,this.listener=e=>{this.receive(e)},this.origin=new URL(e.shellOrigin).origin,this.nonce=new URLSearchParams(window.location.hash.slice(1)).get("bfp"),window.addEventListener("message",this.listener),window.parent!==window&&this.nonce){const i=()=>window.parent.postMessage(t("frame.hello",{nonce:this.nonce,appCapabilities:[...e.onOpen?["open"]:[],...e.onBeforeClose?["beforeClose"]:[],...e.onBack?["back"]:[]]}),this.origin);i(),this.helloTimer=setInterval(i,250),this.helloDeadline=setTimeout((()=>clearInterval(this.helloTimer)),1500)}}async receive(s){var n,o,r,a,l,p,c,d,h,u,f,w,y,m;if(s.source!==window.parent||s.origin!==this.origin||!i(s.data))return;const g=s.data,v=g.payload;if("frame.init"===g.type){if(!this.nonce||v.nonce!==this.nonce||"string"!=typeof v.locale||!v.theme||"string"!=typeof v.windowId||v.launch&&!e.isOpenRequest(v.launch))return;return clearInterval(this.helloTimer),clearTimeout(this.helloDeadline),this.init=v,this.title=void 0,this.focused=void 0,void(null==(o=(n=this.options).onInit)||o.call(n,this.init))}if(!this.init)return;const b=e=>window.parent.postMessage(t(g.type+"Result",e,{replyTo:g.id}),this.origin);try{"frame.open"===g.type&&e.isOpenRequest(v.request)&&b(await(null==(a=(r=this.options).onOpen)?void 0:a.call(r,v.request))??{accepted:!1}),"frame.beforeClose"===g.type&&b({decision:await(null==(p=(l=this.options).onBeforeClose)?void 0:p.call(l,v.reason))??"allow"}),"frame.back"===g.type&&b({handled:await(null==(d=(c=this.options).onBack)?void 0:d.call(c))??!1}),"frame.themeChanged"!==g.type||"dark"!==v.mode&&"light"!==v.mode||null==(u=(h=this.options).onTheme)||u.call(h,v),"frame.localeChanged"===g.type&&"string"==typeof v.locale&&(null==(w=(f=this.options).onLocale)||w.call(f,v.locale)),"frame.focusChanged"===g.type&&this.focused!==(!0===v.focused)&&(this.focused=!0===v.focused,null==(m=(y=this.options).onFocus)||m.call(y,this.focused))}catch{"frame.open"===g.type&&b({accepted:!1,fallback:"preview"}),"frame.beforeClose"===g.type&&b({decision:"deny"})}}send(e,i){this.init&&window.parent.postMessage(t(e,i),this.origin)}setTitle(e,t=!1){const i=JSON.stringify([e,t]);this.init&&i!==this.title&&(this.title=i,this.send("window.setTitle",{title:e,dirty:t}))}requestClose(){this.send("window.requestClose",{})}openContent(t,i="default",s={}){const n=s.hints??{};return this.init?(this.send("content.open",{request:t,target:i,newWindow:!0===s.newWindow,hints:n}),!0):!!this.options.systemOrigin&&(window.open(e.systemOpenUrl(this.options.systemOrigin,{request:t,target:i,hints:n,from:this.options.appId}),"_blank","noopener"),!0)}dispose(){clearInterval(this.helloTimer),clearTimeout(this.helloDeadline),window.removeEventListener("message",this.listener)}},exports.AppFrameHost=class{constructor(e){this.options=e,this.ready=!1,this.capabilities=[],this.pending=new Map,this.listener=e=>this.receive(e),this.opens=[],window.addEventListener("message",this.listener)}receive(t){var s,n,o,r,a,l,p,c;if(t.source!==this.options.target()||t.origin!==this.options.origin||!i(t.data))return;const d=t.data,h=d.payload;if("frame.hello"===d.type){if(h.nonce!==this.options.init.nonce||!Array.isArray(h.appCapabilities))return;return this.ready=!0,this.capabilities=h.appCapabilities.filter((e=>"string"==typeof e)),this.send("frame.init",this.options.init),void 0!==this.focused&&this.send("frame.focusChanged",{focused:this.focused}),void(null==(n=(s=this.options).onReady)||n.call(s))}if(this.ready)if(d.replyTo){const e=this.pending.get(d.replyTo);e&&d.type===e.type+"Result"&&(clearTimeout(e.timer),this.pending.delete(d.replyTo),e.resolve(d.payload))}else if("window.setTitle"===d.type&&"string"==typeof h.title&&(null==(r=(o=this.options).onTitle)||r.call(o,h.title.slice(0,256),!0===h.dirty)),"window.requestClose"===d.type&&(null==(l=(a=this.options).onRequestClose)||l.call(a)),"content.open"===d.type&&("default"===h.target||"preview"===h.target||"chooser"===h.target)){const t={...h.request,requestId:crypto.randomUUID()};if(!e.isOpenRequest(t))return;if(this.opens=this.opens.filter((e=>e>Date.now()-1e4)),this.opens.length>=5)return;this.opens.push(Date.now()),null==(c=(p=this.options).onContentOpen)||c.call(p,t,h.target,{newWindow:!0===h.newWindow,hints:e.readContentHints(h.hints)})}}update(e){this.options.init={...this.options.init,...e}}setFocused(e){this.focused!==e&&(this.focused=e,this.send("frame.focusChanged",{focused:e}))}send(e,i){var s;this.ready&&(null==(s=this.options.target())||s.postMessage(t(e,i),this.options.origin))}request(e,i,s=3e3){if(!this.ready)return Promise.reject(new Error("App frame is not ready"));const n=crypto.randomUUID();return new Promise(((o,r)=>{var a;const l=setTimeout((()=>{this.pending.delete(n),r(new Error("App frame timed out"))}),s);this.pending.set(n,{resolve:o,reject:r,timer:l,type:e}),null==(a=this.options.target())||a.postMessage(t(e,i,{id:n}),this.options.origin)}))}async open(e){return this.capabilities.includes("open")?await this.request("frame.open",{request:e}):{accepted:!1}}async beforeClose(e="user"){if(!this.ready||!this.capabilities.includes("beforeClose"))return"allow";const t=await this.request("frame.beforeClose",{reason:e});return"allow"===t.decision||"pending"===t.decision?t.decision:"deny"}async back(){return!!this.capabilities.includes("back")&&!0===(await this.request("frame.back",{})).handled}dispose(){window.removeEventListener("message",this.listener),this.pending.forEach((e=>{clearTimeout(e.timer),e.reject(new Error("App frame disposed"))})),this.pending.clear(),this.ready=!1}},exports.PREVIEW_EMBED_PATH=r,exports.PreviewEmbed=class{constructor(e){this.options=e,this.nonce=crypto.randomUUID(),this.listener=e=>this.receive(e),this.origin=new URL(e.systemOrigin).origin,this.init=e.init,this.url=`${this.origin}${r}#bpe=${this.nonce}&po=${encodeURIComponent(window.location.origin)}`,window.addEventListener("message",this.listener)}post(e,t){var i,s;null==(s=null==(i=this.options.frame())?void 0:i.contentWindow)||s.postMessage(n(e,t),this.origin)}receive(t){var i,s,n,r,a,l,p;if(t.origin!==this.origin||t.source!==(null==(i=this.options.frame())?void 0:i.contentWindow)||!o(t.data))return;const{type:c,payload:d}=t.data;if("embed.hello"!==c){if("embed.state"===c&&("loading"===d.status||"ready"===d.status||"error"===d.status)){const e=d.error;null==(n=(s=this.options).onState)||n.call(s,{status:d.status,error:e&&"string"==typeof e.kind&&"string"==typeof e.code?{kind:e.kind,code:e.code}:void 0,title:"string"==typeof d.title?d.title.slice(0,256):void 0,mediaType:"string"==typeof d.mediaType?d.mediaType.slice(0,128):void 0})}if("embed.openWith"===c){const t=d.request;t&&e.isTransferableRef(t.source)&&(void 0===t.session||e.isTransferableSession(t.session))&&(null==(a=(r=this.options).onOpenWith)||a.call(r,{request:{source:t.source,session:t.session},hints:e.readContentHints(d.hints)}))}"embed.exit"===c&&(null==(p=(l=this.options).onExit)||p.call(l))}else d.nonce===this.nonce&&this.post("embed.init",{...this.init,nonce:this.nonce})}update(e){this.init={...this.init,...e},this.post("embed.update",e)}dispose(){window.removeEventListener("message",this.listener)}},exports.PreviewEmbedHost=class{constructor(e){this.options=e,this.ready=!1,this.listener=e=>this.receive(e);const t=new URLSearchParams(window.location.hash.slice(1));this.nonce=t.get("bpe");let i=null;try{i=new URL(t.get("po")??"").origin}catch{}if(this.parentOrigin=window.parent!==window&&this.nonce&&i&&e.accept(i)?i:null,!this.parentOrigin)return;window.addEventListener("message",this.listener);const s=()=>window.parent.postMessage(n("embed.hello",{nonce:this.nonce}),this.parentOrigin);s(),this.hello=setInterval((()=>{this.ready||s()}),250)}receive(t){var i,s;if(t.source!==window.parent||t.origin!==this.parentOrigin||!o(t.data))return;const{type:n,payload:r}=t.data;if("embed.init"===n){if(r.nonce!==this.nonce||(a=r.source,!(e.isTransferableRef(a)||a&&"object"==typeof a&&"blob"===a.kind&&"undefined"!=typeof Blob&&a.blob instanceof Blob&&"string"==typeof a.name))||void 0!==r.session&&!e.isTransferableSession(r.session)||"string"!=typeof r.locale)return;return this.ready=!0,clearInterval(this.hello),void this.options.onInit({nonce:String(r.nonce),source:r.source,session:r.session,theme:"dark"===r.theme?"dark":"light",locale:r.locale})}var a;if("embed.update"===n&&this.ready){const e={};"dark"!==r.theme&&"light"!==r.theme||(e.theme=r.theme),"string"==typeof r.locale&&(e.locale=r.locale),null==(s=(i=this.options).onUpdate)||s.call(i,e)}}post(e,t){this.ready&&this.parentOrigin&&window.parent.postMessage(n(e,t),this.parentOrigin)}state(e){this.post("embed.state",e)}openWith(e){this.post("embed.openWith",e)}exit(){this.post("embed.exit",{})}dispose(){clearInterval(this.hello),window.removeEventListener("message",this.listener)}},exports.embedderOrigin=function(e){var t;if(window.parent===window)return null;const i=[null==(t=window.location.ancestorOrigins)?void 0:t[0],document.referrer];for(const s of i)if(s)try{const t=new URL(s).origin;if(e(t))return t}catch{}return null},exports.originInZone=(e,t)=>{try{const i=new URL(e);return i.protocol===window.location.protocol&&(i.hostname===t||i.hostname.endsWith(`.${t}`))}catch{return!1}};
 //# sourceMappingURL=app-frame.cjs.map