@consultancy-outfit/ai-draftsman-cli 0.0.0-stage → 1.1.1

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+# AI Draftsman CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Standalone Node.js/TypeScript CLI for the AI Draftsman platform.
+
+## Requirements
+
+- Node.js 20+
+- npm
+
+## Install dependencies
+
+```bash
+npm install
+```
+
+## Run from source
+
+Interactive default flow, Claude-Code style:
+
+```bash
+npm run dev
+```
+
+The CLI now defaults to:
+- backend URL: `https://dev-api.aidraftsman.ai/`
+- frontend URL: `https://dev-b2b.aidraftsman.ai/`
+- browser login if you are not authenticated yet
+- agent/model selection launcher after login, instead of asking for a base URL
+
+Examples:
+
+```bash
+npm run dev -- auth login
+npm run dev -- auth status
+npm run dev
+npm run dev -- agents list
+npm run dev -- agents run AGENT_ID --message "Summarize this project"
+npm run dev -- chat complete --model gpt-4o-mini --message "Hello"
+npm run dev -- conversations create --agent AGENT_ID
+npm run dev -- conversations send CONVERSATION_ID --message "Continue the work"
+npm run dev -- messages list CONVERSATION_ID
+npm run dev -- session exec --model agent:AGENT_ID --message "Plan the next step"
+npm run dev -- session start --model agent:AGENT_ID --durable
+npm run dev -- session resume CONVERSATION_ID --model agent:AGENT_ID
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+## Install globally on your system
+
+From npm:
+
+```bash
+npm install -g @consultancy-outfit/ai-draftsman-cli
+```
+
+Or from this project folder:
+
+```bash
+npm install
+npm run build
+npm install -g .
+```
+
+Then use either command:
+
+```bash
+aidraftsman --help
+ad --help
+```
+
+## Windows PowerShell examples
+
+```powershell
+npm install
+npm run build
+npm install -g .
+ad
+ad auth login
+ad agents list
+ad session start --model agent:AGENT_ID --durable
+```
+
+## Notes
+
+- `session start --durable` creates a durable conversation when the model is `agent:<id>`.
+- `session resume <conversationId> --model agent:<id>` continues by sending MCP messages to that conversation.
+- Current `--stream` support is terminal-style rendering built on one-shot responses, not full token streaming yet.
+
+## Images
+
+Attach images (png, jpg, gif, webp; up to 5 MB each) in any of these ways:
+
+```powershell
+ad -i screenshot.png "what is wrong with this layout?"   # interactive, first prompt
+ad -p -i a.png -i b.png "compare these two"               # print mode
+ad "match this design: @mockup.png"                       # an @path to an image is attached too
+ad chat complete --model agent:AGENT_ID --image shot.png --message "describe this"
+```
+
+The gateway must accept OpenAI-style `image_url` content parts, and the chosen model must support vision.

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node