@auvira.ai/sdk 0.6.0 → 0.6.1

package/docs/host-integration-image-placement.md

@@ -69,45 +69,56 @@ completion: {
 }
 ```
 
-Rules gate **file classes** (regex on `changedFiles`) and **workspace paths** (must exist on disk). They do not encode `siteConfig` field paths — keep those in the host prompt compiler.
+Rules gate **file classes** (regex on `changedFiles`), **workspace paths** (exact or glob), and **file contents** (regex on disk at end of turn).
 
-Sandbox `job.json` supports the same `completion.rules` and `attachments` array (see [sandbox-runner.md](./sandbox-runner.md)).
+### Content-level rules (v0.6.1+)
+
+When file-path gates are not enough (e.g. `siteConfig.ts` changed but `backgroundImageUrl` missing), add `requiredContent`:
+
+```ts
+rules: {
+  requiredChanges: [
+    { pattern: "src/lib/siteConfig\\.ts", required: true },
+    { pattern: "src/app/page\\.tsx", required: true },
+  ],
+  requiredPaths: ["public/uploads/garden-path-*.png"], // globs supported
+  requireAssetPublish: false, // or omit when requiredPaths are all public/uploads/
+  requiredContent: [
+    {
+      pathPattern: "src/lib/siteConfig\\.ts",
+      contentPattern: 'backgroundImageUrl\\s*:\\s*["\']/uploads/',
+      nudge: "Set presentation.backgroundImageUrl to the uploaded /uploads/ URL.",
+    },
+  ],
+},
+wiringHints: {
+  requiredFields: ["presentation.backgroundImageUrl"], // nudge-only, opaque
+  configPaths: ["src/lib/siteConfig.ts"],
+},
+```
+
+**`requireAssetPublish` semantics:**
+
+| Value | Behavior |
+| --- | --- |
+| `false` / `"none"` | Skip `public/assets/` gate |
+| `"uploads"` | Skip `public/assets/` gate; use content rules for URL wiring |
+| `true` / `"assets"` | Require `public/assets/` change unless all `requiredPaths` are existing `public/uploads/` files |
+
+Override default `wiringPatterns` for image edits — the SDK default includes `/components/`, which is too permissive for config wiring checks.
+
+Sandbox `job.json` supports `completion.rules`, `completion.wiringHints`, and `attachments` (see [sandbox-runner.md](./sandbox-runner.md)). **Host tools are in-process only** — not serializable to sandbox v1.
 
 ## Layer 3 — Host-injectable tools
 
-Register domain tools at create or send time (in-process only; not serializable to sandbox v1):
+Register domain tools at **create or send** time (in-process only; not serializable to sandbox v1). You do **not** need to pass the same tools on both — send-time tools override create-time tools with the same name.
 
 ```ts
-import {
-  Agent,
-  createGetAttachmentUrlsHostTool,
-  type HostToolRegistration,
-} from "@auvira.ai/sdk";
-
-const placeImageTool: HostToolRegistration = {
-  definition: {
-    name: "place_image",
-    description: "Wire an uploaded attachment publicUrl into a resolved target field.",
-    parameters: {
-      type: "object",
-      properties: {
-        index: { type: "number" },
-        targetId: { type: "string" },
-      },
-      required: ["index", "targetId"],
-    },
-  },
-  handler: async (args, ctx) => {
-    // Host reads ctx.attachments, updates siteConfig / page TSX
-    return { ok: true, output: "Placed image" };
-  },
-};
+// Per-send (dynamic target per turn)
+await agent.send(payload, { hostTools: [placeUploadedImageTool] });
 
-const agent = await Agent.create({
-  model: { id: "MiniMax-M3", provider: "custom" },
-  local: { cwd: repoPath },
-  hostTools: [placeImageTool],
-});
+// Or create-time (stable across turns)
+await Agent.create({ ..., hostTools: [placeUploadedImageTool] });
 ```
 
 Constraints:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auvira.ai/sdk",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Cursor-SDK-compatible visual coding agent with custom model support",
   "type": "module",
   "main": "./dist/index.js",