takomi 2.1.38 → 2.1.40

package/plugins/takomi-flow/.codex-plugin/plugin.json

@@ -0,0 +1,36 @@
+{
+  "name": "takomi-flow",
+  "version": "0.1.0+codex.20260701110901",
+  "description": "Agent-first Google Flow browser automation for Codex and Takomi workflows.",
+  "author": {
+    "name": "JStaR Films Studios"
+  },
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "TakomiFlow",
+    "shortDescription": "Generate Flow images, videos, moodboards, and scene assets from Codex.",
+    "longDescription": "TakomiFlow turns Google Flow into a reusable creative asset lane for Codex and Takomi: bootstrap a trusted Chrome session, reuse an existing Flow browser, generate image keyframes or video shots with explicit spend guards, download assets, extract review frames, record project URLs, and hand off clean reports to the next agent.",
+    "developerName": "JStaR Films Studios",
+    "category": "Productivity",
+    "capabilities": [
+      "browser-automation",
+      "mcp-tools",
+      "video-generation",
+      "image-generation",
+      "asset-pipeline"
+    ],
+    "defaultPrompt": [
+      "Create a 4-second cinematic Google Flow shot for this scene and return the MP4, project URL, frames, and report.",
+      "Generate a 1:1 Flow keyframe image for this concept, then download and catalog it for my asset pipeline.",
+      "Turn this reference image into a short Flow video with a slow camera move and package the result for review.",
+      "Make a moodboard-style image set in Flow for this brand direction: premium, cinematic, practical lighting.",
+      "Check whether my trusted Flow browser is already running, reuse it if possible, then run a no-spend observe.",
+      "Review the latest TakomiFlow run, extract video frames, and collect the assets into my project folder."
+    ],
+    "brandColor": "#36DCFF",
+    "composerIcon": "./assets/composer-icon.png",
+    "logo": "./assets/logo.png",
+    "logoDark": "./assets/logo-dark.png"
+  }
+}

package/plugins/takomi-flow/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "takomi-flow": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "scripts/mcp-server.mjs"
+      ]
+    }
+  }
+}

package/plugins/takomi-flow/assets/capabilities.json

@@ -0,0 +1,203 @@
+{
+  "schemaVersion": 1,
+  "provider": "takomi-flow",
+  "description": "Safe browser-driven Google Flow asset generation for Codex agents.",
+  "kinds": ["video", "image"],
+  "modes": {
+    "video": ["text-to-video", "image-to-video"],
+    "image": ["text-to-image"]
+  },
+  "variations": {
+    "min": 1,
+    "max": 4,
+    "default": 1
+  },
+  "aspectRatios": ["16:9", "9:16", "1:1"],
+  "durationSeconds": {
+    "suggested": [4, 6, 8, 10],
+    "default": 4
+  },
+  "requestFields": [
+    {
+      "name": "kind",
+      "type": "enum",
+      "required": true,
+      "values": ["video", "image"],
+      "description": "The asset type to ask Flow for."
+    },
+    {
+      "name": "prompt",
+      "type": "string",
+      "required": true,
+      "description": "The natural-language generation prompt."
+    },
+    {
+      "name": "mode",
+      "type": "enum",
+      "required": false,
+      "values": ["text-to-video", "image-to-video", "text-to-image"],
+      "description": "The basic Flow generation mode hint."
+    },
+    {
+      "name": "variations",
+      "type": "integer",
+      "required": false,
+      "min": 1,
+      "max": 4,
+      "description": "How many variations to request or look for."
+    },
+    {
+      "name": "aspectRatio",
+      "type": "enum",
+      "required": false,
+      "values": ["16:9", "9:16", "1:1"],
+      "description": "Preferred image/video frame shape."
+    },
+    {
+      "name": "durationSeconds",
+      "type": "number",
+      "required": false,
+      "values": [4, 6, 8, 10],
+      "description": "Preferred video duration hint."
+    },
+    {
+      "name": "sourceAssets",
+      "type": "string[]",
+      "required": false,
+      "description": "Local images/videos to use as references when the Flow UI supports the selected mode."
+    },
+    {
+      "name": "extractFrames",
+      "type": "integer",
+      "required": false,
+      "description": "Number of review frames to extract from downloaded videos."
+    },
+    {
+      "name": "allowSpend",
+      "type": "boolean",
+      "required": false,
+      "description": "Explicit user approval to submit a generation that may spend Flow credits."
+    },
+    {
+      "name": "projectUrl",
+      "type": "string",
+      "required": false,
+      "description": "Existing Flow project URL to reuse instead of creating a new project."
+    },
+    {
+      "name": "reuseCurrentProject",
+      "type": "boolean",
+      "required": false,
+      "description": "Prefer the already open Flow project tab when attached to trusted Chrome."
+    },
+    {
+      "name": "allowNewProject",
+      "type": "boolean",
+      "required": false,
+      "description": "Permit clicking New project when no reusable project is available."
+    },
+    {
+      "name": "freshChatOnFailure",
+      "type": "boolean",
+      "required": false,
+      "description": "Recover stale or broken chat state by starting a fresh chat inside the same project."
+    },
+    {
+      "name": "editorWaitMs",
+      "type": "integer",
+      "required": false,
+      "description": "Override the Flow project editor readiness wait budget in milliseconds."
+    }
+  ],
+  "sourceAssets": {
+    "supported": true,
+    "note": "Source assets are part of the request contract; live UI attachment selectors still need tuning after observation."
+  },
+  "outputs": {
+    "runMetadata": "run.json",
+    "assetCatalog": "assets.json",
+    "downloadsFolder": "downloads/",
+    "screenshotsFolder": "screenshots/",
+    "framesFolder": "frames/"
+  },
+  "schemas": {
+    "request": "takomi-flow://schemas/request",
+    "result": "takomi-flow://schemas/result",
+    "collection": "takomi-flow://schemas/collection"
+  },
+  "settingsCoverage": {
+    "automatic": ["prompt", "project reuse", "same-project chat recovery", "download folder", "metadata", "asset catalog", "video review frame extraction"],
+    "selectorDependent": ["mode", "aspectRatio", "durationSeconds", "modelHint", "sourceAssets", "variations"],
+    "note": "Selector-dependent settings are preserved in settingsPlan metadata until live Flow controls are observed and tuned."
+  },
+  "safety": {
+    "spendGuardDefault": false,
+    "requiresAllowSpend": true,
+    "newProjectDefault": false,
+    "sameProjectChatRecovery": true,
+    "bypassCaptcha": false,
+    "bypassQuota": false,
+    "automateCredentials": false
+  },
+  "commands": [
+    "doctor",
+    "audit",
+    "examples",
+    "trusted-chrome",
+    "plan",
+    "bootstrap",
+    "observe",
+    "smoke",
+    "template",
+    "prepare",
+    "workflow",
+    "validate",
+    "generate",
+    "selftest",
+    "inspect",
+    "latest",
+    "runs",
+    "assets",
+    "review",
+    "collect",
+    "report",
+    "capabilities"
+  ],
+  "mcpTools": [
+    "takomi_flow_capabilities",
+    "takomi_flow_doctor",
+    "takomi_flow_audit",
+    "takomi_flow_examples",
+    "takomi_flow_plan",
+    "takomi_flow_template",
+    "takomi_flow_prepare",
+    "takomi_flow_workflow",
+    "takomi_flow_validate",
+    "takomi_flow_observe",
+    "takomi_flow_generate",
+    "takomi_flow_selftest",
+    "takomi_flow_inspect",
+    "takomi_flow_latest",
+    "takomi_flow_runs",
+    "takomi_flow_assets",
+    "takomi_flow_review",
+    "takomi_flow_collect",
+    "takomi_flow_report"
+  ],
+  "mcpResources": [
+    "takomi-flow://contract",
+    "takomi-flow://capabilities",
+    "takomi-flow://examples",
+    "takomi-flow://schemas/request",
+    "takomi-flow://schemas/result",
+    "takomi-flow://schemas/collection",
+    "takomi-flow://templates/video",
+    "takomi-flow://templates/image"
+  ],
+  "mcpPrompts": [
+    "takomi_flow_video_workflow",
+    "takomi_flow_image_workflow",
+    "takomi_flow_review_workflow",
+    "takomi_flow_collect_workflow"
+  ]
+}

package/plugins/takomi-flow/assets/collection.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "takomi-flow://schemas/collection",
+  "title": "TakomiFlow Collection Manifest",
+  "description": "Manifest written by the collect command when packaging run outputs for downstream projects.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schemaVersion", "status", "runId", "targetDir", "copied"],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "status": { "type": "string", "enum": ["collected", "empty"] },
+    "runId": { "type": "string" },
+    "sourceRunDir": { "type": "string" },
+    "targetDir": { "type": "string" },
+    "manifestPath": { "type": "string" },
+    "copied": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["source", "target"],
+        "properties": {
+          "source": { "type": "string" },
+          "target": { "type": "string" }
+        }
+      }
+    },
+    "review": { "type": "object" }
+  }
+}

package/plugins/takomi-flow/assets/examples.json

@@ -0,0 +1,94 @@
+{
+  "schemaVersion": 1,
+  "examples": [
+    {
+      "name": "cinematic-video",
+      "description": "A polished text-to-video shot with review frames and a clean handoff.",
+      "request": {
+        "schemaVersion": 1,
+        "kind": "video",
+        "prompt": "A 4 second cinematic hero shot of a creator's production desk at night: printed storyboards, reference photos, camera lens, warm desk lamp, slow push-in, premium film look, no readable text",
+        "variations": 1,
+        "aspectRatio": "16:9",
+        "durationSeconds": 4,
+        "mode": "text-to-video",
+        "modelHint": "best-available",
+        "allowSpend": false,
+        "extractFrames": 4,
+        "sourceAssets": []
+      }
+    },
+    {
+      "name": "moodboard-keyframe",
+      "description": "A square image/keyframe request for brand, pitch, or scene development.",
+      "request": {
+        "schemaVersion": 1,
+        "kind": "image",
+        "prompt": "Generate 1 1:1 image of a premium creative studio moodboard on a clean table: printed reference photos, storyboard cards, color swatches, a camera lens, warm desk lamp lighting, realistic paper texture, editorial composition, no readable text",
+        "variations": 1,
+        "aspectRatio": "1:1",
+        "mode": "text-to-image",
+        "modelHint": "best-available",
+        "allowSpend": false,
+        "sourceAssets": []
+      }
+    },
+    {
+      "name": "reference-image-to-video",
+      "description": "Animate a local reference image into a short cinematic motion asset.",
+      "request": {
+        "schemaVersion": 1,
+        "kind": "video",
+        "prompt": "Animate the source image into a slow cinematic push-in with soft parallax, practical light flicker, subtle dust in the air, and no readable text",
+        "variations": 1,
+        "aspectRatio": "16:9",
+        "durationSeconds": 4,
+        "mode": "image-to-video",
+        "modelHint": "best-available",
+        "allowSpend": false,
+        "extractFrames": 4,
+        "sourceAssets": ["C:/path/to/source-image.png"]
+      }
+    },
+    {
+      "name": "product-reveal-video",
+      "description": "A quick product-style B-roll prompt for social, landing pages, or pitch decks.",
+      "request": {
+        "schemaVersion": 1,
+        "kind": "video",
+        "prompt": "A 4 second premium product reveal shot of a matte black creative workstation on a clean table, soft cyan rim light, camera gliding past glass reflections, practical studio lighting, no readable text",
+        "variations": 1,
+        "aspectRatio": "16:9",
+        "durationSeconds": 4,
+        "mode": "text-to-video",
+        "modelHint": "best-available",
+        "allowSpend": false,
+        "extractFrames": 4,
+        "sourceAssets": []
+      }
+    },
+    {
+      "name": "character-portrait-image",
+      "description": "A visual-development portrait that can become a Flow video source later.",
+      "request": {
+        "schemaVersion": 1,
+        "kind": "image",
+        "prompt": "Generate 1 cinematic character portrait image of a young film director in a neon-lit editing suite, thoughtful expression, shallow depth of field, editorial realism, no readable text",
+        "variations": 1,
+        "aspectRatio": "1:1",
+        "mode": "text-to-image",
+        "modelHint": "best-available",
+        "allowSpend": false,
+        "sourceAssets": []
+      }
+    },
+    {
+      "name": "collect-after-review",
+      "description": "Downstream packaging pattern after a run has downloaded assets.",
+      "commands": [
+        "node scripts/takomi-flow.mjs review --run <run.json|run-dir> --frames 4",
+        "node scripts/takomi-flow.mjs collect --run <run.json|run-dir> --target-dir <project-output-folder> --frames 4 --include-frames"
+      ]
+    }
+  ]
+}

package/plugins/takomi-flow/assets/request.schema.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "takomi-flow://schemas/request",
+  "title": "TakomiFlow Request",
+  "description": "Request file for preparing or running a safe Google Flow image/video generation.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["kind", "prompt"],
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["video", "image"]
+    },
+    "prompt": {
+      "type": "string",
+      "minLength": 1
+    },
+    "variations": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 4,
+      "default": 1
+    },
+    "aspectRatio": {
+      "type": "string",
+      "enum": ["16:9", "9:16", "1:1"]
+    },
+    "durationSeconds": {
+      "type": "number",
+      "enum": [4, 6, 8, 10]
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["text-to-video", "image-to-video", "text-to-image"]
+    },
+    "modelHint": {
+      "type": "string",
+      "default": "best-available"
+    },
+    "outputDir": {
+      "type": "string",
+      "description": "Base directory where requests, run metadata, downloads, screenshots, frames, and reports are written."
+    },
+    "allowSpend": {
+      "type": "boolean",
+      "default": false,
+      "description": "Must be true, or TAKOMI_FLOW_ALLOW_SPEND=true must be set, before TakomiFlow submits a generation."
+    },
+    "extractFrames": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0
+    },
+    "sourceAssets": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "projectUrl": {
+      "type": "string",
+      "description": "Existing Google Flow project/editor URL to reuse for this generation."
+    },
+    "reuseCurrentProject": {
+      "type": "boolean",
+      "default": true,
+      "description": "When attached to Chrome, prefer an already open Flow project tab."
+    },
+    "allowNewProject": {
+      "type": "boolean",
+      "default": false,
+      "description": "Permit TakomiFlow to click New project when no reusable project/editor is available."
+    },
+    "freshChatOnFailure": {
+      "type": "boolean",
+      "default": true,
+      "description": "Try one same-project fresh chat recovery when prompt or submit controls are broken."
+    },
+    "editorWaitMs": {
+      "type": "integer",
+      "minimum": 1000,
+      "description": "Maximum time to wait for the Flow project editor to become usable."
+    },
+    "notes": {
+      "type": "string"
+    }
+  }
+}

package/plugins/takomi-flow/assets/result.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "takomi-flow://schemas/result",
+  "title": "TakomiFlow Run Result",
+  "description": "Run metadata written by TakomiFlow browser, smoke, generate, and self-test commands.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schemaVersion", "status", "runId"],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "status": {
+      "type": "string",
+      "enum": ["prepared", "ok", "downloaded", "manual_action_required", "blocked", "failed"]
+    },
+    "runId": { "type": "string" },
+    "command": { "type": "string" },
+    "kind": { "type": "string", "enum": ["video", "image"] },
+    "prompt": { "type": "string" },
+    "flowUrl": { "type": "string" },
+    "projectUrl": { "type": "string" },
+    "projectSession": { "type": "object" },
+    "settingsPlan": { "type": "object" },
+    "assets": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "assetCatalogPath": { "type": "string" },
+    "screenshots": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "errors": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "manualActions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "metadataPath": { "type": "string" }
+  }
+}

package/plugins/takomi-flow/assets/templates/image-request.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "kind": "image",
+  "prompt": "Describe the image Flow should generate.",
+  "variations": 1,
+  "aspectRatio": "1:1",
+  "mode": "text-to-image",
+  "modelHint": "best-available",
+  "outputDir": "C:/Users/johno/.takomi-flow/runs",
+  "allowSpend": false,
+  "sourceAssets": [],
+  "projectUrl": "",
+  "reuseCurrentProject": true,
+  "allowNewProject": false,
+  "freshChatOnFailure": true,
+  "notes": "Set allowSpend=true only after explicit user approval."
+}

package/plugins/takomi-flow/assets/templates/video-request.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "kind": "video",
+  "prompt": "Describe the video Flow should generate.",
+  "variations": 1,
+  "aspectRatio": "16:9",
+  "durationSeconds": 4,
+  "mode": "text-to-video",
+  "modelHint": "best-available",
+  "outputDir": "C:/Users/johno/.takomi-flow/runs",
+  "allowSpend": false,
+  "extractFrames": 4,
+  "sourceAssets": [],
+  "projectUrl": "",
+  "reuseCurrentProject": true,
+  "allowNewProject": false,
+  "freshChatOnFailure": true,
+  "notes": "Set allowSpend=true only after explicit user approval."
+}

package/plugins/takomi-flow/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "takomi-flow",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "description": "Agent-first Google Flow browser automation for Codex.",
+  "scripts": {
+    "takomi-flow": "node scripts/takomi-flow.mjs",
+    "doctor": "node scripts/takomi-flow.mjs doctor",
+    "audit": "node scripts/takomi-flow.mjs audit",
+    "capabilities": "node scripts/takomi-flow.mjs capabilities",
+    "examples": "node scripts/takomi-flow.mjs examples",
+    "trusted-chrome": "node scripts/takomi-flow.mjs trusted-chrome",
+    "plan": "node scripts/takomi-flow.mjs plan",
+    "observe": "node scripts/takomi-flow.mjs observe",
+    "bootstrap": "node scripts/takomi-flow.mjs bootstrap",
+    "smoke": "node scripts/takomi-flow.mjs smoke",
+    "template": "node scripts/takomi-flow.mjs template",
+    "validate-request": "node scripts/takomi-flow.mjs validate",
+    "prepare-request": "node scripts/takomi-flow.mjs prepare",
+    "workflow": "node scripts/takomi-flow.mjs workflow",
+    "generate": "node scripts/takomi-flow.mjs generate",
+    "selftest": "node scripts/takomi-flow.mjs selftest",
+    "mcp": "node scripts/mcp-server.mjs",
+    "mcp-smoke": "node scripts/mcp-smoke.mjs",
+    "inspect": "node scripts/takomi-flow.mjs inspect",
+    "runs": "node scripts/takomi-flow.mjs runs",
+    "assets": "node scripts/takomi-flow.mjs assets",
+    "review": "node scripts/takomi-flow.mjs review",
+    "collect": "node scripts/takomi-flow.mjs collect",
+    "report": "node scripts/takomi-flow.mjs report"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "playwright": "^1.61.1",
+    "zod": "^4.4.3"
+  }
+}