Skip to content

[codex] publish GHL Agent Contract v2 manifest#1

Draft
MADPANDA3D wants to merge 31 commits into
mainfrom
feat/ghl-tool-manifest-v1
Draft

[codex] publish GHL Agent Contract v2 manifest#1
MADPANDA3D wants to merge 31 commits into
mainfrom
feat/ghl-tool-manifest-v1

Conversation

@MADPANDA3D

Copy link
Copy Markdown
Owner

Agent-first provider hardening

This draft reconciles the provider's deployed Agent Contract v2 work through
the normal repository review path.

User/agent problem

Provider discovery previously depended on inconsistent or incomplete metadata,
and fleet authorization, health, build provenance, and navigation behavior did
not share one enforceable contract. That made tool selection and production
truth harder for agents to trust.

Root cause

The provider did not own a complete versioned ToolManifest and the shared fleet
conformance gate did not exist in its repository. Runtime health and local
navigation behavior had also evolved independently across services.

Change

  • Publishes the provider-owned, lossless tool manifest with input/output schema,
    aliases, annotations, risk, contract tier, and build/catalog provenance.
  • Exposes the standard grant-only navigation surface:
    check_configuration, list_capabilities, get_endpoint_coverage,
    get_tool_usage, and find_tools.
  • Normalizes health/build/catalog fields while preserving compatibility fields.
  • Rejects missing or invalid Portal grants before provider parsing/work.
  • Adds the caller for the central reusable MCP conformance workflow.

Verification

  • Local provider tests, manifest contract checks, Compose validation, and
    tracked-secret scan passed before publication.
  • Live fleet conformance passed 13/13 providers.
  • Live golden prompts passed 52/52; positives ranked first and negative cases
    returned no result.
  • The deployed service reports a traceable build SHA and catalog version.

Merge ordering

This PR is intentionally a draft. The central reusable workflow in
MADPANDA3D/MADPANDA-MAIN-SITE must merge before this caller can resolve
@main. Hosted workflow evidence should be reviewed after that dependency is
available.

No force-push was used and unrelated worktree files were not staged.

Refs: MAD-636, MAD-625, MAD-639

Add the UI-observed Brand Voice clone contract as a source-only tool, add the newly published location conversation-channel endpoint, and refresh GHL audit counts to 651 runtime tools and 637 official endpoint matches.

Validation: npm run lint; npm run build; npm test -- --runInBand; npm run audit:openai; npm run audit:parity; npm run audit:security; portal clone/read/delete smoke.
Refs: TKT-000027

Refs: TKT-000028

Refs: TKT-000029

Refs: TKT-000036
Add a sourceUrl and hosted=false fileUrl path for remote-safe direct media uploads without base64 JSON inflation. Guard source fetches with public-host checks, redirect validation, and a 25 MB direct upload limit. Also make task timezone normalization deterministic across host timezones and refresh audited transitive dependency versions.

Refs: TKT-000092
Add a strict Portal-compatible provider catalog, standard navigation tools, conservative contract tiers, normalized health metadata, and build provenance while preserving the existing GHL upload aliases and legacy surface.

Refs: MAD-637
Permit only the five standard local support tools to run after Portal grant validation without provider credentials, while preserving PIT enforcement for initialize, discovery surfaces, category wrappers, and provider calls.

Refs: MAD-637
Permit protocol initialization before BYOK while keeping tools/list and all nonstandard provider tools credential-gated.\n\nRefs: MAD-639
@MADPANDA3D

Copy link
Copy Markdown
Owner Author

Upstream reconciliation is complete through a normal merge (no rebase or force-push).

  • merge commit: cea6aa0
  • PR state: clean and mergeable
  • TypeScript lint: pass
  • Jest: 49 suites / 567 tests pass
  • OpenAI readiness audit: 0 findings
  • production dependency audit: 0 vulnerabilities
  • Compose validation: pass with an explicit build SHA
  • preserved hardened public/BYOK auth and immutable deployment guidance
  • retained organization-main legacy dispatch aliases and branding assets

The shared-conformance caller may remain pending/failing until MADPANDA-MAIN-SITE PR #3 is reviewed and merged, because provider callers intentionally reference the central reusable workflow on @main.

Refs: MAD-625, MAD-639

@MADPANDA3D

Copy link
Copy Markdown
Owner Author

MAD-625 audit reproducibility follow-up:

  • commit: 6b51095
  • unchanged audit evidence now preserves the prior generated timestamp
  • running the readiness audit repeatedly leaves the tracked JSON byte-identical
  • focused stability tests: 2/2
  • full GHL suite: 49 suites / 567 tests
  • TypeScript lint and syntax checks passed
  • production dependency audit remains clean
  • script-only change; no runtime image or catalog deployment required

Refs: MAD-625

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