acrylblends 1.2.0 → 1.3.0

package/plugins/plugin-share/pulled-records.ts

@@ -0,0 +1,70 @@
+/**
+ * What an app remembers about the plugins it pulled: their source and digests, in the `plugin-share` row's config of `blend.yaml`. A row's config is
+ * resolved into `blend.lock.json` too, so the lock records them with no new format, and a copy of the app can fetch exactly the same bytes. Pure text
+ * to text; comments and the person's formatting stay.
+ */
+import { isMap, isSeq, parseDocument } from 'yaml'
+
+export const ROW = 'plugin-share'
+
+export interface PulledRecord {
+  /** `github:<owner>/<repo>@<version>` or an https address: something another machine can fetch. */
+  readonly source: string
+  /** The sha512 of the release file. */
+  readonly integrity: string
+  /** The sha256 of the plugin's content. */
+  readonly digest: string
+}
+
+const isRecord = (value: unknown): value is PulledRecord => {
+  const record = value as Partial<Record<keyof PulledRecord, unknown>> | null
+  return (
+    typeof record?.source === 'string' &&
+    typeof record.integrity === 'string' &&
+    typeof record.digest === 'string'
+  )
+}
+
+/** The plugins this definition remembers pulling. */
+export function pulledRecords(text: string): Readonly<Record<string, PulledRecord>> {
+  const rows = (parseDocument(text).toJS() as { spec?: { rows?: unknown } } | null)?.spec?.rows
+  if (!Array.isArray(rows)) return {}
+  const pulled = (
+    rows.find((row: { name?: unknown }) => row?.name === ROW) as
+      | { config?: { pulled?: unknown } }
+      | undefined
+  )?.config?.pulled
+  if (typeof pulled !== 'object' || pulled === null) return {}
+  return Object.fromEntries(
+    Object.entries(pulled).filter(([, record]) => isRecord(record)),
+  ) as Record<string, PulledRecord>
+}
+
+/**
+ * The definition with one plugin's record written, or taken out when `record` is undefined. Unchanged when it has no `plugin-share` row: an app
+ * composed without the row has nowhere to remember.
+ */
+export function withPulledRecord(
+  text: string,
+  name: string,
+  record: PulledRecord | undefined,
+): string {
+  const document = parseDocument(text)
+  const rows = document.getIn(['spec', 'rows'])
+  if (!isSeq(rows)) return text
+  const row = rows.items.find((item) => isMap(item) && item.get('name') === ROW)
+  if (!isMap(row)) return text
+  if (record === undefined) {
+    if (!row.hasIn(['config', 'pulled', name])) return text
+    row.deleteIn(['config', 'pulled', name])
+    const left = row.getIn(['config', 'pulled'])
+    if (isMap(left) && left.items.length === 0) row.deleteIn(['config', 'pulled'])
+    const config = row.get('config')
+    if (isMap(config) && config.items.length === 0) row.delete('config')
+  } else {
+    row.setIn(['config'], row.get('config') ?? document.createNode({}))
+    if (!row.hasIn(['config', 'pulled'])) row.setIn(['config', 'pulled'], document.createNode({}))
+    row.setIn(['config', 'pulled', name], document.createNode(record))
+  }
+  return String(document)
+}

package/templates/agent/.gitattributes

@@ -0,0 +1,2 @@
+# Every checkout has the same line endings, on every OS. A plugin's digest counts every byte, so a CRLF checkout would make it a different plugin.
+* text=auto eol=lf

package/templates/agent/blend.yaml

@@ -49,6 +49,8 @@ spec:
         approval: "{{parameters.approval}}"
     - id: builder
       name: builder
+    - id: plugin-share
+      name: plugin-share
     - id: save
       name: save
     # The panel: a chat button on every page in development (the app's own agent, or Codex, Claude or pi started in this folder). It starts nothing in production.

package/templates/agent/src/app.ts

@@ -20,6 +20,7 @@ import {
   type ParameterValue,
 } from '../plugins/manifest/index.ts'
 import { ASSISTANT_PROMPT, type OpenAIConfig, openai } from '../plugins/openai/index.ts'
+import { pluginShare } from '../plugins/plugin-share/index.ts'
 import { sandboxPlugin } from '../plugins/sandbox/index.ts'
 import { save } from '../plugins/save/index.ts'
 import { tasks } from '../plugins/tasks/index.ts'
@@ -36,6 +37,7 @@ export const registry = {
   'acryl-state': state,
   extensions,
   builder,
+  'plugin-share': pluginShare,
   save,
   sandbox: sandboxPlugin,
   routes,
@@ -77,6 +79,7 @@ export interface App {
 const DEVELOPMENT_ROWS: Record<string, string> = {
   agent: 'POST /ask runs the agent, which spends the model key and calls its tools',
   builder: 'the agent can write plugin source into plugins/',
+  'plugin-share': 'a plugin pulled from a release runs in this process',
   extensions:
     'a plugin installed live runs in this process, and POST /extensions/approve decides installs',
 }
@@ -215,6 +218,7 @@ export async function composeInto(
           rows: ownRows,
         },
         builder: { dir: extensionsDir },
+        'plugin-share': { dir: extensionsDir },
         ...(assistant
           ? {
               // Every answer comes right after a look, so it says what the visitor's page shows now.

package/templates/agent/template.json

@@ -12,6 +12,7 @@
     "sandbox",
     "extensions",
     "builder",
+    "plugin-share",
     "agent-panel",
     "manifest",
     "save",

package/templates/blank/.gitattributes

@@ -0,0 +1,2 @@
+# Every checkout has the same line endings, on every OS. A plugin's digest counts every byte, so a CRLF checkout would make it a different plugin.
+* text=auto eol=lf

package/templates/chat/.gitattributes

@@ -0,0 +1,2 @@
+# Every checkout has the same line endings, on every OS. A plugin's digest counts every byte, so a CRLF checkout would make it a different plugin.
+* text=auto eol=lf

package/templates/nodejs/.gitattributes

@@ -0,0 +1,2 @@
+# Every checkout has the same line endings, on every OS. A plugin's digest counts every byte, so a CRLF checkout would make it a different plugin.
+* text=auto eol=lf

package/templates/notes/.gitattributes

@@ -0,0 +1,2 @@
+# Every checkout has the same line endings, on every OS. A plugin's digest counts every byte, so a CRLF checkout would make it a different plugin.
+* text=auto eol=lf

package/templates/todo/.gitattributes

@@ -0,0 +1,2 @@
+# Every checkout has the same line endings, on every OS. A plugin's digest counts every byte, so a CRLF checkout would make it a different plugin.
+* text=auto eol=lf