buckyos 0.7.159 → 0.7.160

package/dist/aiworkspace_client.d.ts

@@ -44,6 +44,68 @@ export interface AiwsReference {
 export declare function aiwsReferenceUrl(reference: AiwsReference, workspaceId?: string): string;
 /** The Reference an `obj://aiworkspace/<ws>/entities/<entity_id>[?...]` URL projects. */
 export declare function parseAiwsReferenceUrl(url: string): AiwsReference;
+export interface AiwsExtBuildParams {
+    files: ({
+        name: string;
+        obj_id: string;
+    } | {
+        name: string;
+        base64: string;
+    })[];
+    folder_id?: string;
+    expect?: {
+        def_rev: number;
+        dir_rev: number;
+    };
+    force?: boolean;
+    dry_run?: boolean;
+    provenance?: {
+        pkg_id?: string;
+        version?: string;
+        digest?: string;
+    };
+    idempotency_key?: string;
+}
+/** `ext.build` / `ext.import`: one entry per control (`created | rebuilt | unchanged | satisfied`), the first also at the top. */
+export interface AiwsExtBuildResult {
+    status: 'accepted' | 'unchanged' | 'checked';
+    commit_id?: string;
+    seq?: number;
+    unchanged?: boolean;
+    ident?: string;
+    def_entity_id?: string;
+    dir_entity_id?: string;
+    version?: number;
+    def_rev?: number;
+    dir_rev?: number;
+    action?: string;
+    build?: {
+        input_digest: string;
+        builder_version: string;
+        built_at: string;
+    };
+    controls: Record<string, unknown>[];
+    diagnostics: Record<string, unknown>[];
+}
+export interface AiwsLibraryPackage {
+    pkg_id: string;
+    version: string;
+    title: string;
+    author: string;
+    mode: string;
+    installed_at: string;
+    controls: {
+        ident: string;
+        name: string;
+        kind: string;
+        version: number;
+        digest: string;
+        dir: string;
+        title?: string;
+        description?: string;
+        catalog?: Record<string, unknown>;
+    }[];
+}
 /** What an executor outside the service reports for a run (M3): results in the Mock executor's shape, or an analysis. */
 export interface AiwsRunReport {
     run_id: string;
@@ -82,6 +144,87 @@ export declare class AiWorkspaceClient {
     /** The three-state commit result (`status: accepted | conflict | rejected`), never thrown. */
     commit(workspace_id: string, request: Record<string, unknown>): Promise<Record<string, unknown>>;
     getSubmission(workspace_id: string, epoch: string, idempotency_key: string): Promise<Record<string, unknown>>;
+    /** Changes after `after_seq` (`filter.detail: "touched"` for the touched entities only). */
+    getChanges(workspace_id: string, epoch: string, after_seq: number, opts?: {
+        limit?: number;
+        touchedOnly?: boolean;
+    }): Promise<Record<string, unknown>>;
+    /** Long poll until the head passes `after_seq` (or `timeout_ms`). */
+    waitChanges(workspace_id: string, after_seq: number, opts?: {
+        epoch?: string;
+        timeout_ms?: number;
+    }): Promise<{
+        epoch: string;
+        head_seq: number;
+        timed_out: boolean;
+    }>;
+    /** A whole-Workspace package (`.bcanvas`): `download` names it in the owner's exports bucket. */
+    exportDoc(workspace_id: string, mode: 'share' | 'personal_backup', self_contained: boolean, include_notes?: boolean): Promise<Record<string, unknown>>;
+    /** Register a FileObject as a staged asset: `{ bucket_id, key }` (the uploader's binding) or `{ obj_id }`. */
+    assetImportObject(workspace_id: string, source: {
+        bucket_id: string;
+        key: string;
+    } | {
+        obj_id: string;
+    }): Promise<{
+        object_id: string;
+        media_type: string;
+        size: number;
+    }>;
+    controlsList(): Promise<Record<string, unknown>>;
+    controlsDescribe(kind: string): Promise<Record<string, unknown>>;
+    controlsImport(workspace_id: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    controlsExport(workspace_id: string, entity_id: string, format?: 'markdown' | 'opml'): Promise<Record<string, unknown>>;
+    /** Build one control's source files into the Workspace; `BUILD_FAILED` carries `data.diagnostics`. */
+    extBuild(workspace_id: string, params: AiwsExtBuildParams): Promise<AiwsExtBuildResult>;
+    /** The bundle of definitions (`purpose: pull` needs read only and synthesizes the source of never-built ones). */
+    extExport(workspace_id: string, entity_ids: string[], purpose?: 'package' | 'pull'): Promise<{
+        manifest: Record<string, unknown>;
+        controls: Record<string, unknown>[];
+        files: {
+            path: string;
+            obj_id?: string;
+            size: number;
+            text?: string;
+        }[];
+    }>;
+    /** Into the caller's library: a `.pikg` object, or definitions of a Workspace (`from` + `package`). */
+    extInstall(params: {
+        pikg?: {
+            obj_id: string;
+        };
+        from?: {
+            workspace_id: string;
+            entity_ids: string[];
+        };
+        package?: {
+            name: string;
+            version?: string;
+            title?: string;
+        };
+        mode?: 'dev';
+    }): Promise<{
+        pkg_id: string;
+        version: string;
+        action: string;
+        controls: Record<string, unknown>[];
+    }>;
+    extListLibrary(): Promise<{
+        packages: AiwsLibraryPackage[];
+    }>;
+    extUninstall(pkg_id: string): Promise<Record<string, unknown>>;
+    /** A library package's controls with their bytes (base64): what a client relays into a Workspace of another Zone. */
+    extLibraryBundle(pkg_id: string, idents?: string[]): Promise<{
+        pkg_id: string;
+        controls: Record<string, unknown>[];
+    }>;
+    /** Bring library controls into a Workspace of this Zone (one Commit). */
+    extImport(workspace_id: string, items: {
+        pkg_id: string;
+        ident: string;
+    }[], opts?: {
+        folder_id?: string;
+    }): Promise<AiwsExtBuildResult>;
     runStart(workspace_id: string, program: string, params: Record<string, unknown>, idempotency_key: string): Promise<Record<string, unknown>>;
     runGet(workspace_id: string, run_id: string, choices?: Record<string, unknown>): Promise<Record<string, unknown>>;
     runList(workspace_id: string, wish_id?: string, limit?: number): Promise<Record<string, unknown>>;

package/dist/aiworkspace_client.d.ts.map

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

package/dist/aiws_ext.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="component.json",t="aiws-manifest.json",r=".aiws-build.json";class i extends Error{constructor(e){super(e.filter((e=>"error"===e.severity)).map((e=>`${e.file?`${e.file}: `:""}${e.message}`)).join("; ")||"invalid control source"),this.name="AiwsSourceError",this.diagnostics=e}}const n=new TextEncoder,s=new TextDecoder;function o(e){return e.replace(/[/\\\u0000-\u001f]/g," ").replace(/^\.+/,"").trim().slice(0,80)||"Workspace"}async function a(e){const t=await crypto.subtle.digest("SHA-256",e);return Array.from(new Uint8Array(t),(e=>e.toString(16).padStart(2,"0"))).join("")}async function c(e){const t=[];for(const[r,i]of e)t.push([r,await a(i)]);return t.sort(((e,t)=>e[0]<t[0]?-1:e[0]>t[0]?1:0)),`sha256:${await a(n.encode(JSON.stringify(t)))}`}function l(e){return JSON.stringify([...e].sort(((e,t)=>e.name.localeCompare(t.name))).map((e=>[e.name,e.obj_id??e.etag??""])))}const d=4194304;function f(e){let t="";for(let r=0;r<e.length;r+=32768)t+=String.fromCharCode(...e.subarray(r,r+32768));return btoa(t)}async function u(e,t){var r;const n=[];let s=0;for(const o of t){if(null==(r=o.obj_id)?void 0:r.startsWith("cyfile:")){n.push({name:o.name,obj_id:o.obj_id});continue}if(!o.node_id)throw new i([{file:o.name,severity:"error",message:"the file service did not name this file"}]);const t=new Uint8Array(await(await e.readFile(o.node_id)).arrayBuffer());if(s+=t.length,s>d)throw new i([{file:o.name,severity:"error",message:"a control's files are limited to 4194304 bytes per build"}]);n.push({name:o.name,base64:f(t)})}return n}const p=["manifest_version","ident","kind","title","description","host_api","accepts","allow_no_source","default_size","config_schema","bindings","entry","assets","catalog","agent","deps"],m=["type","enum","default","required","title","description","minimum","maximum","minLength","maxLength","properties","items"],y=/^[a-z0-9][a-z0-9._-]{0,63}$/,g=/^did:[a-z0-9]+:[^/#\s]+$/,h=/^[a-z][a-z0-9_]{0,31}$/;function w(e,t,r){if(e&&"object"==typeof e&&!Array.isArray(e))for(const[i,n]of Object.entries(e))if(m.includes(i)){if("properties"===i&&n&&"object"==typeof n)for(const[e,i]of Object.entries(n))w(i,`${t}/properties/${e}`,r);"items"===i&&w(n,`${t}/items`,r)}else r.push(`${t}/${i}: keyword ${i} is outside the supported subset`);else r.push(`${t}: a schema is an object`)}function _(t,r){const i=[],s=e,o=e=>i.push({file:s,severity:"error",message:e});let a;try{const e=JSON.parse(t);if(!e||"object"!=typeof e||Array.isArray(e))return o("must be a JSON object"),i;a=e}catch(u){return o(u instanceof Error?u.message:String(u)),i}for(const e of Object.keys(a))p.includes(e)||o(`unknown key ${e}`);const c=a.manifest_version;"number"!=typeof c||!Number.isInteger(c)||c<1?o("manifest_version (1) required"):c>1&&o(`manifest_version ${c} is newer than this client reads (1)`);const l=a.ident;if(l&&"object"==typeof l?("string"==typeof l.author_did&&g.test(l.author_did)||o("ident.author_did must be a DID (did:<method>:<id>)"),"string"==typeof l.name&&y.test(l.name)||o("ident.name must be [a-z0-9][a-z0-9._-]{0,63}"),"string"==typeof l.author_did&&"string"==typeof l.name&&n.encode(`${l.author_did}#${l.name}`).length>128&&o("an identity is at most 128 bytes")):o("ident { author_did, name } required"),"declarative"!==a.kind&&"html"!==a.kind&&o("kind must be declarative or html"),("string"!=typeof a.title||!a.title||a.title.length>256)&&o("title: 1…256 characters"),void 0!==a.config_schema){const e=[];w(a.config_schema,"config_schema",e),e.forEach(o)}if(void 0!==a.bindings)if(a.bindings&&"object"==typeof a.bindings)for(const e of Object.keys(a.bindings))h.test(e)&&"props"!==e||o(`binding name ${e}: [a-z][a-z0-9_]{0,31}, not props`);else o("bindings must be an object");Array.isArray(a.deps)&&a.deps.length>0&&o("deps must be empty: dependencies between controls come in a later version");const d=e=>"string"==typeof e&&r.includes(e),f=new Set([s]);if("html"===a.kind){const e=a.entry;if(e&&"object"==typeof e&&"string"==typeof e.html)for(const[t,r]of Object.entries(e))d(r)?f.add(String(r)):o(`entry.${t} ${JSON.stringify(r)} is not in the directory`);else o("entry must be { html, css?, js? }");void 0!==a.host_api&&2!==a.host_api&&o("host_api: the HTML Block host speaks API 2")}else"declarative"===a.kind&&(d(a.entry)?f.add(String(a.entry)):o(`entry ${JSON.stringify(a.entry)} is not in the directory`));for(const e of Array.isArray(a.assets)?a.assets:[])d(e)?f.add(String(e)):o(`asset ${JSON.stringify(e)} is not in the directory`);void 0!==a.agent&&(d(a.agent)?f.add(String(a.agent)):o(`agent ${JSON.stringify(a.agent)} is not in the directory`));for(const e of r)f.has(e)||i.push({file:e,severity:"warning",message:"not named by component.json: kept in the source snapshot only"});return i}function v(e){if(!e||"object"!=typeof e)throw new i([{file:t,severity:"error",message:"must be a JSON object"}]);const r=e,n=r.manifest_version;if("number"!=typeof n||n<1)throw new i([{file:t,severity:"error",message:"manifest_version required"}]);if(n>1)throw new i([{file:t,severity:"error",message:`manifest_version ${n} needs a newer client (this one reads 1)`}]);if("aiws"!==r.purpose)throw new i([{file:t,severity:"error",message:"purpose must be aiws"}]);if(!Array.isArray(r.controls))throw new i([{file:t,severity:"error",message:"controls must be an array"}]);return{manifest_version:n,purpose:"aiws",host_api:r.host_api??{},controls:r.controls,workspace_templates:Array.isArray(r.workspace_templates)?r.workspace_templates:[]}}async function b(e,t,r){const i=/[*?[\]\\]/.test(r)?void 0:r;return(await e.list("string"==typeof t?t:{ref:t},{limit:i?10:1e3,...i?{filter:{name_glob:i}}:{}},["base","ident"])).entries.find((e=>e.name===r))}async function S(e,t){const r=t.split("/").filter(Boolean);if(0===r.length)throw new Error(`not a folder path: ${t}`);let n=(await e.stat(`/${r[0]}`)).ref;for(const s of r.slice(1)){const r=await b(e,n,s);if(r&&"dir"!==r.target.kind)throw new i([{file:s,severity:"error",message:`${s} in ${t} is not a folder`}]);n=r?r.target.ref:(await e.mkdir({ref:n},s)).ref}return n}async function x(e,t){const r=t.split("/").filter(Boolean);if(0===r.length)return null;let i=(await e.stat(`/${r[0]}`)).ref;for(const n of r.slice(1)){const t=await b(e,i,n);if(!t||"dir"!==t.target.kind)return null;i=t.target.ref}return i}async function $(e,t,r,i){const n="string"==typeof t?await S(e,t):t;await e.uploadFile(n,r,i,{overwrite:!0})}const k=e=>new Promise((t=>setTimeout(t,e)));async function j(e,t){var r,n,s;const o=[],a=[];let c;do{const i=await e.list(t,{limit:500,...c?{cursor:c}:{}},["base","ident"]);for(const e of i.entries){if(e.name.startsWith("."))continue;if("file"!==e.target.kind){a.push({file:e.name,severity:"error",message:"a control source folder is flat: move files out of sub-folders"});continue}const t=e.target.ref,i="object"===t.type?t.obj_id:"string"==typeof(null==(r=e.target.attrs)?void 0:r.obj_id)?e.target.attrs.obj_id:void 0;o.push({name:e.name,...i?{obj_id:i}:{},..."live"===t.type?{node_id:t.node_id}:{},..."string"==typeof(null==(n=e.target.attrs)?void 0:n.etag)?{etag:e.target.attrs.etag}:{},..."number"==typeof(null==(s=e.target.attrs)?void 0:s.size)?{size:e.target.attrs.size}:{}})}c=i.truncated?i.next_cursor:void 0}while(c);if(0===o.length&&a.push({file:"",severity:"error",message:`${t} holds no files`}),o.length>64&&a.push({file:"",severity:"error",message:"a control holds at most 64 files"}),a.some((e=>"error"===e.severity)))throw new i(a);return o.sort(((e,t)=>e.name.localeCompare(t.name)))}async function A(e,t){try{const i=await b(e,t,r),n="live"===(null==i?void 0:i.target.ref.type)?i.target.ref.node_id:void 0;if(!n)return null;const s=await e.readFile(n);return await s.json()}catch{return null}}async function I(e,t,i){await $(e,t,r,n.encode(`${JSON.stringify(i,null,2)}\n`))}exports.AIWS_BUILD_STATE_FILE=r,exports.AIWS_COMPONENT_FILE=e,exports.AIWS_DECLARATIVE_API_VERSION=1,exports.AIWS_HTML_API_VERSION=2,exports.AIWS_MANIFEST_FILE=t,exports.AIWS_MANIFEST_VERSION=1,exports.AIWS_MAX_INLINE_BYTES=d,exports.AIWS_MAX_SOURCE_FILES=64,exports.AiwsSourceError=i,exports.aiwsContentDigest=c,exports.buildControl=async function(e,t,r,i,n={}){const s=await j(t,i),o=await A(t,i),a=o&&o.workspace_id===r?{def_rev:o.def_rev,dir_rev:o.dir_rev}:void 0,c=await e.extBuild(r,{files:await u(t,s),...n.folderId?{folder_id:n.folderId}:{},...a?{expect:a}:{},...n.force?{force:!0}:{},...n.dryRun?{dry_run:!0}:{}});return n.dryRun||"string"!=typeof c.def_entity_id||"number"!=typeof c.def_rev||await I(t,i,{workspace_id:r,def_entity_id:c.def_entity_id,def_rev:c.def_rev,dir_rev:Number(c.dir_rev??0),ident:String(c.ident??""),at:(new Date).toISOString()}),{...c,files:s}},exports.buildFiles=u,exports.checkComponent=_,exports.collectSources=j,exports.compatManifest=v,exports.controlSkeleton=function(t){const r=t.title??t.name,i={manifest_version:1,ident:{author_did:t.authorDid,name:t.name},kind:t.kind??"declarative",title:r,description:`${r}: a control of this Workspace`,accepts:["buckyos.table-source","buckyos.record"],allow_no_source:!0,default_size:{w:260,h:140},config_schema:{type:"object",properties:{label:{type:"string",title:"Label",default:r}}},bindings:{data:{accepts:["buckyos.table-source"],title:"Data",description:"The table this control summarizes"}},catalog:{group:"custom",description:`${r}`},agent:"AGENT.md"},n=`# ${r}\n\nBind \`data\` to a table. Config: \`label\` (text).\n`;return"html"===t.kind?{[e]:`${JSON.stringify({...i,host_api:2,entry:{html:"view.html",css:"style.css",js:"behavior.js"}},null,2)}\n`,"view.html":'<div class="card"><div class="label" id="label"></div><div class="value" id="value">—</div></div>\n',"style.css":".card{font:14px system-ui;padding:12px}.label{opacity:.7}.value{font-size:28px;font-weight:600}\n","behavior.js":"document.getElementById('label').textContent = (aiws.context.config || {}).label || ''\nif (aiws.bindings.data) aiws.input('data').rows().then(function (rows) { document.getElementById('value').textContent = String(rows.length) })\n","AGENT.md":n}:{[e]:`${JSON.stringify({...i,entry:"declarative.json"},null,2)}\n`,"declarative.json":`${JSON.stringify({layout:"stack",items:[{kind:"metric",label:r,bind:"data.count",format:"number"},{kind:"text",text:"Rows of the bound table"}]},null,2)}\n`,"AGENT.md":n}},exports.createControlSource=async function(t,r,s){const o=await S(t,r),a=await t.list({ref:o},{limit:500},["base"]).catch((()=>null));if(null==a?void 0:a.entries.some((t=>t.name===e)))throw new i([{file:e,severity:"error",message:`${r} already holds a control`}]);for(const[e,i]of Object.entries(s))await $(t,o,e,n.encode(i));return o},exports.ensureFolder=S,exports.exportBundle=async function(e,r,i,s){const o=await e.extExport(r,i,"package"),a=new Map;a.set(t,n.encode(`${JSON.stringify(o.manifest,null,2)}\n`));for(const t of o.files)a.set(t.path,void 0!==t.text?n.encode(t.text):await s(r,String(t.obj_id)));return{manifest:v(o.manifest),files:a,controls:o.controls}},exports.findFolder=x,exports.folderName=o,exports.hasControlSource=async function(t,r){const i=await x(t,r);return null!==i&&void 0!==await b(t,i,e)},exports.homeControlDir=function(e,t,r){return`/home/${e}/AI Workspace/${o(t)}/controls/${r}`},exports.homeExportDir=function(e,t){return`/home/${e}/AI Workspace/exports/${t}`},exports.joinPath=function(e,t){return`${e.replace(/\/+$/,"")}/${t}`},exports.pullControl=async function(e,t,r,i,s,o){const a=(await e.extExport(r,[i],"pull")).controls[0],c=await S(t,s);for(const d of a.files)await $(t,c,d.name,void 0!==d.text?n.encode(d.text):await o(r,String(d.obj_id)));const l={workspace_id:r,def_entity_id:a.entity_id,def_rev:a.def_rev,dir_rev:a.dir_rev,ident:a.ident,at:(new Date).toISOString()};return await I(t,s,l),{files:a.files.map((e=>e.name)),state:l}},exports.readBuildState=A,exports.sourceStateKey=function(e){return`aiws:src:${e}`},exports.sourcesKey=l,exports.verifyBundle=async function(r){var n,o;const a=r.get(t);if(!a)throw new i([{file:t,severity:"error",message:"missing"}]);let l;try{l=JSON.parse(s.decode(a))}catch(p){throw new i([{file:t,severity:"error",message:String(p)}])}const d=v(l),f=[];d.workspace_templates.length>0&&f.push({file:t,severity:"error",message:"Workspace templates are not supported yet"}),0===d.controls.length&&f.push({file:t,severity:"error",message:"lists no control"});const u=new Set;for(const i of d.controls){if("string"!=typeof i.dir||!/^controls\/[a-z0-9][a-z0-9._-]{0,70}\/$/.test(i.dir)||u.has(i.dir)){f.push({file:t,severity:"error",message:`control ${i.ident}: bad or repeated dir`});continue}u.add(i.dir);const a=[...r].filter((([e])=>e.startsWith(i.dir))).map((([e,t])=>[e.slice(i.dir.length),t]));a.some((([e])=>e.includes("/")))&&f.push({file:i.dir,severity:"error",message:"a control directory is flat"}),await c(a)!==i.digest&&f.push({file:i.dir,severity:"error",message:"the files do not match the manifest digest"});const l=a.find((([t])=>t===e));if(l){for(const e of _(s.decode(l[1]),a.map((([e])=>e))))f.push({...e,file:`${i.dir}${e.file}`});try{const e=JSON.parse(s.decode(l[1]));`${null==(n=e.ident)?void 0:n.author_did}#${null==(o=e.ident)?void 0:o.name}`===i.ident&&e.kind===i.kind||f.push({file:i.dir,severity:"error",message:"ident and kind must match its component.json"})}catch{}}else f.push({file:`${i.dir}${e}`,severity:"error",message:"missing"})}for(const e of r.keys())e===t||[...u].some((t=>e.startsWith(t)))||f.push({file:e,severity:"error",message:"belongs to no control of the manifest"});return{manifest:d,diagnostics:f}},exports.watchControl=async function(e,t,r,i={}){var n,s;let o,a="",c=Promise.resolve();const d=()=>{c=c.then((async()=>{let i;try{i=await j(e,t)}catch{return}const n=l(i);n!==a&&(a=n,await r(i))})).catch((()=>{}))};for(d();!(null==(n=i.signal)?void 0:n.aborted);){const r=await e.list(t,{limit:1},["base"]),n=e.watch({tokens:r.watch_token?[r.watch_token]:[],signal:i.signal});try{for await(const e of n)o&&clearTimeout(o),o=setTimeout(d,i.debounceMs??500)}catch{if(null==(s=i.signal)?void 0:s.aborted)break;await k(2e3)}finally{n.close()}}o&&clearTimeout(o),await c},exports.writeBuildState=I,exports.writeHomeFile=$;
+//# sourceMappingURL=aiws_ext.cjs.map

package/dist/aiws_ext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiws_ext.cjs","sources":["../src/aiws_ext.ts"],"sourcesContent":["/**\n * AI Workspace extension controls (buckyos src/frame/aiworkspace/README.md “Extension controls”), shared by the\n * Desktop and the CLI: a control's source lives in a (flat) home folder of the Zone file service; `build` lists it\n * over NFSP and hands each file's object to `ext.build`, `pull` writes a Workspace snapshot back, `watch` rebuilds on\n * change; bundles (the AIWS manifest plus `controls/<dir>/<file>`) are what exports, packages and the library carry.\n * Runs in browsers and Deno (fetch, crypto.subtle); no dependencies.\n */\nimport type { AiWorkspaceClient } from './aiworkspace_client'\nimport type { NfspClient, WireRef } from './nfsp'\n\n/** The two service calls these drivers make (an `AiWorkspaceClient`, or a host's own session with the same shape). */\nexport type AiwsExtRpc = Pick<AiWorkspaceClient, 'extBuild' | 'extExport'>\n\nexport const AIWS_COMPONENT_FILE = 'component.json'\nexport const AIWS_MANIFEST_FILE = 'aiws-manifest.json'\n/** A client's own record of the base it last built or pulled (never part of the source snapshot: dot files are not). */\nexport const AIWS_BUILD_STATE_FILE = '.aiws-build.json'\n/** The newest component.json / AIWS manifest version this module reads (older ones stay readable, Q19). */\nexport const AIWS_MANIFEST_VERSION = 1\n/** The HTML Block host API (`window.aiws` v2) and the declarative interpreter version. */\nexport const AIWS_HTML_API_VERSION = 2\nexport const AIWS_DECLARATIVE_API_VERSION = 1\nexport const AIWS_MAX_SOURCE_FILES = 64\n\n/**\n * One file of a source folder. `obj_id` is set when the file service holds it as a named-store FileObject (`cyfile:`):\n * the service then reads it by reference. Files of a native home folder have none (their `obj_id`, when the file\n * service reports one, is a `sha256:` content hash the service cannot fetch): their bytes travel with the build.\n */\nexport interface AiwsSourceFile { name: string; obj_id?: string; node_id?: string; etag?: string; size?: number }\nexport interface AiwsDiagnostic {\n  file: string\n  line?: number\n  col?: number\n  severity: 'error' | 'warning'\n  message: string\n  /** Cells whose contract a rebuild would break. */\n  instances?: { entity_id: string; title?: string | null }[]\n}\nexport interface AiwsBuildState { workspace_id: string; def_entity_id: string; def_rev: number; dir_rev: number; ident?: string; at?: string }\nexport interface AiwsManifestControl { ident: string; name: string; kind: string; version: number; digest: string; dir: string; title?: string; description?: string; catalog?: Record<string, unknown> }\nexport interface AiwsManifest { manifest_version: number; purpose: 'aiws'; host_api?: Record<string, number>; controls: AiwsManifestControl[]; workspace_templates: unknown[] }\nexport interface AiwsBundle { manifest: AiwsManifest; files: Map<string, Uint8Array> }\n\n/** A source directory that cannot be built as it is (not a service refusal: `diagnostics` say why). */\nexport class AiwsSourceError extends Error {\n  readonly diagnostics: AiwsDiagnostic[]\n  constructor(diagnostics: AiwsDiagnostic[]) {\n    super(diagnostics.filter((d) => d.severity === 'error').map((d) => `${d.file ? `${d.file}: ` : ''}${d.message}`).join('; ') || 'invalid control source')\n    this.name = 'AiwsSourceError'\n    this.diagnostics = diagnostics\n  }\n}\n\nconst encoder = new TextEncoder()\nconst decoder = new TextDecoder()\n\nexport function joinPath(dir: string, name: string): string {\n  return `${dir.replace(/\\/+$/, '')}/${name}`\n}\n\n/** A Workspace title as one folder name (no `/`, no leading dot). */\nexport function folderName(title: string): string {\n  const cleaned = title.replace(/[/\\\\\\u0000-\\u001f]/g, ' ').replace(/^\\.+/, '').trim()\n  return cleaned.slice(0, 80) || 'Workspace'\n}\n\n/** The suggested home folder of a control (README: a suggestion; the definition never stores it). */\nexport function homeControlDir(owner: string, workspaceTitle: string, name: string): string {\n  return `/home/${owner}/AI Workspace/${folderName(workspaceTitle)}/controls/${name}`\n}\n\n/** Where a client writes an export bundle before packing it. */\nexport function homeExportDir(owner: string, pkg: string): string {\n  return `/home/${owner}/AI Workspace/exports/${pkg}`\n}\n\n/** `user_state` key under which each person remembers the home folder of a definition. */\nexport function sourceStateKey(defEntityId: string): string {\n  return `aiws:src:${defEntityId}`\n}\n\n// ---- digests (same canonical forms as the service: store/src/ext.rs)\n\nasync function sha256Hex(bytes: Uint8Array): Promise<string> {\n  const digest = await crypto.subtle.digest('SHA-256', bytes as unknown as ArrayBuffer)\n  return Array.from(new Uint8Array(digest), (b) => b.toString(16).padStart(2, '0')).join('')\n}\n\n/** `sha256:` over `[[name, sha256 hex of its bytes], …]` sorted by name: a control's content digest. */\nexport async function aiwsContentDigest(files: Iterable<[string, Uint8Array]>): Promise<string> {\n  const pairs: [string, string][] = []\n  for (const [name, bytes] of files) pairs.push([name, await sha256Hex(bytes)])\n  pairs.sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0))\n  return `sha256:${await sha256Hex(encoder.encode(JSON.stringify(pairs)))}`\n}\n\n/** What a set of sources is, for \"nothing changed since the last build\" (names, objects or versions). */\nexport function sourcesKey(files: AiwsSourceFile[]): string {\n  return JSON.stringify([...files].sort((a, b) => a.name.localeCompare(b.name)).map((f) => [f.name, f.obj_id ?? f.etag ?? '']))\n}\n\n/** Bytes a single build may carry inline (the service's limit). */\nexport const AIWS_MAX_INLINE_BYTES = 4 * 1024 * 1024\n\nfunction base64(bytes: Uint8Array): string {\n  let binary = ''\n  for (let i = 0; i < bytes.length; i += 0x8000) binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000))\n  return btoa(binary)\n}\n\n/** The `files` of `ext.build`: FileObjects by reference, everything else read over the file service and sent inline. */\nexport async function buildFiles(nfsp: NfspClient, files: AiwsSourceFile[]): Promise<({ name: string; obj_id: string } | { name: string; base64: string })[]> {\n  const out: ({ name: string; obj_id: string } | { name: string; base64: string })[] = []\n  let inline = 0\n  for (const f of files) {\n    if (f.obj_id?.startsWith('cyfile:')) { out.push({ name: f.name, obj_id: f.obj_id }); continue }\n    if (!f.node_id) throw new AiwsSourceError([{ file: f.name, severity: 'error', message: 'the file service did not name this file' }])\n    const bytes = new Uint8Array(await (await nfsp.readFile(f.node_id)).arrayBuffer())\n    inline += bytes.length\n    if (inline > AIWS_MAX_INLINE_BYTES) throw new AiwsSourceError([{ file: f.name, severity: 'error', message: `a control's files are limited to ${AIWS_MAX_INLINE_BYTES} bytes per build` }])\n    out.push({ name: f.name, base64: base64(bytes) })\n  }\n  return out\n}\n\n// ---- component.json pre-check (the service's composer is authoritative; this catches the usual mistakes early)\n\nconst COMPONENT_KEYS = ['manifest_version', 'ident', 'kind', 'title', 'description', 'host_api', 'accepts', 'allow_no_source', 'default_size', 'config_schema', 'bindings', 'entry', 'assets', 'catalog', 'agent', 'deps']\nconst SCHEMA_KEYWORDS = ['type', 'enum', 'default', 'required', 'title', 'description', 'minimum', 'maximum', 'minLength', 'maxLength', 'properties', 'items']\nconst NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/\nconst DID = /^did:[a-z0-9]+:[^/#\\s]+$/\nconst BINDING = /^[a-z][a-z0-9_]{0,31}$/\n\nfunction schemaProblems(v: unknown, path: string, out: string[]): void {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) { out.push(`${path}: a schema is an object`); return }\n  for (const [k, x] of Object.entries(v as Record<string, unknown>)) {\n    if (!SCHEMA_KEYWORDS.includes(k)) { out.push(`${path}/${k}: keyword ${k} is outside the supported subset`); continue }\n    if (k === 'properties' && x && typeof x === 'object') for (const [n, s] of Object.entries(x as Record<string, unknown>)) schemaProblems(s, `${path}/properties/${n}`, out)\n    if (k === 'items') schemaProblems(x, `${path}/items`, out)\n  }\n}\n\n/** Check a `component.json` text against the files of its directory. Errors make a build fail; warnings do not. */\nexport function checkComponent(text: string, fileNames: string[]): AiwsDiagnostic[] {\n  const out: AiwsDiagnostic[] = []\n  const f = AIWS_COMPONENT_FILE\n  const error = (message: string) => out.push({ file: f, severity: 'error', message })\n  let c: Record<string, unknown>\n  try {\n    const parsed = JSON.parse(text) as unknown\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) { error('must be a JSON object'); return out }\n    c = parsed as Record<string, unknown>\n  } catch (e) {\n    error(e instanceof Error ? e.message : String(e))\n    return out\n  }\n  for (const k of Object.keys(c)) if (!COMPONENT_KEYS.includes(k)) error(`unknown key ${k}`)\n  const mv = c.manifest_version\n  if (typeof mv !== 'number' || !Number.isInteger(mv) || mv < 1) error('manifest_version (1) required')\n  else if (mv > AIWS_MANIFEST_VERSION) error(`manifest_version ${mv} is newer than this client reads (${AIWS_MANIFEST_VERSION})`)\n  const ident = c.ident as Record<string, unknown> | undefined\n  if (!ident || typeof ident !== 'object') error('ident { author_did, name } required')\n  else {\n    if (typeof ident.author_did !== 'string' || !DID.test(ident.author_did)) error('ident.author_did must be a DID (did:<method>:<id>)')\n    if (typeof ident.name !== 'string' || !NAME.test(ident.name)) error('ident.name must be [a-z0-9][a-z0-9._-]{0,63}')\n    if (typeof ident.author_did === 'string' && typeof ident.name === 'string' && encoder.encode(`${ident.author_did}#${ident.name}`).length > 128) error('an identity is at most 128 bytes')\n  }\n  if (c.kind !== 'declarative' && c.kind !== 'html') error('kind must be declarative or html')\n  if (typeof c.title !== 'string' || !c.title || c.title.length > 256) error('title: 1…256 characters')\n  if (c.config_schema !== undefined) { const p: string[] = []; schemaProblems(c.config_schema, 'config_schema', p); p.forEach(error) }\n  if (c.bindings !== undefined) {\n    if (!c.bindings || typeof c.bindings !== 'object') error('bindings must be an object')\n    else for (const n of Object.keys(c.bindings as object)) if (!BINDING.test(n) || n === 'props') error(`binding name ${n}: [a-z][a-z0-9_]{0,31}, not props`)\n  }\n  if (Array.isArray(c.deps) && c.deps.length > 0) error('deps must be empty: dependencies between controls come in a later version')\n  const has = (n: unknown) => typeof n === 'string' && fileNames.includes(n)\n  const named = new Set([f])\n  if (c.kind === 'html') {\n    const e = c.entry as Record<string, unknown> | undefined\n    if (!e || typeof e !== 'object' || typeof e.html !== 'string') error('entry must be { html, css?, js? }')\n    else for (const [k, n] of Object.entries(e)) { if (!has(n)) error(`entry.${k} ${JSON.stringify(n)} is not in the directory`); else named.add(String(n)) }\n    if (c.host_api !== undefined && c.host_api !== AIWS_HTML_API_VERSION) error(`host_api: the HTML Block host speaks API ${AIWS_HTML_API_VERSION}`)\n  } else if (c.kind === 'declarative') {\n    if (!has(c.entry)) error(`entry ${JSON.stringify(c.entry)} is not in the directory`)\n    else named.add(String(c.entry))\n  }\n  for (const a of Array.isArray(c.assets) ? c.assets : []) { if (!has(a)) error(`asset ${JSON.stringify(a)} is not in the directory`); else named.add(String(a)) }\n  if (c.agent !== undefined) { if (!has(c.agent)) error(`agent ${JSON.stringify(c.agent)} is not in the directory`); else named.add(String(c.agent)) }\n  for (const n of fileNames) if (!named.has(n)) out.push({ file: n, severity: 'warning', message: 'not named by component.json: kept in the source snapshot only' })\n  return out\n}\n\n// ---- bundles (exports, the `aiws` sub-package of a PIKG)\n\n/** Read an AIWS manifest of any supported version as the current one (Q19); a newer one is refused. */\nexport function compatManifest(value: unknown): AiwsManifest {\n  if (!value || typeof value !== 'object') throw new AiwsSourceError([{ file: AIWS_MANIFEST_FILE, severity: 'error', message: 'must be a JSON object' }])\n  const m = value as Record<string, unknown>\n  const version = m.manifest_version\n  if (typeof version !== 'number' || version < 1) throw new AiwsSourceError([{ file: AIWS_MANIFEST_FILE, severity: 'error', message: 'manifest_version required' }])\n  if (version > AIWS_MANIFEST_VERSION) throw new AiwsSourceError([{ file: AIWS_MANIFEST_FILE, severity: 'error', message: `manifest_version ${version} needs a newer client (this one reads ${AIWS_MANIFEST_VERSION})` }])\n  if (m.purpose !== 'aiws') throw new AiwsSourceError([{ file: AIWS_MANIFEST_FILE, severity: 'error', message: 'purpose must be aiws' }])\n  if (!Array.isArray(m.controls)) throw new AiwsSourceError([{ file: AIWS_MANIFEST_FILE, severity: 'error', message: 'controls must be an array' }])\n  return { manifest_version: version, purpose: 'aiws', host_api: (m.host_api as Record<string, number>) ?? {}, controls: m.controls as AiwsManifestControl[], workspace_templates: Array.isArray(m.workspace_templates) ? m.workspace_templates : [] }\n}\n\n/** Verify a bundle the way an installer does: manifest, each control's digest and component.json, no stray files. */\nexport async function verifyBundle(files: Map<string, Uint8Array>): Promise<{ manifest: AiwsManifest; diagnostics: AiwsDiagnostic[] }> {\n  const raw = files.get(AIWS_MANIFEST_FILE)\n  if (!raw) throw new AiwsSourceError([{ file: AIWS_MANIFEST_FILE, severity: 'error', message: 'missing' }])\n  let parsed: unknown\n  try { parsed = JSON.parse(decoder.decode(raw)) } catch (e) { throw new AiwsSourceError([{ file: AIWS_MANIFEST_FILE, severity: 'error', message: String(e) }]) }\n  const manifest = compatManifest(parsed)\n  const diagnostics: AiwsDiagnostic[] = []\n  if (manifest.workspace_templates.length > 0) diagnostics.push({ file: AIWS_MANIFEST_FILE, severity: 'error', message: 'Workspace templates are not supported yet' })\n  if (manifest.controls.length === 0) diagnostics.push({ file: AIWS_MANIFEST_FILE, severity: 'error', message: 'lists no control' })\n  const dirs = new Set<string>()\n  for (const c of manifest.controls) {\n    if (typeof c.dir !== 'string' || !/^controls\\/[a-z0-9][a-z0-9._-]{0,70}\\/$/.test(c.dir) || dirs.has(c.dir)) { diagnostics.push({ file: AIWS_MANIFEST_FILE, severity: 'error', message: `control ${c.ident}: bad or repeated dir` }); continue }\n    dirs.add(c.dir)\n    const own: [string, Uint8Array][] = [...files].filter(([p]) => p.startsWith(c.dir)).map(([p, b]) => [p.slice(c.dir.length), b])\n    if (own.some(([n]) => n.includes('/'))) diagnostics.push({ file: c.dir, severity: 'error', message: 'a control directory is flat' })\n    if (await aiwsContentDigest(own) !== c.digest) diagnostics.push({ file: c.dir, severity: 'error', message: 'the files do not match the manifest digest' })\n    const component = own.find(([n]) => n === AIWS_COMPONENT_FILE)\n    if (!component) { diagnostics.push({ file: `${c.dir}${AIWS_COMPONENT_FILE}`, severity: 'error', message: 'missing' }); continue }\n    for (const d of checkComponent(decoder.decode(component[1]), own.map(([n]) => n))) diagnostics.push({ ...d, file: `${c.dir}${d.file}` })\n    try {\n      const comp = JSON.parse(decoder.decode(component[1])) as { ident?: { author_did?: string; name?: string }; kind?: string }\n      if (`${comp.ident?.author_did}#${comp.ident?.name}` !== c.ident || comp.kind !== c.kind) diagnostics.push({ file: c.dir, severity: 'error', message: 'ident and kind must match its component.json' })\n    } catch { /* reported above */ }\n  }\n  for (const p of files.keys()) if (p !== AIWS_MANIFEST_FILE && ![...dirs].some((d) => p.startsWith(d))) diagnostics.push({ file: p, severity: 'error', message: 'belongs to no control of the manifest' })\n  return { manifest, diagnostics }\n}\n\n/** The bundle of Workspace definitions (`ext.export`): the manifest plus every file's bytes. */\nexport async function exportBundle(client: AiwsExtRpc, workspaceId: string, entityIds: string[], fetchAsset: (workspaceId: string, objId: string) => Promise<Uint8Array>): Promise<AiwsBundle & { controls: Record<string, unknown>[] }> {\n  const r = await client.extExport(workspaceId, entityIds, 'package')\n  const files = new Map<string, Uint8Array>()\n  files.set(AIWS_MANIFEST_FILE, encoder.encode(`${JSON.stringify(r.manifest, null, 2)}\\n`))\n  for (const f of r.files) files.set(f.path, f.text !== undefined ? encoder.encode(f.text) : await fetchAsset(workspaceId, String(f.obj_id)))\n  return { manifest: compatManifest(r.manifest), files, controls: r.controls }\n}\n\n// ---- the home folder over NFSP\n\n/** The entry `name` of a folder, found with a filtered listing (no request fails for a missing name). */\nasync function child(nfsp: NfspClient, folder: WireRef | string, name: string) {\n  const glob = /[*?[\\]\\\\]/.test(name) ? undefined : name\n  const page = await nfsp.list(typeof folder === 'string' ? folder : { ref: folder }, { limit: glob ? 10 : 1000, ...(glob ? { filter: { name_glob: glob } } : {}) }, ['base', 'ident'])\n  return page.entries.find((e) => e.name === name)\n}\n\n/** Make sure a folder exists, creating each missing level below the realm root (`/home`); answers its ref. Levels\n * are looked up by listing their parent, so a missing one is not a failed request. */\nexport async function ensureFolder(nfsp: NfspClient, path: string): Promise<WireRef> {\n  const parts = path.split('/').filter(Boolean)\n  if (parts.length === 0) throw new Error(`not a folder path: ${path}`)\n  let ref = (await nfsp.stat(`/${parts[0]}`)).ref\n  for (const name of parts.slice(1)) {\n    const hit = await child(nfsp, ref, name)\n    if (hit && hit.target.kind !== 'dir') throw new AiwsSourceError([{ file: name, severity: 'error', message: `${name} in ${path} is not a folder` }])\n    ref = hit ? hit.target.ref : (await nfsp.mkdir({ ref }, name)).ref\n  }\n  return ref\n}\n\n/** A folder's ref, or null when it (or a level above it) does not exist — found without failed requests. */\nexport async function findFolder(nfsp: NfspClient, path: string): Promise<WireRef | null> {\n  const parts = path.split('/').filter(Boolean)\n  if (parts.length === 0) return null\n  let ref = (await nfsp.stat(`/${parts[0]}`)).ref\n  for (const name of parts.slice(1)) {\n    const hit = await child(nfsp, ref, name)\n    if (!hit || hit.target.kind !== 'dir') return null\n    ref = hit.target.ref\n  }\n  return ref\n}\n\n/** Whether a folder holds a control source (its component.json). */\nexport async function hasControlSource(nfsp: NfspClient, dir: string): Promise<boolean> {\n  const ref = await findFolder(nfsp, dir)\n  return ref !== null && (await child(nfsp, ref, AIWS_COMPONENT_FILE)) !== undefined\n}\n\n/** Write one file into a folder (replacing it). */\nexport async function writeHomeFile(nfsp: NfspClient, dir: string | WireRef, name: string, bytes: Uint8Array): Promise<void> {\n  const ref = typeof dir === 'string' ? await ensureFolder(nfsp, dir) : dir\n  await nfsp.uploadFile(ref, name, bytes, { overwrite: true })\n}\n\nconst sleep = (ms: number) => new Promise((r) => setTimeout(r, ms))\n\n/** The files of a control's source folder (flat; dot files are the client's own and skipped). */\nexport async function collectSources(nfsp: NfspClient, dir: string): Promise<AiwsSourceFile[]> {\n  const out: AiwsSourceFile[] = []\n  const problems: AiwsDiagnostic[] = []\n  let cursor: string | undefined\n  do {\n    const page = await nfsp.list(dir, { limit: 500, ...(cursor ? { cursor } : {}) }, ['base', 'ident'])\n    for (const e of page.entries) {\n      if (e.name.startsWith('.')) continue\n      if (e.target.kind !== 'file') { problems.push({ file: e.name, severity: 'error', message: 'a control source folder is flat: move files out of sub-folders' }); continue }\n      const ref = e.target.ref\n      const objId = ref.type === 'object' ? ref.obj_id : typeof e.target.attrs?.obj_id === 'string' ? e.target.attrs.obj_id : undefined\n      out.push({\n        name: e.name,\n        ...(objId ? { obj_id: objId } : {}),\n        ...(ref.type === 'live' ? { node_id: ref.node_id } : {}),\n        ...(typeof e.target.attrs?.etag === 'string' ? { etag: e.target.attrs.etag } : {}),\n        ...(typeof e.target.attrs?.size === 'number' ? { size: e.target.attrs.size } : {}),\n      })\n    }\n    cursor = page.truncated ? page.next_cursor : undefined\n  } while (cursor)\n  if (out.length === 0) problems.push({ file: '', severity: 'error', message: `${dir} holds no files` })\n  if (out.length > AIWS_MAX_SOURCE_FILES) problems.push({ file: '', severity: 'error', message: `a control holds at most ${AIWS_MAX_SOURCE_FILES} files` })\n  if (problems.some((p) => p.severity === 'error')) throw new AiwsSourceError(problems)\n  return out.sort((a, b) => a.name.localeCompare(b.name))\n}\n\nexport async function readBuildState(nfsp: NfspClient, dir: string): Promise<AiwsBuildState | null> {\n  try {\n    const entry = await child(nfsp, dir, AIWS_BUILD_STATE_FILE)\n    const nodeId = entry?.target.ref.type === 'live' ? entry.target.ref.node_id : undefined\n    if (!nodeId) return null\n    const response = await nfsp.readFile(nodeId)\n    return (await response.json()) as AiwsBuildState\n  } catch {\n    return null\n  }\n}\n\nexport async function writeBuildState(nfsp: NfspClient, dir: string, state: AiwsBuildState): Promise<void> {\n  await writeHomeFile(nfsp, dir, AIWS_BUILD_STATE_FILE, encoder.encode(`${JSON.stringify(state, null, 2)}\\n`))\n}\n\nexport interface AiwsBuildOptions { folderId?: string; force?: boolean; dryRun?: boolean }\n\n/**\n * Build the control in `dir` into a Workspace: collect the files, call `ext.build` with the base recorded in\n * `.aiws-build.json` (when it is this Workspace's), and record the new base. Service refusals throw `AiwsFailure`\n * (`BUILD_FAILED` carries `data.diagnostics`); source problems throw `AiwsSourceError`.\n */\nexport async function buildControl(client: AiwsExtRpc, nfsp: NfspClient, workspaceId: string, dir: string, opts: AiwsBuildOptions = {}): Promise<Record<string, unknown> & { files: AiwsSourceFile[] }> {\n  const files = await collectSources(nfsp, dir)\n  const state = await readBuildState(nfsp, dir)\n  const base = state && state.workspace_id === workspaceId ? { def_rev: state.def_rev, dir_rev: state.dir_rev } : undefined\n  const result = await client.extBuild(workspaceId, {\n    files: await buildFiles(nfsp, files),\n    ...(opts.folderId ? { folder_id: opts.folderId } : {}),\n    ...(base ? { expect: base } : {}),\n    ...(opts.force ? { force: true } : {}),\n    ...(opts.dryRun ? { dry_run: true } : {}),\n  })\n  if (!opts.dryRun && typeof result.def_entity_id === 'string' && typeof result.def_rev === 'number') {\n    await writeBuildState(nfsp, dir, { workspace_id: workspaceId, def_entity_id: result.def_entity_id, def_rev: result.def_rev, dir_rev: Number(result.dir_rev ?? 0), ident: String(result.ident ?? ''), at: new Date().toISOString() })\n  }\n  return { ...result, files }\n}\n\n/**\n * Write a definition's Workspace snapshot into `outDir` (a definition never built from source gets synthesized\n * files) and record it as the base of the next build.\n */\nexport async function pullControl(client: AiwsExtRpc, nfsp: NfspClient, workspaceId: string, defEntityId: string, outDir: string, fetchAsset: (workspaceId: string, objId: string) => Promise<Uint8Array>): Promise<{ files: string[]; state: AiwsBuildState }> {\n  const r = await client.extExport(workspaceId, [defEntityId], 'pull')\n  const control = r.controls[0] as { entity_id: string; ident: string; def_rev: number; dir_rev: number; files: { name: string; obj_id?: string; text?: string }[] }\n  const ref = await ensureFolder(nfsp, outDir)\n  for (const f of control.files) await writeHomeFile(nfsp, ref, f.name, f.text !== undefined ? encoder.encode(f.text) : await fetchAsset(workspaceId, String(f.obj_id)))\n  const state: AiwsBuildState = { workspace_id: workspaceId, def_entity_id: control.entity_id, def_rev: control.def_rev, dir_rev: control.dir_rev, ident: control.ident, at: new Date().toISOString() }\n  await writeBuildState(nfsp, outDir, state)\n  return { files: control.files.map((f) => f.name), state }\n}\n\n/**\n * Rebuild whenever the folder changes: NFSP watch events (lossy: a `resync` lists again), debounced, and only when\n * the files' objects differ from the last build. Returns when `signal` aborts.\n */\nexport async function watchControl(nfsp: NfspClient, dir: string, onChange: (files: AiwsSourceFile[]) => Promise<void>, opts: { debounceMs?: number; signal?: AbortSignal } = {}): Promise<void> {\n  let last = ''\n  let timer: ReturnType<typeof setTimeout> | undefined\n  let running = Promise.resolve()\n  const check = () => {\n    running = running.then(async () => {\n      let files: AiwsSourceFile[]\n      try { files = await collectSources(nfsp, dir) } catch { return }\n      const key = sourcesKey(files)\n      if (key === last) return\n      last = key\n      await onChange(files)\n    }).catch(() => undefined)\n  }\n  check()\n  while (!opts.signal?.aborted) {\n    const listing = await nfsp.list(dir, { limit: 1 }, ['base'])\n    const stream = nfsp.watch({ tokens: listing.watch_token ? [listing.watch_token] : [], signal: opts.signal })\n    try {\n      for await (const _ of stream) {\n        if (timer) clearTimeout(timer)\n        timer = setTimeout(check, opts.debounceMs ?? 500)\n      }\n    } catch {\n      if (opts.signal?.aborted) break\n      await sleep(2_000)\n    } finally {\n      stream.close()\n    }\n  }\n  if (timer) clearTimeout(timer)\n  await running\n}\n\n// ---- skeletons\n\nexport interface AiwsSkeletonOptions { authorDid: string; name: string; title?: string; kind?: 'declarative' | 'html' }\n\n/** The files of a new control: a minimal working declarative or HTML control with one optional binding. */\nexport function controlSkeleton(opts: AiwsSkeletonOptions): Record<string, string> {\n  const title = opts.title ?? opts.name\n  const base = {\n    manifest_version: AIWS_MANIFEST_VERSION,\n    ident: { author_did: opts.authorDid, name: opts.name },\n    kind: opts.kind ?? 'declarative',\n    title,\n    description: `${title}: a control of this Workspace`,\n    accepts: ['buckyos.table-source', 'buckyos.record'],\n    allow_no_source: true,\n    default_size: { w: 260, h: 140 },\n    config_schema: { type: 'object', properties: { label: { type: 'string', title: 'Label', default: title } } },\n    bindings: { data: { accepts: ['buckyos.table-source'], title: 'Data', description: 'The table this control summarizes' } },\n    catalog: { group: 'custom', description: `${title}` },\n    agent: 'AGENT.md',\n  }\n  const agent = `# ${title}\\n\\nBind \\`data\\` to a table. Config: \\`label\\` (text).\\n`\n  if (opts.kind === 'html') {\n    return {\n      [AIWS_COMPONENT_FILE]: `${JSON.stringify({ ...base, host_api: AIWS_HTML_API_VERSION, entry: { html: 'view.html', css: 'style.css', js: 'behavior.js' } }, null, 2)}\\n`,\n      'view.html': '<div class=\"card\"><div class=\"label\" id=\"label\"></div><div class=\"value\" id=\"value\">—</div></div>\\n',\n      'style.css': '.card{font:14px system-ui;padding:12px}.label{opacity:.7}.value{font-size:28px;font-weight:600}\\n',\n      'behavior.js': \"document.getElementById('label').textContent = (aiws.context.config || {}).label || ''\\nif (aiws.bindings.data) aiws.input('data').rows().then(function (rows) { document.getElementById('value').textContent = String(rows.length) })\\n\",\n      'AGENT.md': agent,\n    }\n  }\n  return {\n    [AIWS_COMPONENT_FILE]: `${JSON.stringify({ ...base, entry: 'declarative.json' }, null, 2)}\\n`,\n    'declarative.json': `${JSON.stringify({ layout: 'stack', items: [{ kind: 'metric', label: title, bind: 'data.count', format: 'number' }, { kind: 'text', text: 'Rows of the bound table' }] }, null, 2)}\\n`,\n    'AGENT.md': agent,\n  }\n}\n\n/** Create a control's source folder from a skeleton (refuses to overwrite a folder that has a component.json). */\nexport async function createControlSource(nfsp: NfspClient, dir: string, files: Record<string, string>): Promise<WireRef> {\n  const ref = await ensureFolder(nfsp, dir)\n  const existing = await nfsp.list({ ref }, { limit: 500 }, ['base']).catch(() => null)\n  if (existing?.entries.some((e) => e.name === AIWS_COMPONENT_FILE)) throw new AiwsSourceError([{ file: AIWS_COMPONENT_FILE, severity: 'error', message: `${dir} already holds a control` }])\n  for (const [name, text] of Object.entries(files)) await writeHomeFile(nfsp, ref, name, encoder.encode(text))\n  return ref\n}\n"],"names":["AIWS_COMPONENT_FILE","AIWS_MANIFEST_FILE","AIWS_BUILD_STATE_FILE","AiwsSourceError","Error","constructor","diagnostics","super","filter","d","severity","map","file","message","join","this","name","encoder","TextEncoder","decoder","TextDecoder","folderName","title","replace","trim","slice","async","sha256Hex","bytes","digest","crypto","subtle","Array","from","Uint8Array","b","toString","padStart","aiwsContentDigest","files","pairs","push","sort","a","encode","JSON","stringify","sourcesKey","localeCompare","f","obj_id","etag","AIWS_MAX_INLINE_BYTES","base64","binary","i","length","String","fromCharCode","subarray","btoa","buildFiles","nfsp","out","inline","_a","startsWith","node_id","readFile","arrayBuffer","COMPONENT_KEYS","SCHEMA_KEYWORDS","NAME","DID","BINDING","schemaProblems","v","path","isArray","k","x","Object","entries","includes","n","s","checkComponent","text","fileNames","error","c","parsed","parse","e","keys","mv","manifest_version","Number","isInteger","ident","author_did","test","kind","config_schema","p","forEach","bindings","deps","has","named","Set","entry","html","add","host_api","assets","agent","compatManifest","value","m","version","purpose","controls","workspace_templates","child","folder","glob","list","ref","limit","name_glob","find","ensureFolder","parts","split","Boolean","stat","hit","target","mkdir","findFolder","writeHomeFile","dir","uploadFile","overwrite","sleep","ms","Promise","r","setTimeout","collectSources","problems","cursor","page","objId","type","attrs","_b","_c","size","truncated","next_cursor","some","readBuildState","nodeId","response","json","writeBuildState","state","client","workspaceId","opts","base","workspace_id","def_rev","dir_rev","result","extBuild","folderId","folder_id","expect","force","dryRun","dry_run","def_entity_id","at","Date","toISOString","authorDid","description","accepts","allow_no_source","default_size","w","h","properties","label","default","data","catalog","group","css","js","layout","items","bind","format","existing","catch","entityIds","fetchAsset","extExport","Map","set","manifest","owner","workspaceTitle","pkg","defEntityId","outDir","control","entity_id","raw","get","decode","dirs","own","component","comp","onChange","timer","last","running","resolve","check","then","key","signal","aborted","listing","stream","watch","tokens","watch_token","_","clearTimeout","debounceMs","close"],"mappings":"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"}

package/dist/aiws_ext.d.ts

@@ -0,0 +1,169 @@
+/**
+ * AI Workspace extension controls (buckyos src/frame/aiworkspace/README.md “Extension controls”), shared by the
+ * Desktop and the CLI: a control's source lives in a (flat) home folder of the Zone file service; `build` lists it
+ * over NFSP and hands each file's object to `ext.build`, `pull` writes a Workspace snapshot back, `watch` rebuilds on
+ * change; bundles (the AIWS manifest plus `controls/<dir>/<file>`) are what exports, packages and the library carry.
+ * Runs in browsers and Deno (fetch, crypto.subtle); no dependencies.
+ */
+import type { AiWorkspaceClient } from './aiworkspace_client';
+import type { NfspClient, WireRef } from './nfsp';
+/** The two service calls these drivers make (an `AiWorkspaceClient`, or a host's own session with the same shape). */
+export type AiwsExtRpc = Pick<AiWorkspaceClient, 'extBuild' | 'extExport'>;
+export declare const AIWS_COMPONENT_FILE = "component.json";
+export declare const AIWS_MANIFEST_FILE = "aiws-manifest.json";
+/** A client's own record of the base it last built or pulled (never part of the source snapshot: dot files are not). */
+export declare const AIWS_BUILD_STATE_FILE = ".aiws-build.json";
+/** The newest component.json / AIWS manifest version this module reads (older ones stay readable, Q19). */
+export declare const AIWS_MANIFEST_VERSION = 1;
+/** The HTML Block host API (`window.aiws` v2) and the declarative interpreter version. */
+export declare const AIWS_HTML_API_VERSION = 2;
+export declare const AIWS_DECLARATIVE_API_VERSION = 1;
+export declare const AIWS_MAX_SOURCE_FILES = 64;
+/**
+ * One file of a source folder. `obj_id` is set when the file service holds it as a named-store FileObject (`cyfile:`):
+ * the service then reads it by reference. Files of a native home folder have none (their `obj_id`, when the file
+ * service reports one, is a `sha256:` content hash the service cannot fetch): their bytes travel with the build.
+ */
+export interface AiwsSourceFile {
+    name: string;
+    obj_id?: string;
+    node_id?: string;
+    etag?: string;
+    size?: number;
+}
+export interface AiwsDiagnostic {
+    file: string;
+    line?: number;
+    col?: number;
+    severity: 'error' | 'warning';
+    message: string;
+    /** Cells whose contract a rebuild would break. */
+    instances?: {
+        entity_id: string;
+        title?: string | null;
+    }[];
+}
+export interface AiwsBuildState {
+    workspace_id: string;
+    def_entity_id: string;
+    def_rev: number;
+    dir_rev: number;
+    ident?: string;
+    at?: string;
+}
+export interface AiwsManifestControl {
+    ident: string;
+    name: string;
+    kind: string;
+    version: number;
+    digest: string;
+    dir: string;
+    title?: string;
+    description?: string;
+    catalog?: Record<string, unknown>;
+}
+export interface AiwsManifest {
+    manifest_version: number;
+    purpose: 'aiws';
+    host_api?: Record<string, number>;
+    controls: AiwsManifestControl[];
+    workspace_templates: unknown[];
+}
+export interface AiwsBundle {
+    manifest: AiwsManifest;
+    files: Map<string, Uint8Array>;
+}
+/** A source directory that cannot be built as it is (not a service refusal: `diagnostics` say why). */
+export declare class AiwsSourceError extends Error {
+    readonly diagnostics: AiwsDiagnostic[];
+    constructor(diagnostics: AiwsDiagnostic[]);
+}
+export declare function joinPath(dir: string, name: string): string;
+/** A Workspace title as one folder name (no `/`, no leading dot). */
+export declare function folderName(title: string): string;
+/** The suggested home folder of a control (README: a suggestion; the definition never stores it). */
+export declare function homeControlDir(owner: string, workspaceTitle: string, name: string): string;
+/** Where a client writes an export bundle before packing it. */
+export declare function homeExportDir(owner: string, pkg: string): string;
+/** `user_state` key under which each person remembers the home folder of a definition. */
+export declare function sourceStateKey(defEntityId: string): string;
+/** `sha256:` over `[[name, sha256 hex of its bytes], …]` sorted by name: a control's content digest. */
+export declare function aiwsContentDigest(files: Iterable<[string, Uint8Array]>): Promise<string>;
+/** What a set of sources is, for "nothing changed since the last build" (names, objects or versions). */
+export declare function sourcesKey(files: AiwsSourceFile[]): string;
+/** Bytes a single build may carry inline (the service's limit). */
+export declare const AIWS_MAX_INLINE_BYTES: number;
+/** The `files` of `ext.build`: FileObjects by reference, everything else read over the file service and sent inline. */
+export declare function buildFiles(nfsp: NfspClient, files: AiwsSourceFile[]): Promise<({
+    name: string;
+    obj_id: string;
+} | {
+    name: string;
+    base64: string;
+})[]>;
+/** Check a `component.json` text against the files of its directory. Errors make a build fail; warnings do not. */
+export declare function checkComponent(text: string, fileNames: string[]): AiwsDiagnostic[];
+/** Read an AIWS manifest of any supported version as the current one (Q19); a newer one is refused. */
+export declare function compatManifest(value: unknown): AiwsManifest;
+/** Verify a bundle the way an installer does: manifest, each control's digest and component.json, no stray files. */
+export declare function verifyBundle(files: Map<string, Uint8Array>): Promise<{
+    manifest: AiwsManifest;
+    diagnostics: AiwsDiagnostic[];
+}>;
+/** The bundle of Workspace definitions (`ext.export`): the manifest plus every file's bytes. */
+export declare function exportBundle(client: AiwsExtRpc, workspaceId: string, entityIds: string[], fetchAsset: (workspaceId: string, objId: string) => Promise<Uint8Array>): Promise<AiwsBundle & {
+    controls: Record<string, unknown>[];
+}>;
+/** Make sure a folder exists, creating each missing level below the realm root (`/home`); answers its ref. Levels
+ * are looked up by listing their parent, so a missing one is not a failed request. */
+export declare function ensureFolder(nfsp: NfspClient, path: string): Promise<WireRef>;
+/** A folder's ref, or null when it (or a level above it) does not exist — found without failed requests. */
+export declare function findFolder(nfsp: NfspClient, path: string): Promise<WireRef | null>;
+/** Whether a folder holds a control source (its component.json). */
+export declare function hasControlSource(nfsp: NfspClient, dir: string): Promise<boolean>;
+/** Write one file into a folder (replacing it). */
+export declare function writeHomeFile(nfsp: NfspClient, dir: string | WireRef, name: string, bytes: Uint8Array): Promise<void>;
+/** The files of a control's source folder (flat; dot files are the client's own and skipped). */
+export declare function collectSources(nfsp: NfspClient, dir: string): Promise<AiwsSourceFile[]>;
+export declare function readBuildState(nfsp: NfspClient, dir: string): Promise<AiwsBuildState | null>;
+export declare function writeBuildState(nfsp: NfspClient, dir: string, state: AiwsBuildState): Promise<void>;
+export interface AiwsBuildOptions {
+    folderId?: string;
+    force?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Build the control in `dir` into a Workspace: collect the files, call `ext.build` with the base recorded in
+ * `.aiws-build.json` (when it is this Workspace's), and record the new base. Service refusals throw `AiwsFailure`
+ * (`BUILD_FAILED` carries `data.diagnostics`); source problems throw `AiwsSourceError`.
+ */
+export declare function buildControl(client: AiwsExtRpc, nfsp: NfspClient, workspaceId: string, dir: string, opts?: AiwsBuildOptions): Promise<Record<string, unknown> & {
+    files: AiwsSourceFile[];
+}>;
+/**
+ * Write a definition's Workspace snapshot into `outDir` (a definition never built from source gets synthesized
+ * files) and record it as the base of the next build.
+ */
+export declare function pullControl(client: AiwsExtRpc, nfsp: NfspClient, workspaceId: string, defEntityId: string, outDir: string, fetchAsset: (workspaceId: string, objId: string) => Promise<Uint8Array>): Promise<{
+    files: string[];
+    state: AiwsBuildState;
+}>;
+/**
+ * Rebuild whenever the folder changes: NFSP watch events (lossy: a `resync` lists again), debounced, and only when
+ * the files' objects differ from the last build. Returns when `signal` aborts.
+ */
+export declare function watchControl(nfsp: NfspClient, dir: string, onChange: (files: AiwsSourceFile[]) => Promise<void>, opts?: {
+    debounceMs?: number;
+    signal?: AbortSignal;
+}): Promise<void>;
+export interface AiwsSkeletonOptions {
+    authorDid: string;
+    name: string;
+    title?: string;
+    kind?: 'declarative' | 'html';
+}
+/** The files of a new control: a minimal working declarative or HTML control with one optional binding. */
+export declare function controlSkeleton(opts: AiwsSkeletonOptions): Record<string, string>;
+/** Create a control's source folder from a skeleton (refuses to overwrite a folder that has a component.json). */
+export declare function createControlSource(nfsp: NfspClient, dir: string, files: Record<string, string>): Promise<WireRef>;
+//# sourceMappingURL=aiws_ext.d.ts.map

package/dist/aiws_ext.d.ts.map

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