@tyvm/knowhow-app-sdk 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +141 -2
- package/dist/index.cjs +1141 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +528 -0
- package/dist/index.d.ts +528 -0
- package/dist/index.js +1101 -0
- package/dist/index.js.map +1 -0
- package/dist/knowhow-sdk.iife.js +1 -0
- package/package.json +37 -4
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../app-protocol/src/methods.ts","../../app-protocol/src/capabilities.ts","../../app-protocol/src/errors.ts","../../app-protocol/src/discovery.ts","../../app-protocol/src/rpc.ts","../src/provider.ts","../src/files.ts","../src/mock.ts","../src/sdk.ts"],"sourcesContent":["import type { Capability } from \"./capabilities\";\n\nexport const PROTOCOL_VERSION = 1 as const;\n\n/** Provider method names (v1). Breaking changes ship as new names (`kh_x_v2`). */\nexport const Methods = {\n Protocol: \"kh_protocol\",\n Connect: \"kh_connect\",\n Session: \"kh_session\",\n Disconnect: \"kh_disconnect\",\n DbQuery: \"kh_db_query\",\n DbExec: \"kh_db_exec\",\n DbBatch: \"kh_db_batch\",\n KvGet: \"kh_kv_get\",\n KvSet: \"kh_kv_set\",\n KvDelete: \"kh_kv_delete\",\n FilesList: \"kh_files_list\",\n FilesRead: \"kh_files_read\",\n FilesWrite: \"kh_files_write\",\n FilesStat: \"kh_files_stat\",\n FilesDelete: \"kh_files_delete\",\n FilesUploadStart: \"kh_files_upload_start\",\n FilesUploadComplete: \"kh_files_upload_complete\",\n FilesDownloadUrl: \"kh_files_download_url\",\n AiComplete: \"kh_ai_complete\",\n AiTranscribe: \"kh_ai_transcribe\",\n AiImage: \"kh_ai_image\",\n SpendGet: \"kh_spend_get\",\n AppEnv: \"kh_app_env\",\n ToolsRegister: \"kh_tools_register\",\n ToolsResult: \"kh_tools_result\",\n UiNotify: \"kh_ui_notify\",\n} as const;\n\nexport type MethodName = (typeof Methods)[keyof typeof Methods];\n\n/** Methods that are answered by the host itself and never relayed to the backend. */\nexport const HOST_LOCAL_METHODS: readonly MethodName[] = [\n Methods.Protocol,\n Methods.Connect,\n Methods.Session,\n Methods.Disconnect,\n Methods.ToolsRegister,\n Methods.ToolsResult,\n Methods.UiNotify,\n];\n\n/** Provider events. */\nexport const Events = {\n Connect: \"connect\",\n Disconnect: \"disconnect\",\n SessionChanged: \"sessionChanged\",\n ToolCall: \"toolCall\",\n Message: \"message\",\n} as const;\n\nexport type EventName = (typeof Events)[keyof typeof Events];\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\nexport type JsonObject = { [key: string]: JsonValue };\n\nexport type HostKind = \"web\" | \"extension\" | \"desktop\" | \"mobile\";\n\nexport interface HostInfo {\n kind: HostKind;\n version: string;\n}\n\nexport interface ProtocolParams {}\nexport interface ProtocolResult {\n protocol: typeof PROTOCOL_VERSION;\n methods: string[];\n host: HostInfo;\n}\n\nexport interface ConnectParams {\n appId?: string;\n capabilities?: Capability[];\n}\n\nexport interface SessionInfo {\n /**\n * App id of a registered app. For a self-hosted site session (no Knowhow app entry) this is\n * `site:<origin>` so code that keys on `appId` keeps working; check `site` to tell the two apart.\n */\n appId: string;\n user: { displayName: string };\n capabilities: Capability[];\n /**\n * Present only for self-hosted site sessions: the site's real origin, as observed by the host\n * (never self-claimed by the page). Such sessions are billed to the visitor and limited to\n * ai:* and db:app (+ host-only tools).\n */\n site?: { origin: string };\n}\n\nexport type ConnectResult = SessionInfo;\nexport type SessionResult = SessionInfo | null;\n\nexport type SqlParam = string | number | boolean | null;\nexport interface SqlStatement {\n sql: string;\n params?: SqlParam[];\n}\nexport interface DbQueryParams extends SqlStatement {}\nexport interface DbQueryResult {\n rows: Array<Record<string, JsonValue>>;\n columns: string[];\n}\nexport interface DbExecParams extends SqlStatement {}\nexport interface DbExecResult {\n changes: number;\n lastInsertRowid: number | string | null;\n}\nexport interface DbBatchParams {\n statements: SqlStatement[];\n}\nexport interface DbBatchResult {\n results: Array<DbQueryResult | DbExecResult>;\n}\n\nexport interface KvGetParams {\n key: string;\n}\nexport interface KvGetResult {\n value: JsonValue | null;\n}\nexport interface KvSetParams {\n key: string;\n value: JsonValue;\n}\nexport interface KvDeleteParams {\n key: string;\n}\n\n/**\n * Where scoped app files live (`files:app`):\n * - \"user\": private to the signed-in user (default)\n * - \"org\": shared with the organization (subject to org folder policies)\n */\nexport type FilesScope = \"user\" | \"org\";\n\nexport interface FilesListParams {\n path?: string;\n /**\n * When present, lists the scoped storage (`path` = folder prefix, relative to the app root).\n * When absent: legacy list of a registered app's `data` folder (registered apps only).\n */\n scope?: FilesScope;\n}\nexport interface AppFileInfo {\n id: string;\n name: string;\n /** Path relative to the app's files root. */\n path: string;\n size: number;\n mime: string;\n updatedAt: string;\n /** Set by the scoped API. */\n scope?: FilesScope;\n}\nexport interface FilesListResult {\n files: AppFileInfo[];\n}\nexport interface FilesReadParams {\n path: string;\n}\nexport type FilesReadResult = { text: string; url?: undefined } | { url: string; text?: undefined };\nexport interface FilesWriteParams {\n path: string;\n text: string;\n}\nexport interface FilesWriteResult {\n id: string;\n}\n\n/** Limits of the scoped files API (enforced by the backend). */\nexport const FILES_MAX_FILE_BYTES = 2147483647;\n\nexport interface FilesStatParams {\n path: string;\n scope?: FilesScope;\n}\nexport interface FilesStatResult {\n file: AppFileInfo | null;\n}\nexport interface FilesDeleteParams {\n path: string;\n scope?: FilesScope;\n}\nexport interface FilesDeleteResult {\n deleted: boolean;\n}\n/** Step 1 of an upload: the bytes are PUT straight to `uploadUrl` (S3), never through the provider. */\nexport interface FilesUploadStartParams {\n path: string;\n size: number;\n contentType?: string;\n scope?: FilesScope;\n}\nexport interface FilesUploadStartResult {\n id: string;\n uploadUrl: string;\n method: \"PUT\";\n maxBytes: number;\n}\n/** Step 2: verify the upload, record size/hash. */\nexport interface FilesUploadCompleteParams {\n id: string;\n scope?: FilesScope;\n}\nexport interface FilesUploadCompleteResult {\n file: AppFileInfo;\n}\n/** Presigned GET url (S3 serves Range requests). */\nexport interface FilesDownloadUrlParams {\n path: string;\n scope?: FilesScope;\n}\nexport interface FilesDownloadUrlResult {\n url: string;\n file: AppFileInfo;\n}\n\nexport interface AiMessage {\n role: \"system\" | \"user\" | \"assistant\";\n content: string;\n}\nexport interface AiCompleteParams {\n messages: AiMessage[];\n model?: string;\n maxTokens?: number;\n}\nexport interface AiCompleteResult {\n content: string;\n model: string;\n usage?: { inputTokens?: number; outputTokens?: number; costUsd?: number };\n}\n\n/** Max decoded audio size accepted by `kh_ai_transcribe` (bytes). */\nexport const AI_TRANSCRIBE_MAX_AUDIO_BYTES = 25 * 1024 * 1024;\n/** Max images per `kh_ai_image` call. */\nexport const AI_IMAGE_MAX_N = 4;\n/** Max input images per `kh_ai_image` edit call. */\nexport const AI_IMAGE_MAX_INPUTS = 4;\n\nexport type AiTranscribeTimestamp = \"word\" | \"segment\";\nexport interface AiTranscribeParams {\n /** Base64 or data URL (\"data:audio/mpeg;base64,...\"). */\n audio: string;\n /** e.g. \"audio.mp3\" (the extension tells the provider the format). */\n fileName?: string;\n /** Default \"whisper-1\". */\n model?: string;\n language?: string;\n prompt?: string;\n /** Default [\"word\", \"segment\"]. */\n timestamps?: AiTranscribeTimestamp[];\n}\nexport interface AiTranscribeSegment {\n start: number;\n end: number;\n text: string;\n}\nexport interface AiTranscribeWord {\n start: number;\n end: number;\n word: string;\n}\nexport interface AiTranscribeResult {\n text: string;\n language?: string;\n duration?: number;\n model: string;\n segments: AiTranscribeSegment[];\n /** [] if the provider gave none. */\n words: AiTranscribeWord[];\n}\n\nexport type AiImageSize = \"1024x1024\" | \"1024x1792\" | \"1792x1024\";\nexport interface AiImageParams {\n prompt: string;\n /** Default \"dall-e-3\"; \"gpt-image-1.5\" when `images` is given. Editing works with gpt-image*, gemini-*-image, grok-imagine-image. */\n model?: string;\n size?: AiImageSize;\n /** 1..4 */\n n?: number;\n /**\n * Edit / compose instead of generate: 1..{@link AI_IMAGE_MAX_INPUTS} source images as `data:image/...;base64,` URLs.\n * The first is the image being edited; the rest are references (style / objects to composite).\n */\n images?: string[];\n /** Inpainting mask (PNG data URL, transparent = repaint). Needs `images`; only OpenAI models honour it. */\n mask?: string;\n}\nexport interface AiImageItem {\n dataUrl?: string;\n url?: string;\n revisedPrompt?: string;\n}\nexport interface AiImageResult {\n images: AiImageItem[];\n model: string;\n}\n\n/** Current spend limit + usage of this app/site for the signed-in user (no capability needed). */\nexport interface SpendView {\n spendLimitUsd: number;\n spendPeriod: \"day\" | \"month\" | \"total\";\n /** USD spent in the current period. */\n spentUsd: number;\n /** Lifetime USD spent. */\n spentUsdTotal: number;\n /** ISO time the period counter resets; null for \"total\". */\n periodResetsAt: string | null;\n aiRequestsTotal: number;\n}\n\n/**\n * The environment the app is running in (\"prod\", \"dev\", ...). `vars` are the environment's\n * NON-SECRET variables, read at runtime (never baked into the build, so promoting a build from dev to\n * prod picks up prod's values). Secrets are never returned. No capability needed.\n */\nexport interface AppEnvView {\n name: string;\n vars: Record<string, string>;\n}\n\nexport interface ToolDefinition {\n name: string;\n description: string;\n /** JSON Schema describing the tool arguments. */\n parameters: JsonObject;\n /**\n * Optional hint: true when the tool never changes state (list/search/read). Hosts may auto-run\n * read-only tools; everything else (readOnly absent or false) is treated as mutating and should go\n * through the host's approval UI.\n */\n readOnly?: boolean;\n}\nexport interface ToolsRegisterParams {\n tools: ToolDefinition[];\n}\nexport interface ToolsResultParams {\n callId: string;\n result?: JsonValue;\n error?: string;\n}\n/** Payload of the host→app `toolCall` event. */\nexport interface ToolCallEvent {\n callId: string;\n name: string;\n args: JsonObject;\n}\n\nexport type NotifyLevel = \"info\" | \"success\" | \"warning\" | \"error\";\nexport interface UiNotifyParams {\n message: string;\n level?: NotifyLevel;\n}\n\n/** Full params/result map for every method in the v1 table. */\nexport interface MethodMap {\n kh_protocol: { params: ProtocolParams; result: ProtocolResult };\n kh_connect: { params: ConnectParams; result: ConnectResult };\n kh_session: { params: Record<string, never>; result: SessionResult };\n kh_disconnect: { params: Record<string, never>; result: true };\n kh_db_query: { params: DbQueryParams; result: DbQueryResult };\n kh_db_exec: { params: DbExecParams; result: DbExecResult };\n kh_db_batch: { params: DbBatchParams; result: DbBatchResult };\n kh_kv_get: { params: KvGetParams; result: KvGetResult };\n kh_kv_set: { params: KvSetParams; result: true };\n kh_kv_delete: { params: KvDeleteParams; result: true };\n kh_files_list: { params: FilesListParams; result: FilesListResult };\n kh_files_read: { params: FilesReadParams; result: FilesReadResult };\n kh_files_write: { params: FilesWriteParams; result: FilesWriteResult };\n kh_files_stat: { params: FilesStatParams; result: FilesStatResult };\n kh_files_delete: { params: FilesDeleteParams; result: FilesDeleteResult };\n kh_files_upload_start: { params: FilesUploadStartParams; result: FilesUploadStartResult };\n kh_files_upload_complete: { params: FilesUploadCompleteParams; result: FilesUploadCompleteResult };\n kh_files_download_url: { params: FilesDownloadUrlParams; result: FilesDownloadUrlResult };\n kh_ai_complete: { params: AiCompleteParams; result: AiCompleteResult };\n kh_ai_transcribe: { params: AiTranscribeParams; result: AiTranscribeResult };\n kh_ai_image: { params: AiImageParams; result: AiImageResult };\n kh_spend_get: { params: Record<string, never>; result: SpendView };\n kh_app_env: { params: Record<string, never>; result: AppEnvView };\n kh_tools_register: { params: ToolsRegisterParams; result: true };\n kh_tools_result: { params: ToolsResultParams; result: true };\n kh_ui_notify: { params: UiNotifyParams; result: true };\n}\n\nexport type ParamsOf<M extends keyof MethodMap> = MethodMap[M][\"params\"];\nexport type ResultOf<M extends keyof MethodMap> = MethodMap[M][\"result\"];\n\nexport const ALL_METHODS: readonly MethodName[] = Object.values(Methods);\n\n/**\n * Handshake message names for the iframe transport.\n *\n * Per-load handshake:\n * 1. On every iframe `load` the host generates a fresh random nonce and posts\n * `{ type: \"kh:init\", protocol, nonce }` to the frame at its exact origin.\n * 2. The SDK learns the parent origin from that message (validated against\n * `location.ancestorOrigins` / `document.referrer` when available) and answers\n * `{ type: \"kh:hello\", protocol, sdkVersion, nonce }` to that origin only (never \"*\").\n * 3. The host accepts only `event.origin === appOrigin && event.source === frame.contentWindow`\n * with the current nonce, then transfers a MessagePort. Every RPC frame on that port\n * carries the nonce; frames with a missing/stale nonce are dropped.\n * A new load invalidates the previous session.\n */\nexport const HELLO_TYPE = \"kh:hello\" as const;\nexport const PORT_TYPE = \"kh:port\" as const;\nexport const INIT_TYPE = \"kh:init\" as const;\nexport interface InitMessage {\n type: typeof INIT_TYPE;\n protocol: typeof PROTOCOL_VERSION;\n nonce: string;\n}\nexport interface HelloMessage {\n type: typeof HELLO_TYPE;\n protocol: typeof PROTOCOL_VERSION;\n sdkVersion: string;\n /** Echo of the host's per-load nonce. */\n nonce: string;\n}\nexport interface PortMessage {\n type: typeof PORT_TYPE;\n protocol: typeof PROTOCOL_VERSION;\n nonce: string;\n}\n","import { Methods } from \"./methods\";\n\n/** Closed capability list v1. */\nexport const CAPABILITIES = [\n \"db:app\",\n \"files:app\",\n \"ai:complete\",\n \"ai:transcribe\",\n \"ai:image\",\n \"tools:expose\",\n] as const;\nexport type Capability = (typeof CAPABILITIES)[number];\n\nexport function isCapability(v: unknown): v is Capability {\n return typeof v === \"string\" && (CAPABILITIES as readonly string[]).includes(v);\n}\n\nexport interface ParsedCapabilities {\n valid: Capability[];\n unknown: string[];\n}\n\n/** Parse an untrusted value into known capabilities (deduplicated) + unknown strings. */\nexport function parseCapabilities(input: unknown): ParsedCapabilities {\n const valid: Capability[] = [];\n const unknown: string[] = [];\n if (!Array.isArray(input)) return { valid, unknown };\n for (const item of input) {\n if (isCapability(item)) {\n if (!valid.includes(item)) valid.push(item);\n } else if (typeof item === \"string\") {\n if (!unknown.includes(item)) unknown.push(item);\n }\n }\n return { valid, unknown };\n}\n\n/** Capability required by each method (null = none required). */\nexport const METHOD_CAPABILITY: Record<string, Capability | null> = {\n [Methods.Protocol]: null,\n [Methods.Connect]: null,\n [Methods.Session]: null,\n [Methods.Disconnect]: null,\n [Methods.DbQuery]: \"db:app\",\n [Methods.DbExec]: \"db:app\",\n [Methods.DbBatch]: \"db:app\",\n [Methods.KvGet]: \"db:app\",\n [Methods.KvSet]: \"db:app\",\n [Methods.KvDelete]: \"db:app\",\n [Methods.FilesList]: \"files:app\",\n [Methods.FilesRead]: \"files:app\",\n [Methods.FilesWrite]: \"files:app\",\n [Methods.FilesStat]: \"files:app\",\n [Methods.FilesDelete]: \"files:app\",\n [Methods.FilesUploadStart]: \"files:app\",\n [Methods.FilesUploadComplete]: \"files:app\",\n [Methods.FilesDownloadUrl]: \"files:app\",\n [Methods.AiComplete]: \"ai:complete\",\n [Methods.AiTranscribe]: \"ai:transcribe\",\n [Methods.AiImage]: \"ai:image\",\n [Methods.SpendGet]: null,\n [Methods.AppEnv]: null,\n [Methods.ToolsRegister]: \"tools:expose\",\n [Methods.ToolsResult]: null,\n [Methods.UiNotify]: null,\n};\n\nexport function requiredCapability(method: string): Capability | null | undefined {\n return METHOD_CAPABILITY[method];\n}\n","/** EIP-1193-like error codes used by every provider/host/backend. */\nexport const ErrorCodes = {\n USER_REJECTED: 4001,\n UNAUTHORIZED: 4100,\n UNSUPPORTED_METHOD: 4200,\n RATE_LIMITED: 4290,\n /** The app/site hit its USD AI spend limit. `data`: SpendLimitReachedData. */\n SPEND_LIMIT_REACHED: 4291,\n DISCONNECTED: 4900,\n INVALID_PARAMS: -32602,\n INTERNAL: -32603,\n} as const;\n\nexport type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];\n\nexport interface RpcErrorPayload {\n code: number;\n message: string;\n data?: unknown;\n}\n\nexport class ProviderRpcError extends Error {\n readonly code: number;\n readonly data?: unknown;\n\n constructor(code: number, message: string, data?: unknown) {\n super(message);\n this.name = \"ProviderRpcError\";\n this.code = code;\n this.data = data;\n Object.setPrototypeOf(this, ProviderRpcError.prototype);\n }\n\n toJSON(): RpcErrorPayload {\n const out: RpcErrorPayload = { code: this.code, message: this.message };\n if (this.data !== undefined) out.data = this.data;\n return out;\n }\n\n static fromPayload(payload: RpcErrorPayload): ProviderRpcError {\n return new ProviderRpcError(payload.code, payload.message, payload.data);\n }\n\n /** Normalize anything thrown into a payload suitable for the wire. */\n static toPayload(err: unknown): RpcErrorPayload {\n if (err instanceof ProviderRpcError) return err.toJSON();\n if (isErrorPayload(err)) return { code: err.code, message: err.message, data: err.data };\n const message = err instanceof Error ? err.message : String(err);\n return { code: ErrorCodes.INTERNAL, message };\n }\n}\n\nexport function isErrorPayload(v: unknown): v is RpcErrorPayload {\n if (typeof v !== \"object\" || v === null) return false;\n const o = v as Record<string, unknown>;\n return typeof o.code === \"number\" && typeof o.message === \"string\";\n}\n\n/** `error.data` of an ErrorCodes.SPEND_LIMIT_REACHED error. */\nexport interface SpendLimitReachedData {\n spentUsd: number;\n limitUsd: number;\n period: \"day\" | \"month\" | \"total\";\n scope: \"app\" | \"site\";\n appId?: string;\n siteId?: string;\n origin?: string;\n}\n","import { PROTOCOL_VERSION } from \"./methods\";\nimport type { RpcEndpoint } from \"./rpc\";\n\nexport const ANNOUNCE_EVENT = \"knowhow:announceProvider\" as const;\nexport const REQUEST_EVENT = \"knowhow:requestProvider\" as const;\n\nexport interface ProviderInfo {\n uuid: string;\n name: string;\n icon?: string;\n /** Reverse-DNS identifier, e.g. \"ai.tyvm.knowhow.extension\". */\n rdns: string;\n protocol: typeof PROTOCOL_VERSION;\n}\n\nexport type ProviderListener = (...args: unknown[]) => void;\n\n/** EIP-1193-like provider. */\nexport interface KnowhowProvider {\n request<T = unknown>(args: { method: string; params?: unknown }): Promise<T>;\n on(event: string, listener: ProviderListener): void;\n removeListener(event: string, listener: ProviderListener): void;\n}\n\nexport interface ProviderDetail {\n info: ProviderInfo;\n provider: KnowhowProvider;\n}\n\ntype EventTargetLike = Pick<EventTarget, \"addEventListener\" | \"removeEventListener\" | \"dispatchEvent\">;\n\nfunction defaultTarget(): EventTargetLike {\n if (typeof window !== \"undefined\") return window;\n throw new Error(\"No event target available; pass one explicitly\");\n}\n\n/**\n * Provider side (EIP-6963): announce now and whenever a dapp dispatches `knowhow:requestProvider`.\n * Returns a disposer.\n */\nexport function announceProvider(detail: ProviderDetail, target: EventTargetLike = defaultTarget()): () => void {\n const frozen = Object.freeze({ info: Object.freeze({ ...detail.info }), provider: detail.provider });\n const announce = () => target.dispatchEvent(new CustomEvent(ANNOUNCE_EVENT, { detail: frozen }));\n target.addEventListener(REQUEST_EVENT, announce);\n announce();\n return () => target.removeEventListener(REQUEST_EVENT, announce);\n}\n\n/**\n * Consumer side: listen for announcements, then dispatch a request so already-installed providers answer.\n * Returns a disposer.\n */\nexport function requestProviders(\n handler: (detail: ProviderDetail) => void,\n target: EventTargetLike = defaultTarget()\n): () => void {\n const listener = (ev: Event) => {\n const detail = (ev as CustomEvent<ProviderDetail>).detail;\n if (detail && detail.info && detail.provider && detail.info.protocol === PROTOCOL_VERSION) handler(detail);\n };\n target.addEventListener(ANNOUNCE_EVENT, listener);\n target.dispatchEvent(new Event(REQUEST_EVENT));\n return () => target.removeEventListener(ANNOUNCE_EVENT, listener);\n}\n\n/** Wrap an RpcEndpoint (e.g. MessagePort based) as a KnowhowProvider. */\n/**\n * Methods that may block on a human (consent dialogs) are never timed out client-side;\n * the host resolves/rejects them (e.g. 4001 when the user dismisses consent).\n */\nconst INTERACTIVE_METHODS = new Set<string>([\"kh_connect\"]);\n\nexport function createProviderFromEndpoint(endpoint: RpcEndpoint): KnowhowProvider & { endpoint: RpcEndpoint } {\n const subs = new Map<ProviderListener, () => void>();\n return {\n endpoint,\n request: <T = unknown>(args: { method: string; params?: unknown }) =>\n endpoint.request<T>(args.method, args.params, INTERACTIVE_METHODS.has(args.method) ? 0 : undefined),\n on(event, listener) {\n const off = endpoint.on(event, (data) => listener(data));\n subs.set(listener, off);\n },\n removeListener(_event, listener) {\n subs.get(listener)?.();\n subs.delete(listener);\n },\n };\n}\n","import { ErrorCodes, ProviderRpcError, isErrorPayload, type RpcErrorPayload } from \"./errors\";\n\n/**\n * Minimal transport surface. Satisfied by MessagePort, and (through the adapters\n * below) by window / chrome.runtime.Port.\n */\nexport interface MessageLike {\n postMessage(message: unknown): void;\n addEventListener(type: \"message\", listener: (ev: { data: unknown }) => void): void;\n removeEventListener?(type: \"message\", listener: (ev: { data: unknown }) => void): void;\n /** MessagePort needs start() when using addEventListener. */\n start?(): void;\n close?(): void;\n}\n\nexport interface RequestFrame {\n id: number | string;\n method: string;\n params?: unknown;\n /** Per-load session nonce (see HELLO_TYPE docs). */\n nonce?: string;\n}\nexport interface ResponseFrame {\n id: number | string;\n result?: unknown;\n error?: RpcErrorPayload;\n nonce?: string;\n}\nexport interface EventFrame {\n event: string;\n data?: unknown;\n nonce?: string;\n}\nexport type Frame = RequestFrame | ResponseFrame | EventFrame;\n\nfunction isObj(v: unknown): v is Record<string, unknown> {\n return typeof v === \"object\" && v !== null;\n}\nconst isId = (v: unknown): v is number | string => typeof v === \"number\" || typeof v === \"string\";\n\nexport function isRequestFrame(v: unknown): v is RequestFrame {\n return isObj(v) && isId(v.id) && typeof v.method === \"string\";\n}\nexport function isResponseFrame(v: unknown): v is ResponseFrame {\n return isObj(v) && isId(v.id) && typeof v.method !== \"string\" && (\"result\" in v || \"error\" in v);\n}\nexport function isEventFrame(v: unknown): v is EventFrame {\n return isObj(v) && typeof v.event === \"string\" && !(\"id\" in v);\n}\n\nexport type RequestHandler = (method: string, params: unknown) => Promise<unknown> | unknown;\ntype Listener = (data: unknown) => void;\n\nexport interface RpcEndpointOptions {\n /** Default request timeout in ms (default 30000, 0 disables). */\n timeoutMs?: number;\n /** Handles incoming requests. Throw ProviderRpcError to send a coded error. */\n onRequest?: RequestHandler;\n /** Return false to ignore a raw incoming message. */\n filter?: (ev: { data: unknown }) => boolean;\n /**\n * Session nonce. When set, every outgoing frame carries it and every incoming frame whose\n * `nonce` is missing or different is dropped (stale/forged sessions can't talk to this endpoint).\n */\n nonce?: string;\n}\n\ninterface Pending {\n resolve(v: unknown): void;\n reject(e: unknown): void;\n timer?: ReturnType<typeof setTimeout>;\n}\n\n/** Transport-agnostic JSON-RPC-ish endpoint: requests with ids, responses, events, timeouts. */\nexport class RpcEndpoint {\n private nextId = 1;\n private pending = new Map<number | string, Pending>();\n private listeners = new Map<string, Set<Listener>>();\n private onRequest?: RequestHandler;\n private closed = false;\n private readonly timeoutMs: number;\n private readonly nonce?: string;\n private readonly handleMessage: (ev: { data: unknown }) => void;\n\n constructor(private readonly transport: MessageLike, opts: RpcEndpointOptions = {}) {\n this.timeoutMs = opts.timeoutMs ?? 30000;\n this.onRequest = opts.onRequest;\n this.nonce = opts.nonce;\n const filter = opts.filter;\n this.handleMessage = (ev) => {\n if (this.closed) return;\n if (filter && !filter(ev)) return;\n if (this.nonce !== undefined) {\n const n = (ev.data as { nonce?: unknown } | null)?.nonce;\n if (typeof n !== \"string\" || n !== this.nonce) return;\n }\n this.dispatch(ev.data);\n };\n transport.addEventListener(\"message\", this.handleMessage);\n transport.start?.();\n }\n\n setRequestHandler(handler: RequestHandler | undefined): void {\n this.onRequest = handler;\n }\n\n request<T = unknown>(method: string, params?: unknown, timeoutMs?: number): Promise<T> {\n if (this.closed) {\n return Promise.reject(new ProviderRpcError(ErrorCodes.DISCONNECTED, \"Endpoint closed\"));\n }\n const id = this.nextId++;\n const ms = timeoutMs ?? this.timeoutMs;\n return new Promise<T>((resolve, reject) => {\n const entry: Pending = { resolve: resolve as (v: unknown) => void, reject };\n if (ms > 0) {\n entry.timer = setTimeout(() => {\n this.pending.delete(id);\n reject(new ProviderRpcError(ErrorCodes.INTERNAL, `Request timed out: ${method}`));\n }, ms);\n }\n this.pending.set(id, entry);\n const frame: RequestFrame = this.stamp(params === undefined ? { id, method } : { id, method, params });\n try {\n this.transport.postMessage(frame);\n } catch (e) {\n this.settle(id);\n reject(e);\n }\n });\n }\n\n emit(event: string, data?: unknown): void {\n if (this.closed) return;\n const frame: EventFrame = this.stamp(data === undefined ? { event } : { event, data });\n this.transport.postMessage(frame);\n }\n\n on(event: string, cb: Listener): () => void {\n let set = this.listeners.get(event);\n if (!set) this.listeners.set(event, (set = new Set()));\n set.add(cb);\n return () => this.off(event, cb);\n }\n\n off(event: string, cb: Listener): void {\n this.listeners.get(event)?.delete(cb);\n }\n\n close(): void {\n if (this.closed) return;\n this.closed = true;\n this.transport.removeEventListener?.(\"message\", this.handleMessage);\n for (const [id] of this.pending) {\n const p = this.settle(id);\n p?.reject(new ProviderRpcError(ErrorCodes.DISCONNECTED, \"Endpoint closed\"));\n }\n this.transport.close?.();\n this.dispatchLocal(\"close\", undefined);\n }\n\n get isClosed(): boolean {\n return this.closed;\n }\n\n private stamp<T extends object>(frame: T): T {\n return this.nonce === undefined ? frame : { ...frame, nonce: this.nonce };\n }\n\n private settle(id: number | string): Pending | undefined {\n const p = this.pending.get(id);\n if (p) {\n if (p.timer) clearTimeout(p.timer);\n this.pending.delete(id);\n }\n return p;\n }\n\n private dispatchLocal(event: string, data: unknown): void {\n for (const cb of Array.from(this.listeners.get(event) ?? [])) {\n try {\n cb(data);\n } catch {\n /* listener errors must not break the endpoint */\n }\n }\n }\n\n private dispatch(msg: unknown): void {\n if (isRequestFrame(msg)) {\n void this.handleRequest(msg);\n } else if (isResponseFrame(msg)) {\n const p = this.settle(msg.id);\n if (!p) return;\n if (msg.error && isErrorPayload(msg.error)) p.reject(ProviderRpcError.fromPayload(msg.error));\n else p.resolve(msg.result);\n } else if (isEventFrame(msg)) {\n this.dispatchLocal(msg.event, msg.data);\n }\n }\n\n private async handleRequest(req: RequestFrame): Promise<void> {\n let response: ResponseFrame;\n if (!this.onRequest) {\n response = {\n id: req.id,\n error: { code: ErrorCodes.UNSUPPORTED_METHOD, message: `Unsupported method: ${req.method}` },\n };\n } else {\n try {\n const result = await this.onRequest(req.method, req.params);\n response = { id: req.id, result: result === undefined ? null : result };\n } catch (e) {\n response = { id: req.id, error: ProviderRpcError.toPayload(e) };\n }\n }\n if (this.closed) return;\n try {\n this.transport.postMessage(this.stamp(response));\n } catch {\n /* peer gone */\n }\n }\n}\n\n/** Adapter for chrome.runtime.Port-like objects. */\nexport interface ChromePortLike {\n postMessage(message: unknown): void;\n onMessage: {\n addListener(cb: (message: unknown) => void): void;\n removeListener(cb: (message: unknown) => void): void;\n };\n disconnect?(): void;\n}\n\nexport function fromChromePort(port: ChromePortLike): MessageLike {\n const wrapped = new Map<(ev: { data: unknown }) => void, (m: unknown) => void>();\n return {\n postMessage: (m) => port.postMessage(m),\n addEventListener(_t, listener) {\n const w = (data: unknown) => listener({ data });\n wrapped.set(listener, w);\n port.onMessage.addListener(w);\n },\n removeEventListener(_t, listener) {\n const w = wrapped.get(listener);\n if (w) port.onMessage.removeListener(w);\n wrapped.delete(listener);\n },\n close: () => port.disconnect?.(),\n };\n}\n\n/**\n * Adapter for window.postMessage style transports. Messages are only accepted from\n * `target` (source identity check), and sent with the given targetOrigin.\n */\nexport function fromWindow(\n target: { postMessage(message: unknown, targetOrigin: string): void },\n listenOn: {\n addEventListener(t: \"message\", l: (ev: MessageEvent) => void): void;\n removeEventListener(t: \"message\", l: (ev: MessageEvent) => void): void;\n },\n targetOrigin = \"*\"\n): MessageLike {\n const wrapped = new Map<(ev: { data: unknown }) => void, (ev: MessageEvent) => void>();\n return {\n postMessage: (m) => target.postMessage(m, targetOrigin),\n addEventListener(_t, listener) {\n const w = (ev: MessageEvent) => {\n if (ev.source !== (target as unknown)) return;\n listener({ data: ev.data });\n };\n wrapped.set(listener, w);\n listenOn.addEventListener(\"message\", w);\n },\n removeEventListener(_t, listener) {\n const w = wrapped.get(listener);\n if (w) listenOn.removeEventListener(\"message\", w);\n wrapped.delete(listener);\n },\n };\n}\n","import {\n ErrorCodes,\n HELLO_TYPE,\n INIT_TYPE,\n PORT_TYPE,\n PROTOCOL_VERSION,\n ProviderRpcError,\n RpcEndpoint,\n createProviderFromEndpoint,\n requestProviders,\n type HelloMessage,\n type KnowhowProvider,\n} from \"@tyvm/knowhow-app-protocol\";\n\nexport const SDK_VERSION = \"0.1.0\";\n\nexport interface GetProviderOptions {\n /** How long to wait for the parent to transfer a port (default 5000ms). */\n handshakeTimeoutMs?: number;\n /**\n * When framed AND an injected (extension/desktop) provider is also present, how long to wait for\n * the parent frame to answer before falling back to the injected provider (default 1500ms).\n */\n parentProbeMs?: number;\n /**\n * Which host wins when both are available. \"host\" (default): the Knowhow page framing this app\n * (it already knows the app, owns the side chat and the app's tools). \"injected\": the extension/desktop.\n */\n prefer?: \"host\" | \"injected\";\n /** Resend interval for `kh:hello` while waiting (default 250ms). */\n helloIntervalMs?: number;\n /** Override window (tests). */\n window?: Window;\n}\n\nexport type DiscoveredKind = \"embedded\" | \"injected\";\n\nexport interface DiscoveredProvider {\n provider: KnowhowProvider;\n kind: DiscoveredKind;\n /** Announced provider name (injected only). */\n providerName?: string;\n}\n\nfunction discoverAnnounced(win: Window): { provider: KnowhowProvider; name: string } | null {\n let found: { provider: KnowhowProvider; name: string } | null = null;\n const stop = requestProviders((d) => {\n if (!found) found = { provider: d.provider, name: d.info?.name || \"Knowhow\" };\n }, win);\n stop();\n return found;\n}\n\ninterface ParentInit {\n origin: string;\n nonce: string;\n}\n\n/** Latest valid `kh:init` per window (captured early so a handshake started later still sees it). */\nconst initByWindow = new WeakMap<Window, ParentInit>();\nconst watchedWindows = new WeakSet<Window>();\n\nfunction originOf(url: string): string | undefined {\n try {\n const o = new URL(url).origin;\n return o && o !== \"null\" ? o : undefined;\n } catch {\n return undefined;\n }\n}\n\n/**\n * The parent origin must be who actually frames us: `location.ancestorOrigins[0]` where available\n * (Chromium/Safari), else the `document.referrer` origin (when it is not our own origin, i.e. we were\n * not reached by in-app navigation). When neither is available the init message's own origin is used.\n */\nexport function isTrustedParentOrigin(win: Window, origin: string): boolean {\n if (!origin || origin === \"null\") return false;\n try {\n const ancestors = win.location?.ancestorOrigins;\n if (ancestors && ancestors.length > 0) return ancestors[0] === origin;\n } catch {\n /* fall through */\n }\n try {\n const ref = win.document?.referrer ? originOf(win.document.referrer) : undefined;\n const own = originOf(win.location?.href ?? \"\");\n if (ref && ref !== own) return ref === origin;\n } catch {\n /* fall through */\n }\n return true;\n}\n\nfunction readInit(win: Window, ev: MessageEvent): ParentInit | null {\n if (ev.source !== win.parent) return null;\n const data: unknown = ev.data;\n if (typeof data !== \"object\" || data === null) return null;\n const d = data as { type?: unknown; protocol?: unknown; nonce?: unknown };\n if (d.type !== INIT_TYPE || d.protocol !== PROTOCOL_VERSION) return null;\n if (typeof d.nonce !== \"string\" || d.nonce.length < 8) return null;\n if (!isTrustedParentOrigin(win, ev.origin)) return null;\n return { origin: ev.origin, nonce: d.nonce };\n}\n\n/**\n * Starts listening for the host's per-load `kh:init` (origin + nonce). Idempotent. Called when the SDK\n * is created so the init is not missed if the app asks for the provider later than the iframe `load`.\n */\nexport function watchParentInit(win: Window): void {\n if (!win.parent || win.parent === win || watchedWindows.has(win)) return;\n watchedWindows.add(win);\n win.addEventListener(\"message\", (ev: MessageEvent) => {\n const init = readInit(win, ev);\n if (init) initByWindow.set(win, init);\n });\n}\n\nfunction handshakeWithParent(win: Window, opts: GetProviderOptions): Promise<KnowhowProvider> {\n const timeoutMs = opts.handshakeTimeoutMs ?? 5000;\n const intervalMs = opts.helloIntervalMs ?? 250;\n const parent = win.parent;\n watchParentInit(win);\n return new Promise<KnowhowProvider>((resolve, reject) => {\n let interval: ReturnType<typeof setInterval> | undefined;\n let timer: ReturnType<typeof setTimeout> | undefined;\n let init: ParentInit | undefined = initByWindow.get(win);\n const cleanup = () => {\n win.removeEventListener(\"message\", onMessage);\n if (interval) clearInterval(interval);\n if (timer) clearTimeout(timer);\n };\n const send = () => {\n if (!init) return; // never talk to a parent whose origin/nonce we haven't learned\n const hello: HelloMessage = {\n type: HELLO_TYPE,\n protocol: PROTOCOL_VERSION,\n sdkVersion: SDK_VERSION,\n nonce: init.nonce,\n };\n parent.postMessage(hello, init.origin);\n };\n const onMessage = (ev: MessageEvent) => {\n const fresh = readInit(win, ev);\n if (fresh) {\n const changed = !init || init.nonce !== fresh.nonce || init.origin !== fresh.origin;\n init = fresh;\n initByWindow.set(win, fresh);\n if (changed) send();\n return;\n }\n if (!init || ev.source !== parent || ev.origin !== init.origin) return;\n const data: unknown = ev.data;\n if (typeof data !== \"object\" || data === null) return;\n const d = data as { type?: unknown; nonce?: unknown };\n if (d.type !== PORT_TYPE || d.nonce !== init.nonce) return;\n const port = ev.ports && ev.ports[0];\n if (!port) return;\n cleanup();\n const endpoint = new RpcEndpoint(port, { nonce: init.nonce });\n resolve(createProviderFromEndpoint(endpoint));\n };\n win.addEventListener(\"message\", onMessage);\n send();\n interval = setInterval(send, intervalMs);\n timer = setTimeout(() => {\n cleanup();\n reject(new ProviderRpcError(ErrorCodes.DISCONNECTED, \"Knowhow host did not respond to kh:hello\"));\n }, timeoutMs);\n });\n}\n\n/**\n * Discovery order (default `prefer: \"host\"`):\n * - framed: parent iframe MessagePort handshake first. If an injected provider is also present the\n * parent only gets `parentProbeMs` to answer, then we fall back to the injected provider. This keeps\n * the extension from hijacking apps opened inside the Knowhow site (whose host owns the session,\n * side chat and app tools), while apps framed by non-Knowhow pages still reach the extension.\n * - top-level: announced/injected provider.\n * - otherwise throw.\n * `prefer: \"injected\"` restores injected-first.\n * (Mock mode is handled by the `knowhow` facade.)\n */\nexport async function discoverProvider(opts: GetProviderOptions = {}): Promise<DiscoveredProvider> {\n const win = opts.window ?? (typeof window !== \"undefined\" ? window : undefined);\n if (!win) throw new ProviderRpcError(ErrorCodes.DISCONNECTED, \"No window: Knowhow provider unavailable\");\n const framed = !!win.parent && win.parent !== win;\n const announced = discoverAnnounced(win);\n const injected = (a: { provider: KnowhowProvider; name: string }): DiscoveredProvider => ({\n provider: a.provider,\n kind: \"injected\",\n providerName: a.name,\n });\n if (announced && (opts.prefer === \"injected\" || !framed)) return injected(announced);\n if (framed) {\n const timeoutMs = announced ? opts.parentProbeMs ?? 1500 : opts.handshakeTimeoutMs;\n try {\n const provider = await handshakeWithParent(win, { ...opts, handshakeTimeoutMs: timeoutMs });\n return { provider, kind: \"embedded\" };\n } catch (e) {\n if (announced) return injected(announced);\n throw e;\n }\n }\n throw new ProviderRpcError(\n ErrorCodes.DISCONNECTED,\n \"No Knowhow provider found (not embedded in Knowhow and no extension installed). Call knowhow.mock() for local development.\"\n );\n}\n\nexport async function getProvider(opts: GetProviderOptions = {}): Promise<KnowhowProvider> {\n return (await discoverProvider(opts)).provider;\n}\n","import type {\n AppFileInfo,\n FilesDeleteResult,\n FilesDownloadUrlResult,\n FilesListResult,\n FilesScope,\n FilesStatResult,\n FilesUploadCompleteResult,\n FilesUploadStartResult,\n} from \"@tyvm/knowhow-app-protocol\";\nimport { Methods } from \"@tyvm/knowhow-app-protocol\";\n\n/** Provider call signature (same shape as the SDK's internal `call`). */\nexport type FilesCall = <M extends string>(method: M, params?: unknown) => Promise<unknown>;\n\nexport interface FilesOptions {\n /** \"user\" (default): private to the signed-in user. \"org\": shared with the organization. */\n scope?: FilesScope;\n}\nexport interface PutOptions extends FilesOptions {\n contentType?: string;\n /** Called with bytes sent so far (browser XHR upload progress). */\n onProgress?: (loaded: number, total: number) => void;\n signal?: AbortSignal;\n}\nexport interface GetOptions extends FilesOptions {\n onProgress?: (loaded: number, total: number) => void;\n signal?: AbortSignal;\n /** Inclusive byte range (HTTP Range), e.g. `{ start: 0, end: 1023 }` for the first KiB. */\n range?: { start: number; end?: number };\n}\n\n/** Data accepted by `files.put`. */\nexport type FileData = Blob | ArrayBuffer | ArrayBufferView;\n\n/** In-memory object store used by the mock provider (`mock-blob:` urls). */\nexport const mockBlobStore = new Map<string, Blob>();\nexport const MOCK_URL_PREFIX = \"mock-blob:\";\n\nfunction toBlob(data: FileData, contentType?: string): Blob {\n if (typeof Blob !== \"undefined\" && data instanceof Blob) {\n return contentType && !data.type ? data.slice(0, data.size, contentType) : data;\n }\n const part = (ArrayBuffer.isView(data) ? data : new Uint8Array(data as ArrayBuffer)) as BlobPart;\n return new Blob([part], contentType ? { type: contentType } : undefined);\n}\n\nfunction abortError() {\n const e = new Error(\"Aborted\");\n e.name = \"AbortError\";\n return e;\n}\n\n/** PUT with upload progress. XHR when available (fetch has no upload progress), else fetch. */\nasync function putBlob(url: string, blob: Blob, opts: PutOptions) {\n if (url.startsWith(MOCK_URL_PREFIX)) {\n mockBlobStore.set(url, blob);\n opts.onProgress?.(blob.size, blob.size);\n return;\n }\n const headers: Record<string, string> = {};\n if (blob.type) headers[\"Content-Type\"] = blob.type;\n if (typeof XMLHttpRequest !== \"undefined\" && opts.onProgress) {\n await new Promise<void>((resolve, reject) => {\n const xhr = new XMLHttpRequest();\n xhr.open(\"PUT\", url);\n for (const [k, v] of Object.entries(headers)) xhr.setRequestHeader(k, v);\n xhr.upload.onprogress = (ev) => {\n if (ev.lengthComputable) opts.onProgress?.(ev.loaded, ev.total);\n };\n xhr.onload = () =>\n xhr.status >= 200 && xhr.status < 300 ? resolve() : reject(new Error(`Upload failed (${xhr.status})`));\n xhr.onerror = () => reject(new Error(\"Upload failed (network error)\"));\n xhr.onabort = () => reject(abortError());\n if (opts.signal) {\n if (opts.signal.aborted) return reject(abortError());\n opts.signal.addEventListener(\"abort\", () => xhr.abort(), { once: true });\n }\n xhr.send(blob);\n });\n return;\n }\n const res = await fetch(url, { method: \"PUT\", body: blob, headers, signal: opts.signal });\n if (!res.ok) throw new Error(`Upload failed (${res.status})`);\n opts.onProgress?.(blob.size, blob.size);\n}\n\nasync function getBlob(url: string, opts: GetOptions): Promise<Blob> {\n if (url.startsWith(MOCK_URL_PREFIX)) {\n const b = mockBlobStore.get(url);\n if (!b) throw new Error(\"Download failed (404)\");\n const out = opts.range ? b.slice(opts.range.start, (opts.range.end ?? b.size - 1) + 1) : b;\n opts.onProgress?.(out.size, out.size);\n return out;\n }\n const headers: Record<string, string> = {};\n if (opts.range) headers.Range = `bytes=${opts.range.start}-${opts.range.end ?? \"\"}`;\n const res = await fetch(url, { headers, signal: opts.signal });\n if (!res.ok) throw new Error(`Download failed (${res.status})`);\n const total = Number(res.headers.get(\"content-length\")) || 0;\n const type = res.headers.get(\"content-type\") ?? \"\";\n if (!opts.onProgress || !res.body) return res.blob();\n const reader = res.body.getReader();\n const chunks: BlobPart[] = [];\n let loaded = 0;\n for (;;) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value as BlobPart);\n loaded += value.byteLength;\n opts.onProgress(loaded, total || loaded);\n }\n return new Blob(chunks, type ? { type } : undefined);\n}\n\n/**\n * `knowhow.files` scoped storage (capability `files:app`).\n *\n * Files live under an app-sandboxed root chosen by Knowhow (never by the app): for a website\n * `/apps/<host[:port]>[/<app-id>]/…`, for a registered app its own folder. Paths you pass are always\n * relative to that root; `..`, absolute paths and backslashes are rejected by the backend.\n */\nexport function createFilesApi(call: FilesCall) {\n const scoped = (o?: FilesOptions) => ({ scope: o?.scope ?? \"user\" });\n return {\n /** Folder listing (≤ 1000 entries) of the scoped storage; `prefix` is a folder relative to the root. */\n async listScoped(prefix?: string, opts?: FilesOptions): Promise<AppFileInfo[]> {\n const r = (await call(Methods.FilesList, { ...(prefix ? { path: prefix } : {}), ...scoped(opts) })) as FilesListResult;\n return r.files;\n },\n async stat(path: string, opts?: FilesOptions): Promise<AppFileInfo | null> {\n const r = (await call(Methods.FilesStat, { path, ...scoped(opts) })) as FilesStatResult;\n return r.file;\n },\n async delete(path: string, opts?: FilesOptions): Promise<boolean> {\n const r = (await call(Methods.FilesDelete, { path, ...scoped(opts) })) as FilesDeleteResult;\n return r.deleted;\n },\n /** Short-lived presigned download URL (usable as `<video src>`; S3 serves Range requests). */\n async url(path: string, opts?: FilesOptions): Promise<string> {\n const r = (await call(Methods.FilesDownloadUrl, { path, ...scoped(opts) })) as FilesDownloadUrlResult;\n return r.url;\n },\n /** Download to a Blob (optionally a byte range) with progress. */\n async get(path: string, opts: GetOptions = {}): Promise<Blob> {\n const r = (await call(Methods.FilesDownloadUrl, { path, ...scoped(opts) })) as FilesDownloadUrlResult;\n return getBlob(r.url, opts);\n },\n /**\n * Upload (any size up to 2 GiB - 1 byte): asks the host for a presigned URL, PUTs the bytes straight to\n * storage (they never pass through the provider), then verifies the upload.\n */\n async put(path: string, data: FileData, opts: PutOptions = {}): Promise<AppFileInfo> {\n const blob = toBlob(data, opts.contentType);\n const start = (await call(Methods.FilesUploadStart, {\n path,\n size: blob.size,\n contentType: opts.contentType || blob.type || undefined,\n ...scoped(opts),\n })) as FilesUploadStartResult;\n await putBlob(start.uploadUrl, blob, opts);\n const done = (await call(Methods.FilesUploadComplete, { id: start.id, ...scoped(opts) })) as FilesUploadCompleteResult;\n return done.file;\n },\n };\n}\n","import {\n CAPABILITIES,\n ErrorCodes,\n Methods,\n PROTOCOL_VERSION,\n ProviderRpcError,\n AI_IMAGE_MAX_N,\n AI_IMAGE_MAX_INPUTS,\n AI_TRANSCRIBE_MAX_AUDIO_BYTES,\n type AiCompleteParams,\n type AiImageParams,\n type AiImageResult,\n type AiTranscribeParams,\n type AiTranscribeResult,\n type JsonValue,\n type KnowhowProvider,\n type ProviderListener,\n type SessionInfo,\n} from \"@tyvm/knowhow-app-protocol\";\nimport { MOCK_URL_PREFIX, mockBlobStore } from \"./files\";\n\n/** Optional pluggable DB (e.g. backed by sql.js). Receives raw method name + params. */\nexport type MockDbHandler = (method: string, params: unknown) => Promise<unknown> | unknown;\n\nexport interface MockOptions {\n user?: { displayName: string };\n /** Provide a db implementation (e.g. sql.js) — otherwise db calls throw. */\n db?: MockDbHandler;\n /** Environment returned by `knowhow.app.env()` (default `{ name: \"dev\", vars: {} }`). */\n env?: { name: string; vars?: Record<string, string> };\n}\n\nexport interface MockProvider extends KnowhowProvider {\n /** Simulate the host calling an app tool. Resolves with the handler result. */\n callTool(name: string, args?: Record<string, JsonValue>): Promise<unknown>;\n}\n\n/** 1x1 transparent PNG used as the deterministic fake generated image. */\nconst MOCK_PNG_BASE64 =\n \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\";\n\nconst MOCK_TRANSCRIPT_WORDS = [\"This\", \"is\", \"a\", \"mock\", \"transcript\", \"from\", \"the\", \"Knowhow\", \"app\", \"SDK.\"];\nconst MOCK_WORD_SECONDS = 0.5;\n\nfunction decodedBase64Bytes(audio: string): number {\n const comma = audio.startsWith(\"data:\") ? audio.indexOf(\",\") : -1;\n const b64 = (comma >= 0 ? audio.slice(comma + 1) : audio).replace(/\\s+/g, \"\");\n const padding = b64.endsWith(\"==\") ? 2 : b64.endsWith(\"=\") ? 1 : 0;\n return Math.floor((b64.length * 3) / 4) - padding;\n}\n\n/** Deterministic fake transcript: ten words, 0.5s each, one segment. */\nfunction mockTranscribe(params: AiTranscribeParams): AiTranscribeResult {\n if (typeof params.audio !== \"string\" || !params.audio) {\n throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, \"audio is required\");\n }\n if (decodedBase64Bytes(params.audio) > AI_TRANSCRIBE_MAX_AUDIO_BYTES) {\n throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, \"audio exceeds 25 MB\");\n }\n const timestamps = params.timestamps ?? [\"word\", \"segment\"];\n const words = MOCK_TRANSCRIPT_WORDS.map((word, i) => ({\n start: i * MOCK_WORD_SECONDS,\n end: (i + 1) * MOCK_WORD_SECONDS,\n word,\n }));\n const duration = words.length * MOCK_WORD_SECONDS;\n const text = MOCK_TRANSCRIPT_WORDS.join(\" \");\n return {\n text,\n language: params.language ?? \"en\",\n duration,\n model: params.model ?? \"mock\",\n segments: timestamps.includes(\"segment\") ? [{ start: 0, end: duration, text }] : [],\n words: timestamps.includes(\"word\") ? words : [],\n };\n}\n\n/** Deterministic fake image(s): a 1x1 PNG data URL per requested image. */\nfunction mockImage(params: AiImageParams): AiImageResult {\n if (typeof params.prompt !== \"string\" || !params.prompt.trim()) {\n throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, \"prompt is required\");\n }\n if (params.images !== undefined && (!Array.isArray(params.images) || params.images.length < 1 || params.images.length > AI_IMAGE_MAX_INPUTS)) {\n throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, `images must be an array of 1..${AI_IMAGE_MAX_INPUTS} image data URLs`);\n }\n const n = params.n ?? 1;\n if (!Number.isInteger(n) || n < 1 || n > AI_IMAGE_MAX_N) {\n throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, `n must be an integer between 1 and ${AI_IMAGE_MAX_N}`);\n }\n return {\n model: params.model ?? \"mock\",\n images: Array.from({ length: n }, () => ({\n dataUrl: `data:image/png;base64,${MOCK_PNG_BASE64}`,\n revisedPrompt: `[mock] ${params.prompt}`,\n })),\n };\n}\n\n/** In-memory provider for local development outside Knowhow. Never touches storage APIs. */\nexport function createMockProvider(opts: MockOptions = {}): MockProvider {\n const kv = new Map<string, JsonValue>();\n const files = new Map<string, string>();\n /** Scoped storage: `${scope}:${path}` -> metadata (bytes live in mockBlobStore under `mock-blob:<id>`). */\n const scoped = new Map<string, { id: string; size: number; mime: string; updatedAt: string; done: boolean }>();\n const scopedOf = (p: Record<string, unknown>) => (p.scope === \"org\" ? \"org\" : \"user\");\n const scopedKey = (p: Record<string, unknown>) => {\n const path = String(p.path ?? \"\");\n if (!path || path.startsWith(\"/\") || path.split(\"/\").some((s) => s === \"..\" ) || path.includes(\"\\\\\")) {\n throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, \"Invalid path\");\n }\n return `${scopedOf(p)}:${path.split(\"/\").filter((s) => s && s !== \".\").join(\"/\")}`;\n };\n const scopedView = (key: string) => {\n const m = scoped.get(key)!;\n const [scope, ...rest] = key.split(\":\");\n const path = rest.join(\":\");\n return { id: m.id, name: path.split(\"/\").pop() ?? path, path, size: m.size, mime: m.mime, updatedAt: m.updatedAt, scope };\n };\n const listeners = new Map<string, Set<ProviderListener>>();\n const pendingTools = new Map<string, { resolve(v: unknown): void; reject(e: Error): void }>();\n let session: SessionInfo | null = null;\n let callSeq = 0;\n\n const emit = (event: string, data?: unknown) => {\n for (const l of Array.from(listeners.get(event) ?? [])) l(data);\n };\n\n const dbMethods: string[] = [Methods.DbQuery, Methods.DbExec, Methods.DbBatch];\n const methods = Object.values(Methods) as string[];\n\n async function request(method: string, params: unknown): Promise<unknown> {\n const p = (params ?? {}) as Record<string, unknown>;\n switch (method) {\n case Methods.Protocol:\n return { protocol: PROTOCOL_VERSION, methods, host: { kind: \"web\", version: \"mock\" } };\n case Methods.Connect: {\n session = {\n appId: (p.appId as string | undefined) ?? \"mock-app\",\n user: opts.user ?? { displayName: \"Mock User\" },\n capabilities: [...CAPABILITIES],\n };\n emit(\"connect\", session);\n emit(\"sessionChanged\", session);\n return session;\n }\n case Methods.Session:\n return session;\n case Methods.Disconnect:\n session = null;\n emit(\"disconnect\");\n return true;\n }\n if (!session) throw new ProviderRpcError(ErrorCodes.UNAUTHORIZED, \"Not connected\");\n if (dbMethods.includes(method)) {\n if (!opts.db) throw new ProviderRpcError(ErrorCodes.INTERNAL, \"db not available in mock\");\n return opts.db(method, params);\n }\n switch (method) {\n case Methods.KvGet:\n return { value: kv.has(String(p.key)) ? (kv.get(String(p.key)) as JsonValue) : null };\n case Methods.KvSet:\n kv.set(String(p.key), p.value as JsonValue);\n return true;\n case Methods.KvDelete:\n kv.delete(String(p.key));\n return true;\n case Methods.FilesStat: {\n const key = scopedKey(p);\n return { file: scoped.get(key)?.done ? scopedView(key) : null };\n }\n case Methods.FilesDelete: {\n const key = scopedKey(p);\n const m = scoped.get(key);\n if (m) mockBlobStore.delete(`${MOCK_URL_PREFIX}${m.id}`);\n return { deleted: scoped.delete(key) };\n }\n case Methods.FilesUploadStart: {\n const key = scopedKey(p);\n const id = `mock-file-${scoped.size + 1}-${key}`;\n scoped.set(key, {\n id,\n size: Number(p.size) || 0,\n mime: typeof p.contentType === \"string\" ? p.contentType : \"application/octet-stream\",\n updatedAt: new Date().toISOString(),\n done: false,\n });\n return { id, uploadUrl: `${MOCK_URL_PREFIX}${id}`, method: \"PUT\", maxBytes: Number(p.size) || 0 };\n }\n case Methods.FilesUploadComplete: {\n const entry = Array.from(scoped.entries()).find(([, m]) => m.id === p.id);\n if (!entry) throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, \"File not found\");\n const blob = mockBlobStore.get(`${MOCK_URL_PREFIX}${entry[1].id}`);\n entry[1].size = blob?.size ?? entry[1].size;\n entry[1].done = true;\n return { file: scopedView(entry[0]) };\n }\n case Methods.FilesDownloadUrl: {\n const key = scopedKey(p);\n const m = scoped.get(key);\n if (!m?.done) throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, \"File not found\");\n return { url: `${MOCK_URL_PREFIX}${m.id}`, file: scopedView(key) };\n }\n case Methods.FilesList:\n if (p.scope !== undefined) {\n const scope = scopedOf(p);\n const prefix = typeof p.path === \"string\" && p.path ? `${scope}:${p.path.replace(/\\/+$/, \"\")}/` : `${scope}:`;\n return {\n files: Array.from(scoped.keys())\n .filter((k) => k.startsWith(prefix) && scoped.get(k)!.done)\n .map(scopedView),\n };\n }\n return {\n files: Array.from(files.entries()).map(([path, text]) => ({\n id: path,\n name: path.split(\"/\").pop() ?? path,\n path,\n size: text.length,\n mime: \"text/plain\",\n updatedAt: new Date(0).toISOString(),\n })),\n };\n case Methods.FilesRead: {\n const text = files.get(String(p.path));\n if (text === undefined) throw new ProviderRpcError(ErrorCodes.INVALID_PARAMS, \"File not found\");\n return { text };\n }\n case Methods.FilesWrite:\n files.set(String(p.path), String(p.text));\n return { id: String(p.path) };\n case Methods.AiComplete: {\n const msgs = (p as unknown as AiCompleteParams).messages ?? [];\n const last = msgs[msgs.length - 1];\n return { content: `[mock] ${last ? last.content : \"\"}`, model: \"mock\" };\n }\n case Methods.AiTranscribe:\n return mockTranscribe(p as unknown as AiTranscribeParams);\n case Methods.AiImage:\n return mockImage(p as unknown as AiImageParams);\n case Methods.AppEnv:\n return { name: opts.env?.name ?? \"dev\", vars: { ...(opts.env?.vars ?? {}) } };\n case Methods.SpendGet:\n return {\n spendLimitUsd: 5,\n spendPeriod: \"month\",\n spentUsd: 0,\n spentUsdTotal: 0,\n periodResetsAt: null,\n aiRequestsTotal: 0,\n };\n case Methods.ToolsRegister:\n return true;\n case Methods.ToolsResult: {\n const entry = pendingTools.get(String(p.callId));\n if (entry) {\n pendingTools.delete(String(p.callId));\n if (p.error) entry.reject(new Error(String(p.error)));\n else entry.resolve(p.result);\n }\n return true;\n }\n case Methods.UiNotify:\n console.info(\"[knowhow mock] notify:\", p.message);\n return true;\n default:\n throw new ProviderRpcError(ErrorCodes.UNSUPPORTED_METHOD, `Unsupported method: ${method}`);\n }\n }\n\n return {\n request: <T = unknown>(args: { method: string; params?: unknown }) => request(args.method, args.params) as Promise<T>,\n on(event, listener) {\n let set = listeners.get(event);\n if (!set) listeners.set(event, (set = new Set()));\n set.add(listener);\n },\n removeListener(event, listener) {\n listeners.get(event)?.delete(listener);\n },\n callTool(name, args = {}) {\n const callId = `mock-${++callSeq}`;\n return new Promise((resolve, reject) => {\n pendingTools.set(callId, { resolve, reject });\n emit(\"toolCall\", { callId, name, args });\n });\n },\n };\n}\n","import {\n Events,\n ErrorCodes,\n Methods,\n ProviderRpcError,\n requestProviders,\n type AiCompleteParams,\n type AiCompleteResult,\n type AiImageParams,\n type AiImageResult,\n type AppEnvView,\n type SpendView,\n type AiTranscribeParams,\n type AiTranscribeResult,\n type AppFileInfo,\n type Capability,\n type DbBatchResult,\n type DbExecResult,\n type DbQueryResult,\n type FilesReadResult,\n type JsonObject,\n type JsonValue,\n type KnowhowProvider,\n type MethodMap,\n type NotifyLevel,\n type ProtocolResult,\n type SessionInfo,\n type SqlParam,\n type SqlStatement,\n type ToolCallEvent,\n type ToolDefinition,\n} from \"@tyvm/knowhow-app-protocol\";\nimport { discoverProvider, watchParentInit, type DiscoveredProvider, type GetProviderOptions } from \"./provider\";\nimport { createMockProvider, type MockOptions, type MockProvider } from \"./mock\";\nimport { createFilesApi, type FilesCall, type FilesOptions } from \"./files\";\n\nexport type ToolHandler = (args: JsonObject) => Promise<JsonValue | void> | JsonValue | void;\n\nexport interface RegisterToolInput {\n name: string;\n description: string;\n /** JSON schema for the arguments. */\n parameters: JsonObject;\n /** True for tools that never change state (list/search/read); hosts may auto-run them without approval. */\n readOnly?: boolean;\n handler: ToolHandler;\n}\n\nexport interface CreateKnowhowOptions extends GetProviderOptions {\n /** Custom provider factory (tests, embedding). Defaults to discovery. */\n getProvider?: () => Promise<KnowhowProvider>;\n /**\n * App id or alias this app claims when connecting through an injected provider (browser extension,\n * desktop shell). Falls back to `<meta name=\"knowhow-app-id\">`. Ignored by iframe hosts, which\n * already know which app they loaded. Leave it unset for a self-hosted site (no Knowhow app entry): the\n * extension then connects the page as a site, identified by its origin.\n */\n appId?: string;\n}\n\nexport interface ConnectOptions {\n /** Overrides the configured / meta-tag app id for this connect call. */\n appId?: string;\n}\n\n/** Where (if anywhere) a Knowhow host is reachable from this page. */\nexport type HostKind = \"embedded\" | \"injected\" | \"mock\" | \"none\";\n\nexport interface HostDetection {\n kind: HostKind;\n /** Announced provider name (injected hosts only), e.g. \"Knowhow Extension\". */\n providerName?: string;\n}\n\nexport interface DetectOptions {\n /** How long to wait for a late provider announcement (default 300ms). */\n timeoutMs?: number;\n}\n\nfunction readMetaAppId(win: Window | undefined): string | undefined {\n try {\n const el = win?.document?.querySelector('meta[name=\"knowhow-app-id\"]');\n const v = el?.getAttribute(\"content\")?.trim();\n return v || undefined;\n } catch {\n return undefined;\n }\n}\n\ntype Listener = (data: unknown) => void;\nconst FORWARDED_EVENTS: string[] = [Events.Connect, Events.Disconnect, Events.SessionChanged, Events.Message];\n\nexport function createKnowhow(options: CreateKnowhowOptions = {}) {\n let mocked = false;\n let mockOptions: MockOptions | undefined;\n let providerPromise: Promise<KnowhowProvider> | null = null;\n /** One discovery per instance: hosts ignore a duplicate kh:hello, so detect() and loadProvider() share it. */\n let discovery: Promise<DiscoveredProvider> | null = null;\n let hostKind: HostKind | null = null;\n let hostName: string | undefined;\n let prefer: GetProviderOptions[\"prefer\"] = options.prefer;\n let protocol: ProtocolResult | null = null;\n let session: SessionInfo | null = null;\n let configuredAppId: string | undefined = options.appId;\n const getWin = (): Window | undefined => options.window ?? (typeof window !== \"undefined\" ? window : undefined);\n {\n // Capture the host's per-load `kh:init` (parent origin + nonce) before the app first asks for the provider.\n const w = getWin();\n if (w && !options.getProvider) watchParentInit(w);\n }\n const resolveAppId = (override?: string) => override ?? configuredAppId ?? readMetaAppId(getWin());\n const listeners = new Map<string, Set<Listener>>();\n const toolHandlers = new Map<string, RegisterToolInput>();\n\n const emitLocal = (event: string, data: unknown) => {\n for (const cb of Array.from(listeners.get(event) ?? [])) cb(data);\n };\n\n async function runToolCall(provider: KnowhowProvider, call: ToolCallEvent) {\n const tool = toolHandlers.get(call.name);\n try {\n if (!tool) throw new Error(`Unknown tool: ${call.name}`);\n const out = await tool.handler(call.args ?? {});\n await provider.request({\n method: Methods.ToolsResult,\n params: { callId: call.callId, result: out === undefined ? null : out },\n });\n } catch (e) {\n await provider\n .request({\n method: Methods.ToolsResult,\n params: { callId: call.callId, error: e instanceof Error ? e.message : String(e) },\n })\n .catch(() => undefined);\n }\n }\n\n function discover(): Promise<DiscoveredProvider> {\n if (!discovery) {\n discovery = (\n options.getProvider\n ? options.getProvider().then((provider): DiscoveredProvider => ({ provider, kind: \"embedded\" }))\n : discoverProvider({ ...options, prefer })\n ).then((d) => {\n hostKind = d.kind;\n hostName = d.providerName;\n return d;\n });\n discovery.catch(() => {\n discovery = null;\n });\n }\n return discovery;\n }\n\n function loadProvider(): Promise<KnowhowProvider> {\n if (!providerPromise) {\n const make = mocked\n ? async () => createMockProvider(mockOptions)\n : async () => (await discover()).provider;\n providerPromise = make().then(async (provider) => {\n for (const ev of FORWARDED_EVENTS) {\n provider.on(ev, (data) => {\n if (ev === Events.SessionChanged) session = (data as SessionInfo | null) ?? null;\n if (ev === Events.Disconnect) session = null;\n emitLocal(ev, data);\n });\n }\n provider.on(Events.ToolCall, (data) => void runToolCall(provider, data as ToolCallEvent));\n protocol = await provider.request<ProtocolResult>({ method: Methods.Protocol });\n return provider;\n });\n providerPromise.catch(() => {\n providerPromise = null;\n });\n }\n return providerPromise;\n }\n\n async function connectInternal(capabilities?: Capability[], opts: ConnectOptions = {}): Promise<SessionInfo> {\n const provider = await loadProvider();\n const params: MethodMap[\"kh_connect\"][\"params\"] = capabilities ? { capabilities } : {};\n const appId = resolveAppId(opts.appId);\n if (appId) params.appId = appId;\n session = await provider.request<SessionInfo>({ method: Methods.Connect, params });\n return session;\n }\n\n /** Call a provider method, feature-detecting via kh_protocol and auto-connecting if needed. */\n async function call<M extends keyof MethodMap>(\n method: M,\n params?: MethodMap[M][\"params\"]\n ): Promise<MethodMap[M][\"result\"]> {\n const provider = await loadProvider();\n if (protocol && !protocol.methods.includes(method)) {\n throw new ProviderRpcError(ErrorCodes.UNSUPPORTED_METHOD, `Host does not support ${method}`);\n }\n if (!session) {\n const existing = await provider.request<SessionInfo | null>({ method: Methods.Session });\n session = existing;\n if (!session) await connectInternal();\n }\n return provider.request<MethodMap[M][\"result\"]>({ method, params });\n }\n\n const pushTools = async () => {\n const tools: ToolDefinition[] = Array.from(toolHandlers.values()).map((t) => ({\n name: t.name,\n description: t.description,\n parameters: t.parameters,\n ...(t.readOnly === undefined ? {} : { readOnly: t.readOnly }),\n }));\n await call(Methods.ToolsRegister, { tools });\n };\n\n const filesApi = createFilesApi(call as unknown as FilesCall);\n\n return {\n /** Resolve the provider and fetch protocol info. */\n async ready(): Promise<ProtocolResult> {\n await loadProvider();\n return protocol as ProtocolResult;\n },\n get session(): SessionInfo | null {\n return session;\n },\n /** True if the connected host supports `method` (after ready()). */\n supports(method: string): boolean {\n return !!protocol && protocol.methods.includes(method);\n },\n /**\n * Ask the host for a session. Iframe hosts know the app already. Injected hosts (extension, desktop)\n * resolve a registered app from an app id or alias — pass `{ appId }`, call `configure({ appId })`, or add\n * the meta tag. With NO app id the extension opens a *self-hosted site* session instead: bound to the page's\n * real origin, limited to ai:* / db:app, billed to the visitor (`session.site.origin` is set).\n */\n connect: (capabilities?: Capability[], opts?: ConnectOptions) => connectInternal(capabilities, opts),\n /**\n * Set defaults before connecting. `prefer` picks the host when an app is framed by Knowhow AND an\n * extension/desktop provider is injected: \"host\" (default) or \"injected\". Must be set before the\n * provider is first resolved.\n */\n configure(opts: { appId?: string; prefer?: \"host\" | \"injected\" }): void {\n if (\"appId\" in opts) configuredAppId = opts.appId;\n if (\"prefer\" in opts) prefer = opts.prefer;\n },\n /** Which host the SDK actually connected through (after ready()/detect()), or null if unresolved. */\n get host(): HostDetection | null {\n if (mocked) return { kind: \"mock\" };\n return hostKind ? { kind: hostKind, ...(hostName ? { providerName: hostName } : {}) } : null;\n },\n /** The app id/alias that will be claimed on connect (config → meta tag), if any. */\n get appId(): string | undefined {\n return resolveAppId();\n },\n /**\n * Non-throwing host detection for building a connect screen. Never prompts the user:\n * \"embedded\" = inside a Knowhow iframe host, \"injected\" = an extension/desktop provider announced\n * itself, \"none\" = standalone (offer install / open-in-Knowhow / mock). When framed this performs the\n * (shared, non-prompting) parent handshake so it reports the host that will actually be used.\n */\n async detect(opts: DetectOptions = {}): Promise<HostDetection> {\n if (mocked) return { kind: \"mock\" };\n const win = getWin();\n if (!win) return { kind: \"none\" };\n if (win.parent && win.parent !== win) {\n try {\n const d = await discover();\n return { kind: d.kind, ...(d.providerName ? { providerName: d.providerName } : {}) };\n } catch {\n return { kind: \"none\" };\n }\n }\n const name = await new Promise<string | null>((resolve) => {\n let done = false;\n let timer: ReturnType<typeof setTimeout> | undefined;\n let stop: () => void = () => undefined;\n const finish = (v: string | null) => {\n if (done) return;\n done = true;\n if (timer) clearTimeout(timer);\n stop();\n resolve(v);\n };\n stop = requestProviders((d) => finish(d.info.name || \"Knowhow\"), win);\n if (done) stop();\n else timer = setTimeout(() => finish(null), opts.timeoutMs ?? 300);\n });\n if (name) return { kind: \"injected\", providerName: name };\n return { kind: \"none\" };\n },\n async disconnect(): Promise<void> {\n const provider = await loadProvider();\n await provider.request({ method: Methods.Disconnect });\n session = null;\n },\n db: {\n query: (sql: string, params?: SqlParam[]): Promise<DbQueryResult> =>\n call(Methods.DbQuery, params ? { sql, params } : { sql }),\n exec: (sql: string, params?: SqlParam[]): Promise<DbExecResult> =>\n call(Methods.DbExec, params ? { sql, params } : { sql }),\n batch: (statements: SqlStatement[]): Promise<DbBatchResult> => call(Methods.DbBatch, { statements }),\n },\n kv: {\n async get<T extends JsonValue = JsonValue>(key: string): Promise<T | null> {\n const r = await call(Methods.KvGet, { key });\n return r.value as T | null;\n },\n async set(key: string, value: JsonValue): Promise<void> {\n await call(Methods.KvSet, { key, value });\n },\n async delete(key: string): Promise<void> {\n await call(Methods.KvDelete, { key });\n },\n },\n files: {\n /**\n * `list(prefix, { scope })` lists the scoped app storage (works for websites too).\n * `list(path)` WITHOUT options is the legacy listing of a registered app's `data` folder.\n */\n async list(path?: string, opts?: FilesOptions): Promise<AppFileInfo[]> {\n if (opts) return filesApi.listScoped(path, opts);\n const r = await call(Methods.FilesList, path ? { path } : {});\n return r.files;\n },\n read: (path: string): Promise<FilesReadResult> => call(Methods.FilesRead, { path }),\n async write(path: string, text: string): Promise<{ id: string }> {\n return call(Methods.FilesWrite, { path, text });\n },\n stat: filesApi.stat,\n delete: filesApi.delete,\n url: filesApi.url,\n get: filesApi.get,\n put: filesApi.put,\n },\n ai: {\n complete: (params: AiCompleteParams): Promise<AiCompleteResult> => call(Methods.AiComplete, params),\n /** Speech-to-text (capability \"ai:transcribe\"). Audio ≤ 25 MB decoded; billed to the user's org. */\n transcribe: (params: AiTranscribeParams): Promise<AiTranscribeResult> => call(Methods.AiTranscribe, params),\n /** Image generation (capability \"ai:image\"); `n` ≤ 4. Billed to the user's org. */\n image: (params: AiImageParams): Promise<AiImageResult> => call(Methods.AiImage, params),\n },\n app: {\n /**\n * The environment this app runs in: `{name, vars}` (\"prod\" | \"dev\" | ...). Variables are the\n * environment's non-secret config, read at runtime; no capability needed.\n */\n env: (): Promise<AppEnvView> => call(Methods.AppEnv, {}),\n },\n spend: {\n /** This app's AI spend limit + usage for the signed-in user (no capability needed). */\n get: (): Promise<SpendView> => call(Methods.SpendGet, {}),\n },\n tools: {\n /** Register (or replace) a tool whose handler runs in this app. */\n async register(tool: RegisterToolInput): Promise<void> {\n toolHandlers.set(tool.name, tool);\n await pushTools();\n },\n async unregister(name: string): Promise<void> {\n toolHandlers.delete(name);\n await pushTools();\n },\n },\n ui: {\n async notify(message: string, level?: NotifyLevel): Promise<void> {\n await call(Methods.UiNotify, level ? { message, level } : { message });\n },\n },\n /** Subscribe to provider events (connect, disconnect, sessionChanged, message). Returns unsubscribe. */\n on(event: string, cb: Listener): () => void {\n let set = listeners.get(event);\n if (!set) listeners.set(event, (set = new Set()));\n set.add(cb);\n return () => set?.delete(cb);\n },\n /** Mock mode only: simulate the host invoking one of this app's registered tools. */\n async mockCallTool(name: string, args: JsonObject = {}): Promise<unknown> {\n const provider = await loadProvider();\n if (!mocked) throw new Error(\"mockCallTool is only available after knowhow.mock()\");\n return (provider as MockProvider).callTool(name, args);\n },\n /** Switch to the in-memory mock provider (call before any other API). */\n mock(opts?: MockOptions): void {\n mocked = true;\n mockOptions = opts;\n providerPromise = null;\n protocol = null;\n session = null;\n },\n };\n}\n\nexport type KnowhowSDK = ReturnType<typeof createKnowhow>;\n\n/** Default singleton. */\nexport const knowhow: KnowhowSDK = createKnowhow();\n"],"mappings":"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","names":["call"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"use strict";var KnowhowSDK=(()=>{var G=Object.defineProperty;var he=Object.getOwnPropertyDescriptor;var we=Object.getOwnPropertyNames;var ye=Object.prototype.hasOwnProperty;var ve=(e,t)=>{for(var n in t)G(e,n,{get:t[n],enumerable:!0})},Pe=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of we(t))!ye.call(e,s)&&s!==n&&G(e,s,{get:()=>t[s],enumerable:!(o=he(t,s))||o.enumerable});return e};var Ae=e=>Pe(G({},"__esModule",{value:!0}),e);var $e={};ve($e,{CAPABILITIES:()=>L,ErrorCodes:()=>A,Events:()=>M,Methods:()=>r,ProviderRpcError:()=>P,SDK_VERSION:()=>ce,createFilesApi:()=>$,createKnowhow:()=>ge,createMockProvider:()=>ee,discoverProvider:()=>q,getProvider:()=>Ce,isTrustedParentOrigin:()=>ue,knowhow:()=>qe,watchParentInit:()=>H});var F=1,r={Protocol:"kh_protocol",Connect:"kh_connect",Session:"kh_session",Disconnect:"kh_disconnect",DbQuery:"kh_db_query",DbExec:"kh_db_exec",DbBatch:"kh_db_batch",KvGet:"kh_kv_get",KvSet:"kh_kv_set",KvDelete:"kh_kv_delete",FilesList:"kh_files_list",FilesRead:"kh_files_read",FilesWrite:"kh_files_write",FilesStat:"kh_files_stat",FilesDelete:"kh_files_delete",FilesUploadStart:"kh_files_upload_start",FilesUploadComplete:"kh_files_upload_complete",FilesDownloadUrl:"kh_files_download_url",AiComplete:"kh_ai_complete",AiTranscribe:"kh_ai_transcribe",AiImage:"kh_ai_image",SpendGet:"kh_spend_get",AppEnv:"kh_app_env",ToolsRegister:"kh_tools_register",ToolsResult:"kh_tools_result",UiNotify:"kh_ui_notify"},Ee=[r.Protocol,r.Connect,r.Session,r.Disconnect,r.ToolsRegister,r.ToolsResult,r.UiNotify],M={Connect:"connect",Disconnect:"disconnect",SessionChanged:"sessionChanged",ToolCall:"toolCall",Message:"message"};var j=25*1024*1024,x=4,K=4,Ie=Object.values(r),z="kh:hello",J="kh:port",Y="kh:init",L=["db:app","files:app","ai:complete","ai:transcribe","ai:image","tools:expose"];var ke={[r.Protocol]:null,[r.Connect]:null,[r.Session]:null,[r.Disconnect]:null,[r.DbQuery]:"db:app",[r.DbExec]:"db:app",[r.DbBatch]:"db:app",[r.KvGet]:"db:app",[r.KvSet]:"db:app",[r.KvDelete]:"db:app",[r.FilesList]:"files:app",[r.FilesRead]:"files:app",[r.FilesWrite]:"files:app",[r.FilesStat]:"files:app",[r.FilesDelete]:"files:app",[r.FilesUploadStart]:"files:app",[r.FilesUploadComplete]:"files:app",[r.FilesDownloadUrl]:"files:app",[r.AiComplete]:"ai:complete",[r.AiTranscribe]:"ai:transcribe",[r.AiImage]:"ai:image",[r.SpendGet]:null,[r.AppEnv]:null,[r.ToolsRegister]:"tools:expose",[r.ToolsResult]:null,[r.UiNotify]:null};var A={USER_REJECTED:4001,UNAUTHORIZED:4100,UNSUPPORTED_METHOD:4200,RATE_LIMITED:4290,SPEND_LIMIT_REACHED:4291,DISCONNECTED:4900,INVALID_PARAMS:-32602,INTERNAL:-32603},P=class B extends Error{constructor(t,n,o){super(n),this.name="ProviderRpcError",this.code=t,this.data=o,Object.setPrototypeOf(this,B.prototype)}toJSON(){let t={code:this.code,message:this.message};return this.data!==void 0&&(t.data=this.data),t}static fromPayload(t){return new B(t.code,t.message,t.data)}static toPayload(t){if(t instanceof B)return t.toJSON();if(re(t))return{code:t.code,message:t.message,data:t.data};let n=t instanceof Error?t.message:String(t);return{code:A.INTERNAL,message:n}}};function re(e){if(typeof e!="object"||e===null)return!1;let t=e;return typeof t.code=="number"&&typeof t.message=="string"}var oe="knowhow:announceProvider",Te="knowhow:requestProvider";function Re(){if(typeof window!="undefined")return window;throw new Error("No event target available; pass one explicitly")}function V(e,t=Re()){let n=o=>{let s=o.detail;s&&s.info&&s.provider&&s.info.protocol===F&&e(s)};return t.addEventListener(oe,n),t.dispatchEvent(new Event(Te)),()=>t.removeEventListener(oe,n)}var Se=new Set(["kh_connect"]);function ie(e){let t=new Map;return{endpoint:e,request:n=>e.request(n.method,n.params,Se.has(n.method)?0:void 0),on(n,o){let s=e.on(n,c=>o(c));t.set(o,s)},removeListener(n,o){var s;(s=t.get(o))==null||s(),t.delete(o)}}}function X(e){return typeof e=="object"&&e!==null}var se=e=>typeof e=="number"||typeof e=="string";function be(e){return X(e)&&se(e.id)&&typeof e.method=="string"}function _e(e){return X(e)&&se(e.id)&&typeof e.method!="string"&&("result"in e||"error"in e)}function Me(e){return X(e)&&typeof e.event=="string"&&!("id"in e)}var ae=class{constructor(e,t={}){var o,s;this.transport=e,this.nextId=1,this.pending=new Map,this.listeners=new Map,this.closed=!1,this.timeoutMs=(o=t.timeoutMs)!=null?o:3e4,this.onRequest=t.onRequest,this.nonce=t.nonce;let n=t.filter;this.handleMessage=c=>{var p;if(!this.closed&&!(n&&!n(c))){if(this.nonce!==void 0){let g=(p=c.data)==null?void 0:p.nonce;if(typeof g!="string"||g!==this.nonce)return}this.dispatch(c.data)}},e.addEventListener("message",this.handleMessage),(s=e.start)==null||s.call(e)}setRequestHandler(e){this.onRequest=e}request(e,t,n){if(this.closed)return Promise.reject(new P(A.DISCONNECTED,"Endpoint closed"));let o=this.nextId++,s=n!=null?n:this.timeoutMs;return new Promise((c,p)=>{let g={resolve:c,reject:p};s>0&&(g.timer=setTimeout(()=>{this.pending.delete(o),p(new P(A.INTERNAL,`Request timed out: ${e}`))},s)),this.pending.set(o,g);let w=this.stamp(t===void 0?{id:o,method:e}:{id:o,method:e,params:t});try{this.transport.postMessage(w)}catch(u){this.settle(o),p(u)}})}emit(e,t){if(this.closed)return;let n=this.stamp(t===void 0?{event:e}:{event:e,data:t});this.transport.postMessage(n)}on(e,t){let n=this.listeners.get(e);return n||this.listeners.set(e,n=new Set),n.add(t),()=>this.off(e,t)}off(e,t){var n;(n=this.listeners.get(e))==null||n.delete(t)}close(){var e,t,n,o;if(!this.closed){this.closed=!0,(t=(e=this.transport).removeEventListener)==null||t.call(e,"message",this.handleMessage);for(let[s]of this.pending){let c=this.settle(s);c==null||c.reject(new P(A.DISCONNECTED,"Endpoint closed"))}(o=(n=this.transport).close)==null||o.call(n),this.dispatchLocal("close",void 0)}}get isClosed(){return this.closed}stamp(e){return this.nonce===void 0?e:{...e,nonce:this.nonce}}settle(e){let t=this.pending.get(e);return t&&(t.timer&&clearTimeout(t.timer),this.pending.delete(e)),t}dispatchLocal(e,t){var n;for(let o of Array.from((n=this.listeners.get(e))!=null?n:[]))try{o(t)}catch{}}dispatch(e){if(be(e))this.handleRequest(e);else if(_e(e)){let t=this.settle(e.id);if(!t)return;e.error&&re(e.error)?t.reject(P.fromPayload(e.error)):t.resolve(e.result)}else Me(e)&&this.dispatchLocal(e.event,e.data)}async handleRequest(e){let t;if(!this.onRequest)t={id:e.id,error:{code:A.UNSUPPORTED_METHOD,message:`Unsupported method: ${e.method}`}};else try{let n=await this.onRequest(e.method,e.params);t={id:e.id,result:n===void 0?null:n}}catch(n){t={id:e.id,error:P.toPayload(n)}}if(!this.closed)try{this.transport.postMessage(this.stamp(t))}catch{}}};var ce="0.1.0";function De(e){let t=null;return V(o=>{var s;t||(t={provider:o.provider,name:((s=o.info)==null?void 0:s.name)||"Knowhow"})},e)(),t}var Q=new WeakMap,le=new WeakSet;function de(e){try{let t=new URL(e).origin;return t&&t!=="null"?t:void 0}catch{return}}function ue(e,t){var n,o,s,c;if(!t||t==="null")return!1;try{let p=(n=e.location)==null?void 0:n.ancestorOrigins;if(p&&p.length>0)return p[0]===t}catch{}try{let p=(o=e.document)!=null&&o.referrer?de(e.document.referrer):void 0,g=de((c=(s=e.location)==null?void 0:s.href)!=null?c:"");if(p&&p!==g)return p===t}catch{}return!0}function pe(e,t){if(t.source!==e.parent)return null;let n=t.data;if(typeof n!="object"||n===null)return null;let o=n;return o.type!==Y||o.protocol!==F||typeof o.nonce!="string"||o.nonce.length<8||!ue(e,t.origin)?null:{origin:t.origin,nonce:o.nonce}}function H(e){!e.parent||e.parent===e||le.has(e)||(le.add(e),e.addEventListener("message",t=>{let n=pe(e,t);n&&Q.set(e,n)}))}function Oe(e,t){var c,p;let n=(c=t.handshakeTimeoutMs)!=null?c:5e3,o=(p=t.helloIntervalMs)!=null?p:250,s=e.parent;return H(e),new Promise((g,w)=>{let u,T,y=Q.get(e),D=()=>{e.removeEventListener("message",S),u&&clearInterval(u),T&&clearTimeout(T)},R=()=>{if(!y)return;let f={type:z,protocol:F,sdkVersion:ce,nonce:y.nonce};s.postMessage(f,y.origin)},S=f=>{let h=pe(e,f);if(h){let C=!y||y.nonce!==h.nonce||y.origin!==h.origin;y=h,Q.set(e,h),C&&R();return}if(!y||f.source!==s||f.origin!==y.origin)return;let l=f.data;if(typeof l!="object"||l===null)return;let I=l;if(I.type!==J||I.nonce!==y.nonce)return;let b=f.ports&&f.ports[0];if(!b)return;D();let E=new ae(b,{nonce:y.nonce});g(ie(E))};e.addEventListener("message",S),R(),u=setInterval(R,o),T=setTimeout(()=>{D(),w(new P(A.DISCONNECTED,"Knowhow host did not respond to kh:hello"))},n)})}async function q(e={}){var c,p;let t=(c=e.window)!=null?c:typeof window!="undefined"?window:void 0;if(!t)throw new P(A.DISCONNECTED,"No window: Knowhow provider unavailable");let n=!!t.parent&&t.parent!==t,o=De(t),s=g=>({provider:g.provider,kind:"injected",providerName:g.name});if(o&&(e.prefer==="injected"||!n))return s(o);if(n){let g=o?(p=e.parentProbeMs)!=null?p:1500:e.handshakeTimeoutMs;try{return{provider:await Oe(t,{...e,handshakeTimeoutMs:g}),kind:"embedded"}}catch(w){if(o)return s(o);throw w}}throw new P(A.DISCONNECTED,"No Knowhow provider found (not embedded in Knowhow and no extension installed). Call knowhow.mock() for local development.")}async function Ce(e={}){return(await q(e)).provider}var U=new Map,N="mock-blob:";function Fe(e,t){if(typeof Blob!="undefined"&&e instanceof Blob)return t&&!e.type?e.slice(0,e.size,t):e;let n=ArrayBuffer.isView(e)?e:new Uint8Array(e);return new Blob([n],t?{type:t}:void 0)}function fe(){let e=new Error("Aborted");return e.name="AbortError",e}async function Ne(e,t,n){var c,p;if(e.startsWith(N)){U.set(e,t),(c=n.onProgress)==null||c.call(n,t.size,t.size);return}let o={};if(t.type&&(o["Content-Type"]=t.type),typeof XMLHttpRequest!="undefined"&&n.onProgress){await new Promise((g,w)=>{let u=new XMLHttpRequest;u.open("PUT",e);for(let[T,y]of Object.entries(o))u.setRequestHeader(T,y);if(u.upload.onprogress=T=>{var y;T.lengthComputable&&((y=n.onProgress)==null||y.call(n,T.loaded,T.total))},u.onload=()=>u.status>=200&&u.status<300?g():w(new Error(`Upload failed (${u.status})`)),u.onerror=()=>w(new Error("Upload failed (network error)")),u.onabort=()=>w(fe()),n.signal){if(n.signal.aborted)return w(fe());n.signal.addEventListener("abort",()=>u.abort(),{once:!0})}u.send(t)});return}let s=await fetch(e,{method:"PUT",body:t,headers:o,signal:n.signal});if(!s.ok)throw new Error(`Upload failed (${s.status})`);(p=n.onProgress)==null||p.call(n,t.size,t.size)}async function Le(e,t){var u,T,y,D;if(e.startsWith(N)){let R=U.get(e);if(!R)throw new Error("Download failed (404)");let S=t.range?R.slice(t.range.start,((u=t.range.end)!=null?u:R.size-1)+1):R;return(T=t.onProgress)==null||T.call(t,S.size,S.size),S}let n={};t.range&&(n.Range=`bytes=${t.range.start}-${(y=t.range.end)!=null?y:""}`);let o=await fetch(e,{headers:n,signal:t.signal});if(!o.ok)throw new Error(`Download failed (${o.status})`);let s=Number(o.headers.get("content-length"))||0,c=(D=o.headers.get("content-type"))!=null?D:"";if(!t.onProgress||!o.body)return o.blob();let p=o.body.getReader(),g=[],w=0;for(;;){let{done:R,value:S}=await p.read();if(R)break;g.push(S),w+=S.byteLength,t.onProgress(w,s||w)}return new Blob(g,c?{type:c}:void 0)}function $(e){let t=n=>{var o;return{scope:(o=n==null?void 0:n.scope)!=null?o:"user"}};return{async listScoped(n,o){return(await e(r.FilesList,{...n?{path:n}:{},...t(o)})).files},async stat(n,o){return(await e(r.FilesStat,{path:n,...t(o)})).file},async delete(n,o){return(await e(r.FilesDelete,{path:n,...t(o)})).deleted},async url(n,o){return(await e(r.FilesDownloadUrl,{path:n,...t(o)})).url},async get(n,o={}){let s=await e(r.FilesDownloadUrl,{path:n,...t(o)});return Le(s.url,o)},async put(n,o,s={}){let c=Fe(o,s.contentType),p=await e(r.FilesUploadStart,{path:n,size:c.size,contentType:s.contentType||c.type||void 0,...t(s)});return await Ne(p.uploadUrl,c,s),(await e(r.FilesUploadComplete,{id:p.id,...t(s)})).file}}}var Ue="iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",me=["This","is","a","mock","transcript","from","the","Knowhow","app","SDK."],Z=.5;function xe(e){let t=e.startsWith("data:")?e.indexOf(","):-1,n=(t>=0?e.slice(t+1):e).replace(/\s+/g,""),o=n.endsWith("==")?2:n.endsWith("=")?1:0;return Math.floor(n.length*3/4)-o}function Ke(e){var c,p,g;if(typeof e.audio!="string"||!e.audio)throw new P(A.INVALID_PARAMS,"audio is required");if(xe(e.audio)>j)throw new P(A.INVALID_PARAMS,"audio exceeds 25 MB");let t=(c=e.timestamps)!=null?c:["word","segment"],n=me.map((w,u)=>({start:u*Z,end:(u+1)*Z,word:w})),o=n.length*Z,s=me.join(" ");return{text:s,language:(p=e.language)!=null?p:"en",duration:o,model:(g=e.model)!=null?g:"mock",segments:t.includes("segment")?[{start:0,end:o,text:s}]:[],words:t.includes("word")?n:[]}}function Be(e){var n,o;if(typeof e.prompt!="string"||!e.prompt.trim())throw new P(A.INVALID_PARAMS,"prompt is required");if(e.images!==void 0&&(!Array.isArray(e.images)||e.images.length<1||e.images.length>K))throw new P(A.INVALID_PARAMS,`images must be an array of 1..${K} image data URLs`);let t=(n=e.n)!=null?n:1;if(!Number.isInteger(t)||t<1||t>x)throw new P(A.INVALID_PARAMS,`n must be an integer between 1 and ${x}`);return{model:(o=e.model)!=null?o:"mock",images:Array.from({length:t},()=>({dataUrl:`data:image/png;base64,${Ue}`,revisedPrompt:`[mock] ${e.prompt}`}))}}function ee(e={}){let t=new Map,n=new Map,o=new Map,s=f=>f.scope==="org"?"org":"user",c=f=>{var l;let h=String((l=f.path)!=null?l:"");if(!h||h.startsWith("/")||h.split("/").some(I=>I==="..")||h.includes("\\"))throw new P(A.INVALID_PARAMS,"Invalid path");return`${s(f)}:${h.split("/").filter(I=>I&&I!==".").join("/")}`},p=f=>{var E;let h=o.get(f),[l,...I]=f.split(":"),b=I.join(":");return{id:h.id,name:(E=b.split("/").pop())!=null?E:b,path:b,size:h.size,mime:h.mime,updatedAt:h.updatedAt,scope:l}},g=new Map,w=new Map,u=null,T=0,y=(f,h)=>{var l;for(let I of Array.from((l=g.get(f))!=null?l:[]))I(h)},D=[r.DbQuery,r.DbExec,r.DbBatch],R=Object.values(r);async function S(f,h){var I,b,E,C,O,i,a,m,k;let l=h!=null?h:{};switch(f){case r.Protocol:return{protocol:F,methods:R,host:{kind:"web",version:"mock"}};case r.Connect:return u={appId:(I=l.appId)!=null?I:"mock-app",user:(b=e.user)!=null?b:{displayName:"Mock User"},capabilities:[...L]},y("connect",u),y("sessionChanged",u),u;case r.Session:return u;case r.Disconnect:return u=null,y("disconnect"),!0}if(!u)throw new P(A.UNAUTHORIZED,"Not connected");if(D.includes(f)){if(!e.db)throw new P(A.INTERNAL,"db not available in mock");return e.db(f,h)}switch(f){case r.KvGet:return{value:t.has(String(l.key))?t.get(String(l.key)):null};case r.KvSet:return t.set(String(l.key),l.value),!0;case r.KvDelete:return t.delete(String(l.key)),!0;case r.FilesStat:{let d=c(l);return{file:(E=o.get(d))!=null&&E.done?p(d):null}}case r.FilesDelete:{let d=c(l),v=o.get(d);return v&&U.delete(`${N}${v.id}`),{deleted:o.delete(d)}}case r.FilesUploadStart:{let d=c(l),v=`mock-file-${o.size+1}-${d}`;return o.set(d,{id:v,size:Number(l.size)||0,mime:typeof l.contentType=="string"?l.contentType:"application/octet-stream",updatedAt:new Date().toISOString(),done:!1}),{id:v,uploadUrl:`${N}${v}`,method:"PUT",maxBytes:Number(l.size)||0}}case r.FilesUploadComplete:{let d=Array.from(o.entries()).find(([,_])=>_.id===l.id);if(!d)throw new P(A.INVALID_PARAMS,"File not found");let v=U.get(`${N}${d[1].id}`);return d[1].size=(C=v==null?void 0:v.size)!=null?C:d[1].size,d[1].done=!0,{file:p(d[0])}}case r.FilesDownloadUrl:{let d=c(l),v=o.get(d);if(!(v!=null&&v.done))throw new P(A.INVALID_PARAMS,"File not found");return{url:`${N}${v.id}`,file:p(d)}}case r.FilesList:if(l.scope!==void 0){let d=s(l),v=typeof l.path=="string"&&l.path?`${d}:${l.path.replace(/\/+$/,"")}/`:`${d}:`;return{files:Array.from(o.keys()).filter(_=>_.startsWith(v)&&o.get(_).done).map(p)}}return{files:Array.from(n.entries()).map(([d,v])=>{var _;return{id:d,name:(_=d.split("/").pop())!=null?_:d,path:d,size:v.length,mime:"text/plain",updatedAt:new Date(0).toISOString()}})};case r.FilesRead:{let d=n.get(String(l.path));if(d===void 0)throw new P(A.INVALID_PARAMS,"File not found");return{text:d}}case r.FilesWrite:return n.set(String(l.path),String(l.text)),{id:String(l.path)};case r.AiComplete:{let d=(O=l.messages)!=null?O:[],v=d[d.length-1];return{content:`[mock] ${v?v.content:""}`,model:"mock"}}case r.AiTranscribe:return Ke(l);case r.AiImage:return Be(l);case r.AppEnv:return{name:(a=(i=e.env)==null?void 0:i.name)!=null?a:"dev",vars:{...(k=(m=e.env)==null?void 0:m.vars)!=null?k:{}}};case r.SpendGet:return{spendLimitUsd:5,spendPeriod:"month",spentUsd:0,spentUsdTotal:0,periodResetsAt:null,aiRequestsTotal:0};case r.ToolsRegister:return!0;case r.ToolsResult:{let d=w.get(String(l.callId));return d&&(w.delete(String(l.callId)),l.error?d.reject(new Error(String(l.error))):d.resolve(l.result)),!0}case r.UiNotify:return console.info("[knowhow mock] notify:",l.message),!0;default:throw new P(A.UNSUPPORTED_METHOD,`Unsupported method: ${f}`)}}return{request:f=>S(f.method,f.params),on(f,h){let l=g.get(f);l||g.set(f,l=new Set),l.add(h)},removeListener(f,h){var l;(l=g.get(f))==null||l.delete(h)},callTool(f,h={}){let l=`mock-${++T}`;return new Promise((I,b)=>{w.set(l,{resolve:I,reject:b}),y("toolCall",{callId:l,name:f,args:h})})}}}function Ve(e){var t,n;try{let o=(t=e==null?void 0:e.document)==null?void 0:t.querySelector('meta[name="knowhow-app-id"]');return((n=o==null?void 0:o.getAttribute("content"))==null?void 0:n.trim())||void 0}catch{return}}var He=[M.Connect,M.Disconnect,M.SessionChanged,M.Message];function ge(e={}){let t=!1,n,o=null,s=null,c=null,p,g=e.prefer,w=null,u=null,T=e.appId,y=()=>{var i;return(i=e.window)!=null?i:typeof window!="undefined"?window:void 0};{let i=y();i&&!e.getProvider&&H(i)}let D=i=>{var a;return(a=i!=null?i:T)!=null?a:Ve(y())},R=new Map,S=new Map,f=(i,a)=>{var m;for(let k of Array.from((m=R.get(i))!=null?m:[]))k(a)};async function h(i,a){var k;let m=S.get(a.name);try{if(!m)throw new Error(`Unknown tool: ${a.name}`);let d=await m.handler((k=a.args)!=null?k:{});await i.request({method:r.ToolsResult,params:{callId:a.callId,result:d===void 0?null:d}})}catch(d){await i.request({method:r.ToolsResult,params:{callId:a.callId,error:d instanceof Error?d.message:String(d)}}).catch(()=>{})}}function l(){return s||(s=(e.getProvider?e.getProvider().then(i=>({provider:i,kind:"embedded"})):q({...e,prefer:g})).then(i=>(c=i.kind,p=i.providerName,i)),s.catch(()=>{s=null})),s}function I(){return o||(o=(t?async()=>ee(n):async()=>(await l()).provider)().then(async a=>{for(let m of He)a.on(m,k=>{m===M.SessionChanged&&(u=k!=null?k:null),m===M.Disconnect&&(u=null),f(m,k)});return a.on(M.ToolCall,m=>{h(a,m)}),w=await a.request({method:r.Protocol}),a}),o.catch(()=>{o=null})),o}async function b(i,a={}){let m=await I(),k=i?{capabilities:i}:{},d=D(a.appId);return d&&(k.appId=d),u=await m.request({method:r.Connect,params:k}),u}async function E(i,a){let m=await I();if(w&&!w.methods.includes(i))throw new P(A.UNSUPPORTED_METHOD,`Host does not support ${i}`);return u||(u=await m.request({method:r.Session}),u||await b()),m.request({method:i,params:a})}let C=async()=>{let i=Array.from(S.values()).map(a=>({name:a.name,description:a.description,parameters:a.parameters,...a.readOnly===void 0?{}:{readOnly:a.readOnly}}));await E(r.ToolsRegister,{tools:i})},O=$(E);return{async ready(){return await I(),w},get session(){return u},supports(i){return!!w&&w.methods.includes(i)},connect:(i,a)=>b(i,a),configure(i){"appId"in i&&(T=i.appId),"prefer"in i&&(g=i.prefer)},get host(){return t?{kind:"mock"}:c?{kind:c,...p?{providerName:p}:{}}:null},get appId(){return D()},async detect(i={}){if(t)return{kind:"mock"};let a=y();if(!a)return{kind:"none"};if(a.parent&&a.parent!==a)try{let k=await l();return{kind:k.kind,...k.providerName?{providerName:k.providerName}:{}}}catch{return{kind:"none"}}let m=await new Promise(k=>{var ne;let d=!1,v,_=()=>{},te=W=>{d||(d=!0,v&&clearTimeout(v),_(),k(W))};_=V(W=>te(W.info.name||"Knowhow"),a),d?_():v=setTimeout(()=>te(null),(ne=i.timeoutMs)!=null?ne:300)});return m?{kind:"injected",providerName:m}:{kind:"none"}},async disconnect(){await(await I()).request({method:r.Disconnect}),u=null},db:{query:(i,a)=>E(r.DbQuery,a?{sql:i,params:a}:{sql:i}),exec:(i,a)=>E(r.DbExec,a?{sql:i,params:a}:{sql:i}),batch:i=>E(r.DbBatch,{statements:i})},kv:{async get(i){return(await E(r.KvGet,{key:i})).value},async set(i,a){await E(r.KvSet,{key:i,value:a})},async delete(i){await E(r.KvDelete,{key:i})}},files:{async list(i,a){return a?O.listScoped(i,a):(await E(r.FilesList,i?{path:i}:{})).files},read:i=>E(r.FilesRead,{path:i}),async write(i,a){return E(r.FilesWrite,{path:i,text:a})},stat:O.stat,delete:O.delete,url:O.url,get:O.get,put:O.put},ai:{complete:i=>E(r.AiComplete,i),transcribe:i=>E(r.AiTranscribe,i),image:i=>E(r.AiImage,i)},app:{env:()=>E(r.AppEnv,{})},spend:{get:()=>E(r.SpendGet,{})},tools:{async register(i){S.set(i.name,i),await C()},async unregister(i){S.delete(i),await C()}},ui:{async notify(i,a){await E(r.UiNotify,a?{message:i,level:a}:{message:i})}},on(i,a){let m=R.get(i);return m||R.set(i,m=new Set),m.add(a),()=>m==null?void 0:m.delete(a)},async mockCallTool(i,a={}){let m=await I();if(!t)throw new Error("mockCallTool is only available after knowhow.mock()");return m.callTool(i,a)},mock(i){t=!0,n=i,o=null,w=null,u=null}}}var qe=ge();return Ae($e);})();
|
package/package.json
CHANGED
|
@@ -1,6 +1,39 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tyvm/knowhow-app-sdk",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Ergonomic SDK for Knowhow apps (db, kv, files, ai, tools).",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"author": "Micah Riggan",
|
|
7
|
+
"type": "module",
|
|
8
|
+
"sideEffects": false,
|
|
9
|
+
"main": "./dist/index.cjs",
|
|
10
|
+
"module": "./dist/index.js",
|
|
11
|
+
"types": "./dist/index.d.ts",
|
|
12
|
+
"exports": {
|
|
13
|
+
".": {
|
|
14
|
+
"types": "./dist/index.d.ts",
|
|
15
|
+
"import": "./dist/index.js",
|
|
16
|
+
"require": "./dist/index.cjs"
|
|
17
|
+
},
|
|
18
|
+
"./dist/knowhow-sdk.iife.js": "./dist/knowhow-sdk.iife.js",
|
|
19
|
+
"./package.json": "./package.json"
|
|
20
|
+
},
|
|
21
|
+
"files": [
|
|
22
|
+
"dist",
|
|
23
|
+
"README.md"
|
|
24
|
+
],
|
|
25
|
+
"keywords": [
|
|
26
|
+
"knowhow",
|
|
27
|
+
"app",
|
|
28
|
+
"sdk",
|
|
29
|
+
"window.knowhow"
|
|
30
|
+
],
|
|
31
|
+
"repository": {
|
|
32
|
+
"type": "git",
|
|
33
|
+
"url": "git+ssh://git@github.com/tyvm-ai/knowhow.git"
|
|
34
|
+
},
|
|
35
|
+
"homepage": "https://github.com/tyvm-ai/knowhow#readme",
|
|
36
|
+
"publishConfig": {
|
|
37
|
+
"access": "public"
|
|
38
|
+
}
|
|
39
|
+
}
|