procesio-cli 0.1.1__py3-none-any.whl

procesio_cli/tools/connector-builder/tool.yaml

@@ -0,0 +1,671 @@
+# GENERATED by gen_manifest.py from the live ACTIONS dict — do not
+# hand-edit actions/args; edit the handlers + header consts and rerun:
+#   .venv/Scripts/python tools/connector-builder/gen_manifest.py
+name: connector-builder
+description: 'AI Connector Builder (connector-builder.procesio.app): turn API documentation into a compiled
+  PROCESIO Custom Action .nupkg connector via an 8-stage LLM pipeline (gather -> clarify -> plan -> generate
+  -> validate -> compile -> fix -> deliver). Drive the whole build lifecycle, read/write generated files,
+  download the .nupkg artifact (to upload to PROCESIO for live testing), inspect logs/telemetry, and edit
+  the builder''s own knowledge base (prompts, spec modules, examples, validation rules). Two auth modes,
+  both -> Bearer token: an acb_ API key, or username/password via /auth/login.'
+version: 0.2.0
+runtime: python
+entrypoint: main.py
+secrets:
+- name: api-key
+  description: Connector Builder API key (acb_...). Used verbatim as the bearer token.
+- name: username
+  description: Login email for username/password auth mode (e.g. user@example.com).
+- name: password
+  description: Login password for username/password auth mode (-> POST /auth/login -> JWT).
+routing:
+  triggers:
+  - build a PROCESIO custom action / connector from API docs
+  - generate a .nupkg connector for PROCESIO from documentation
+  - create / run / drive an AI Connector Builder build
+  - approve / revise the plan / regenerate files / download the connector artifact
+  - edit the connector builder's prompts / spec modules / examples (improve generation)
+  primary_action: create-build
+  example: connector-builder create-build --api-url <docs-url> --user-requirements '...'   (then gather
+    / answer / approve-plan / approve-generate / download-artifact)
+actions:
+- name: answer
+  description: Submit clarification answers; triggers PLAN.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: answers
+    type: string
+    required: true
+    description: JSON object {"q1":"a1","q2":"a2"}
+  - name: wait
+    type: boolean
+    description: Poll get-build until the stage settles (survives the proxy 504)
+  - name: wait-timeout
+    type: integer
+    description: Max seconds to poll when --wait (default 600)
+  - name: poll-interval
+    type: integer
+    description: Seconds between polls when --wait (default 8)
+  output_schema: '{ "status": "planning", "implementation_plan": {...} }'
+- name: api
+  description: Call any endpoint (method/path/query/body); --out streams binary.
+  args:
+  - name: method
+    type: string
+    description: HTTP method (GET/POST/PUT/PATCH/DELETE)
+  - name: path
+    type: string
+    required: true
+    description: Endpoint path, e.g. /builds or /admin/users
+  - name: query
+    type: string
+    description: Query params as a JSON object
+  - name: body
+    type: string
+    description: Request body as JSON (object or array)
+  - name: out
+    type: string
+    description: If set, stream the response to this file (binary)
+- name: approve-generate
+  description: Accept generated files; runs VALIDATE->COMPILE->FIX->DELIVER.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  output_schema: '{ "status": "approved", "build_id": "uuid" }'
+- name: approve-plan
+  description: Approve plan; triggers GENERATE (then pauses).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  output_schema: '{ "status": "generating", "step_status": "waiting_user", "generated_files": {...} }'
+- name: archive
+  description: Archive a build (admin).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: build-selftest
+  description: Compiler health self-test (trivial C#).
+- name: check
+  description: Connectivity + auth probe (GET /auth/me).
+  output_schema: '{ "ok": true, "email": "...", "role": "admin", "base_url": "..." }'
+- name: create-api-key
+  description: Create an API key (full_key shown only once).
+  args:
+  - name: name
+    type: string
+    required: true
+    description: Label for the new API key
+- name: create-build
+  description: Create a build from URL(s) / pasted docs.
+  args:
+  - name: api-url
+    type: string
+    description: Single API docs URL
+  - name: api-urls
+    type: string
+    description: JSON array of doc URLs
+  - name: api-docs-text
+    type: string
+    description: Pasted API documentation text
+  - name: user-requirements
+    type: string
+    description: What the connector should do
+  output_schema: '{ "id": "uuid", "status": "pending", ... }'
+- name: delete-llm-key
+  description: Remove the stored LLM provider key.
+- name: download-all
+  description: Download all generated files as a zip to --out.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: out
+    type: string
+    required: true
+    description: Output file path
+- name: download-artifact
+  description: Download the compiled .nupkg to --out (upload to PROCESIO).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: out
+    type: string
+    required: true
+    description: Output file path
+  output_schema: '{ "out": "...", "bytes": N, "filename": "..._PROCESIO.API.nupkg" }'
+- name: download-file
+  description: Download one generated file to --out.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: filename
+    type: string
+    required: true
+  - name: out
+    type: string
+    required: true
+    description: Output file path
+- name: events
+  description: Per-build pipeline events.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: page
+    type: integer
+    description: Page number (default 1)
+  - name: per-page
+    type: integer
+    description: Items per page (default 100)
+  - name: step
+    type: string
+    description: Filter by step
+  - name: level
+    type: string
+    description: Filter by level
+  - name: event-type
+    type: string
+    description: Filter by event type
+- name: gather
+  description: Run GATHER+CLARIFY (profile+questions); --wait survives the 504.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: wait
+    type: boolean
+    description: Poll get-build until the stage settles (survives the proxy 504)
+  - name: wait-timeout
+    type: integer
+    description: Max seconds to poll when --wait (default 600)
+  - name: poll-interval
+    type: integer
+    description: Seconds between polls when --wait (default 8)
+  output_schema: '{ "status": "clarifying", "api_profile": {...}, "clarification_questions": [...] }'
+- name: get-build
+  description: Full build detail (all JSONB fields).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: get-config
+  description: Read a config block (pipeline/providers/...).
+  args:
+  - name: which
+    type: string
+    required: true
+    description: pipeline | providers | compilation | maintenance
+- name: get-file-version
+  description: Full content of one file at a specific version.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: filename
+    type: string
+    required: true
+  - name: version
+    type: string
+    required: true
+    description: Version number
+- name: get-issue
+  description: Full issue-case detail incl. snapshots.
+  args:
+  - name: id
+    type: string
+    required: true
+    description: Issue case id
+- name: knowledge-create
+  description: Create a new knowledge module.
+  args:
+  - name: module-type
+    type: string
+    required: true
+    description: one of prompt, spec_module, example, validation_rule, clarification
+  - name: name
+    type: string
+    required: true
+    description: Module name, e.g. clarify.md
+  - name: content
+    type: string
+    description: Module content (inline)
+  - name: content-file
+    type: string
+    description: Read module content from path
+- name: knowledge-delete
+  description: Delete a knowledge module.
+  args:
+  - name: module-type
+    type: string
+    required: true
+    description: one of prompt, spec_module, example, validation_rule, clarification
+  - name: name
+    type: string
+    required: true
+    description: Module name, e.g. clarify.md
+- name: knowledge-get
+  description: Get one knowledge module's content.
+  args:
+  - name: module-type
+    type: string
+    required: true
+    description: one of prompt, spec_module, example, validation_rule, clarification
+  - name: name
+    type: string
+    required: true
+    description: Module name, e.g. clarify.md
+- name: knowledge-list
+  description: List knowledge modules of a type.
+  args:
+  - name: module-type
+    type: string
+    required: true
+    description: one of prompt, spec_module, example, validation_rule, clarification
+- name: knowledge-update
+  description: Update an existing knowledge module.
+  args:
+  - name: module-type
+    type: string
+    required: true
+    description: one of prompt, spec_module, example, validation_rule, clarification
+  - name: name
+    type: string
+    required: true
+    description: Module name, e.g. clarify.md
+  - name: content
+    type: string
+    description: Module content (inline)
+  - name: content-file
+    type: string
+    description: Read module content from path
+- name: list-api-keys
+  description: List your API keys.
+- name: list-builds
+  description: List builds (paginated, filterable).
+  args:
+  - name: page
+    type: integer
+    description: Page number (default 1)
+  - name: per-page
+    type: integer
+    description: Items per page (default 20)
+  - name: status
+    type: string
+    description: Filter by pipeline status
+  - name: archive-status
+    type: string
+    description: active | archived | all
+  - name: created-by
+    type: string
+    description: UUID CSV (admin only)
+  output_schema: '{ "builds": [...], "total": N, "page": 1, "per_page": 20 }'
+- name: list-file-versions
+  description: Version metadata for every file in a build (no content).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: list-issues
+  description: List issue cases (failures), filterable.
+  args:
+  - name: page
+    type: integer
+    description: Page number (default 1)
+  - name: per-page
+    type: integer
+    description: Items per page (default 20)
+  - name: stage
+    type: string
+    description: Pipeline stage filter
+  - name: severity
+    type: string
+    description: Severity filter
+  - name: status
+    type: string
+    description: Status filter
+  - name: build-id
+    type: string
+    description: Filter by build
+  - name: error-category
+    type: string
+    description: Error category filter
+  - name: search
+    type: string
+    description: Free-text search
+- name: list-messages
+  description: Chat/system messages for a build.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: page
+    type: integer
+    description: Page number (default 1)
+  - name: per-page
+    type: integer
+    description: Items per page (default 100)
+  - name: step
+    type: string
+    description: Filter by step
+- name: list-users
+  description: List all users (admin).
+- name: logs
+  description: Per-build stage logs (model/cost/token breakdown).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: page
+    type: integer
+  - name: page-size
+    type: integer
+    description: Max 500
+  - name: stage
+    type: string
+    description: Comma-separated stage names
+  - name: success
+    type: boolean
+    description: Filter by success true/false
+  - name: model
+    type: string
+    description: Comma-separated model names
+  - name: model-search
+    type: string
+    description: Substring model search
+  - name: after
+    type: string
+    description: ISO datetime lower bound
+  - name: before
+    type: string
+    description: ISO datetime upper bound
+- name: override-stage
+  description: Jump the build to a target step/status.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: target-step
+    type: integer
+    required: true
+    description: Target stage 1-8
+  - name: target-status
+    type: string
+    required: true
+    description: running | waiting_user
+- name: post-message
+  description: Post a chat message to a build/step.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: step
+    type: string
+    required: true
+    description: Pipeline step, e.g. clarify | plan
+  - name: content
+    type: string
+    required: true
+    description: Message text
+- name: regenerate
+  description: Regenerate files with per-file/general instructions.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: file-instructions
+    type: string
+    description: JSON object {"File.cs":"instructions"}
+  - name: step-instructions
+    type: string
+    description: General feedback for the whole generation step
+- name: regenerate-file
+  description: Regenerate a single file with instructions.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: filename
+    type: string
+    required: true
+    description: File to regenerate
+  - name: instructions
+    type: string
+    required: true
+    description: Instructions for the file
+- name: reload-config
+  description: Reload all YAML config + knowledge cache.
+- name: reset
+  description: Reset a failed/clarifying/planning build to pending.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: revise
+  description: Re-open a COMPLETED build to the generate pause for a small fix (then regenerate-file + approve-generate); bumps the version.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: retry
+  description: Retry the pipeline from a step (or last failed).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: from-step
+    type: integer
+    description: 'Stage number to retry from (default: last failed)'
+- name: revise-plan
+  description: Revise the plan with free-text feedback.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: feedback
+    type: string
+    required: true
+    description: Plan revision feedback
+  - name: wait
+    type: boolean
+    description: Poll get-build until the stage settles (survives the proxy 504)
+  - name: wait-timeout
+    type: integer
+    description: Max seconds to poll when --wait (default 600)
+  - name: poll-interval
+    type: integer
+    description: Seconds between polls when --wait (default 8)
+- name: revoke-api-key
+  description: Revoke an API key by id.
+  args:
+  - name: id
+    type: string
+    required: true
+    description: API key id to revoke
+- name: set-file-instructions
+  description: Save per-file regeneration instructions.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: filename
+    type: string
+    required: true
+  - name: instructions
+    type: string
+    required: true
+- name: set-llm-key
+  description: Set the LLM provider key that powers builds.
+  args:
+  - name: api-key
+    type: string
+    required: true
+    description: LLM provider API key (e.g. sk-ant-... / sk-...)
+  - name: provider
+    type: string
+    required: true
+    description: Provider id, e.g. anthropic | openai
+- name: set-version
+  description: Set Major.Minor.Patch (at Plan/waiting_user).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: major
+    type: integer
+    required: true
+  - name: minor
+    type: integer
+    required: true
+  - name: patch
+    type: integer
+    required: true
+- name: stage-override-options
+  description: Valid stage-override targets for override-stage.
+- name: start-build
+  description: Run the FULL pipeline as a background task.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: telemetry
+  description: Cross-build LLM telemetry (cost/tokens/latency), filterable.
+  args:
+  - name: page
+    type: integer
+  - name: page-size
+    type: integer
+    description: Max 500
+  - name: build-id
+    type: string
+    description: Comma-separated build UUIDs to filter
+  - name: stage
+    type: string
+    description: Comma-separated stage names
+  - name: success
+    type: boolean
+    description: Filter by success true/false
+  - name: model
+    type: string
+    description: Comma-separated model names
+  - name: model-search
+    type: string
+    description: Substring model search
+  - name: after
+    type: string
+    description: ISO datetime lower bound
+  - name: before
+    type: string
+    description: ISO datetime upper bound
+- name: unarchive
+  description: Unarchive a build (admin).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: update-config
+  description: Update a config block from JSON.
+  args:
+  - name: which
+    type: string
+    required: true
+    description: pipeline | providers | compilation | maintenance
+  - name: data
+    type: string
+    description: Config payload as JSON (inline)
+  - name: data-file
+    type: string
+    description: Read JSON payload from path
+- name: update-file
+  description: Overwrite a file's content (inline or from --content-file).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: filename
+    type: string
+    required: true
+  - name: content
+    type: string
+    description: New file content (inline)
+  - name: content-file
+    type: string
+    description: Read new content from this path
+- name: validate-autofix
+  description: Auto-fix validation findings.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: validate-continue
+  description: Continue past validation to COMPILE.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: validate-return-to-generate
+  description: Return from VALIDATE back to GENERATE.
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+- name: wait-build
+  description: Poll get-build until settled/terminal (use after approve-generate/retry).
+  args:
+  - name: build-id
+    type: string
+    required: true
+    description: Build UUID
+  - name: wait-timeout
+    type: integer
+    description: Max seconds to poll (default 600)
+  - name: poll-interval
+    type: integer
+    description: Seconds between polls (default 8)
+  - name: until
+    type: string
+    description: settled (waiting_user or terminal) | terminal (only completed/failed/...)
+- name: whoami
+  description: Full current-user record (GET /auth/me).
+
+# Live-credential probe for the setup dashboard: a cheap, read-only
+# call proving the stored credential is currently authorized.
+healthcheck:
+  action: list-builds
+  label: "list builds"

procesio_cli/tools/framework-map/.gitattributes

@@ -0,0 +1,2 @@
+# framework-map is LF-only: keeps map rebuilds from churning line endings
+* text=auto eol=lf