imagegen-smarto 0.1.0

package/README.md

@@ -0,0 +1,63 @@
+# imagegen-smarto
+
+Codex skill for sending natural-language image generation and editing requests
+through a custom SmartO OpenAI-compatible VPS relay.
+
+The skill does not call Codex's built-in `image_gen` tool. It places a private
+routing marker in the Responses instructions; the relay adds its
+`image_generation` tool only for requests that load this skill. Ordinary
+non-image requests remain unchanged.
+
+## Install with npm
+
+The recommended installation is the same on Windows, Linux, and macOS:
+
+```bash
+npm install --global imagegen-smarto
+```
+
+The npm postinstall step copies the skill to `CODEX_HOME/skills/imagegen-smarto`
+or, when `CODEX_HOME` is not set, `~/.codex/skills/imagegen-smarto`.
+
+To reinstall or update the skill without reinstalling the npm package:
+
+```bash
+imagegen-smarto install
+```
+
+To print the target directory:
+
+```bash
+imagegen-smarto path
+```
+
+If npm lifecycle scripts are disabled, run `imagegen-smarto install` once after
+the global npm installation.
+
+## Install with the Codex installer
+
+The preinstalled Codex skill installer remains available as a fallback:
+
+```bash
+python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
+  --repo 24kmojito763/imagegen-smarto \
+  --path imagegen-smarto \
+  --method git
+```
+
+After installation, use a profile that enables `imagegen-smarto` and disables
+the official `imagegen` skill. The skill is configured for implicit invocation,
+so an image request can be written in natural language without first typing
+`$imagegen-smarto`.
+
+## Local profile switch
+
+The two profiles used by the author are:
+
+```bash
+codex --profile smarto
+codex --profile official
+```
+
+`smarto` selects the custom relay and enables this skill. `official` selects
+the built-in OpenAI provider and enables Codex's original `imagegen` skill.

package/bin/cli.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+'use strict'
+
+const fs = require('node:fs')
+const os = require('node:os')
+const path = require('node:path')
+
+const packageRoot = path.resolve(__dirname, '..')
+const bundledSkillPath = path.join(packageRoot, 'imagegen-smarto')
+
+function printHelp() {
+  console.log(`imagegen-smarto - install the Codex SmartO image skill
+
+Usage:
+  imagegen-smarto install [--codex-home <path>]
+  imagegen-smarto path [--codex-home <path>]
+  imagegen-smarto --help
+
+The default Codex home is CODEX_HOME or ~/.codex.`)
+}
+
+function parseArgs(argv) {
+  const args = [...argv]
+  let command = 'install'
+  let codexHome
+  let quiet = false
+
+  if (args[0] && !args[0].startsWith('-')) {
+    command = args.shift()
+  }
+
+  while (args.length > 0) {
+    const arg = args.shift()
+    if (arg === '--codex-home') {
+      codexHome = args.shift()
+      if (!codexHome) {
+        throw new Error('--codex-home requires a path')
+      }
+    } else if (arg === '--quiet' || arg === '--postinstall') {
+      quiet = true
+    } else if (arg === '--help' || arg === '-h') {
+      command = 'help'
+    } else {
+      throw new Error(`unknown option: ${arg}`)
+    }
+  }
+
+  return { command, codexHome, quiet }
+}
+
+function resolveCodexHome(explicitPath) {
+  const configuredPath = explicitPath || process.env.CODEX_HOME
+  if (configuredPath && configuredPath.trim()) {
+    return path.resolve(configuredPath)
+  }
+  return path.join(os.homedir(), '.codex')
+}
+
+function getSkillTarget(codexHome) {
+  return path.join(codexHome, 'skills', 'imagegen-smarto')
+}
+
+function installSkill(codexHome) {
+  const sourceSkillFile = path.join(bundledSkillPath, 'SKILL.md')
+  if (!fs.existsSync(sourceSkillFile)) {
+    throw new Error(`bundled skill is missing: ${sourceSkillFile}`)
+  }
+
+  const target = getSkillTarget(codexHome)
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  fs.cpSync(bundledSkillPath, target, { recursive: true, force: true })
+  return target
+}
+
+function main() {
+  const { command, codexHome: explicitCodexHome, quiet } = parseArgs(process.argv.slice(2))
+
+  if (command === 'help') {
+    printHelp()
+    return
+  }
+
+  const codexHome = resolveCodexHome(explicitCodexHome)
+  if (command === 'path') {
+    console.log(getSkillTarget(codexHome))
+    return
+  }
+
+  if (command !== 'install') {
+    throw new Error(`unknown command: ${command}`)
+  }
+
+  const target = installSkill(codexHome)
+  if (!quiet) {
+    console.log(`Installed imagegen-smarto to ${target}`)
+  }
+}
+
+try {
+  main()
+} catch (error) {
+  console.error(`imagegen-smarto: ${error.message}`)
+  process.exitCode = 1
+}

package/imagegen-smarto/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: imagegen-smarto
+description: Generate or edit raster images through the user's SmartO OpenAI-compatible VPS relay. Automatically use this skill for natural-language requests to create, draw, generate, or edit an image when the SmartO relay profile is active; do not use it for image analysis or coding tasks, official OpenAI/ChatGPT providers, or the built-in image_gen tool.
+---
+
+# SmartO relay image generation
+
+Use this skill for actual raster-image generation or editing requests when the
+SmartO relay profile is active. It is implicitly invokable, so the user should
+be able to ask for an image in natural language without first writing
+`$imagegen-smarto`.
+
+This skill is a routing signal, not a local image-generation tool:
+
+- Never call the built-in `image_gen` tool or any other native image tool.
+- Never use the CLI/API fallback or ask for `OPENAI_API_KEY`.
+- Keep the user's natural-language image prompt, reference images, and edit
+  constraints in the normal Responses request.
+- Do not add a tool to ordinary non-image requests.
+- Do not expose the routing marker in the user-visible answer.
+
+The relay recognizes the marker below in the active skill instructions. Keep
+this marker stable because it is the relay-side routing contract. Only image
+requests that load this skill should cause the relay to add the Responses
+built-in image tool:
+
+`__CODEX_VPS_IMAGEGEN__`
+
+The relay-side rule should apply only to `/v1/responses` requests whose
+`instructions` contain that marker. It should add this tool when the request
+does not already declare tools:
+
+```json
+{"type":"image_generation","action":"auto"}
+```
+
+It may set `tool_choice` to `auto` only when the client did not provide one.
+Do not force image generation for every turn. The upstream model decides from
+the natural-language request whether to generate a new image or edit an image
+in context.
+
+The relay must forward `image_generation_call` output items unchanged. A
+completed item contains a base64 image in `result`; do not turn it into a text
+description or replace it with the built-in tool protocol.
+
+When the active provider is the official OpenAI/ChatGPT provider, leave this
+skill unused so the original `imagegen` skill remains available there.

package/imagegen-smarto/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "SmartO VPS Image Generation"
+  short_description: "Generate images through the SmartO VPS relay"
+  default_prompt: "Use $imagegen-smarto to generate or edit an image through my SmartO VPS relay."
+
+policy:
+  allow_implicit_invocation: true

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "imagegen-smarto",
+  "version": "0.1.0",
+  "description": "Install the imagegen-smarto Codex skill on Windows and Linux.",
+  "bin": {
+    "imagegen-smarto": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "imagegen-smarto/",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node bin/cli.js install --postinstall"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/24kmojito763/imagegen-smarto.git"
+  },
+  "homepage": "https://github.com/24kmojito763/imagegen-smarto",
+  "keywords": [
+    "codex",
+    "openai",
+    "image-generation",
+    "skill"
+  ],
+  "license": "MIT"
+}