Skip to content

feat(A14): Vertex AI parser spec — Vertex artifacts → IR#17

Closed
ogkranthi wants to merge 4 commits into
mainfrom
agent/architect/A14
Closed

feat(A14): Vertex AI parser spec — Vertex artifacts → IR#17
ogkranthi wants to merge 4 commits into
mainfrom
agent/architect/A14

Conversation

@ogkranthi
Copy link
Copy Markdown
Owner

Summary

Adds specs/vertex-parser-spec.md — the specification for the Vertex AI → IR parser (reverse of the Vertex emitter). Implements the design contract for D23.

What's covered

Input formats

  • agent.json (required — AgentShift-generated or Vertex AI API export)
  • tools.json (optional — additional tool declarations from Vertex API)

Field mapping

  • Complete Vertex AI → IR field mapping table
  • displayName → slugified name
  • goal + instructionspersona.system_prompt reconstruction
  • Section recovery from linearized "SectionName:\ncontent" patterns
  • Function tools / OpenAPI tools / data store tools → ir.tools / ir.knowledge
  • Auth reconstruction (apiKey, oauth2, service account → ToolAuth types)

Governance extraction

  • L1 guardrail heuristic on instructions array (shared pattern with Bedrock parser)
  • "Restrictions:" instruction prefix → sections["guardrails"]

Round-trip fidelity

Documents what survives (name, system_prompt, sections, language, tools) and what is lossy (triggers, constraints, tool_permissions).

Shared utilities

Documents src/agentshift/parsers/utils.py — shared with Bedrock parser: slugify, extract_guardrails_from_text, infer_guardrail_category/severity, tool kind detection.

CLI contract

agentshift convert ./vertex-output/ --from vertex --to openclaw and variants.

Closes

A14 (Week 7 backlog)

… experiments) + clean up duplicate files

- Add Governance, Guardrail, ToolPermission, PlatformAnnotation to IR model
- Add governance extraction to OpenClaw parser (SOUL.md + tool permissions + L3 annotations)
- Add elevation engine (elevate_governance) for L2/L3 → L1 promotion
- Add governance_audit module with GPR/CFS scoring, CSV/JSON export, Rich tables
- Add `agentshift audit` and `agentshift audit-batch` CLI commands
- Integrate elevation into claude_code + copilot emitters
- Add experiments/ directory with 12 domain agents for research paper
- Remove duplicate sections 2.py and persona-sections-schema 2.md
- Mark T13 as merged in BACKLOG.md
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Mar 29, 2026

Deploying agentshift with  Cloudflare Pages  Cloudflare Pages

Latest commit: 0f076e3
Status: ✅  Deploy successful!
Preview URL: https://b06895dd.agentshift.pages.dev
Branch Preview URL: https://agent-dev-d22-d25.agentshift.pages.dev

View logs

@ogkranthi
Copy link
Copy Markdown
Owner Author

Spec cherry-picked to main directly due to BACKLOG rebase conflict. Merged as commit 48f4838.

@ogkranthi ogkranthi closed this Mar 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant