Agent integrations

Connect OKKI Go through explicit runtime boundaries

Treat every input source, research action, credential, and output destination as a governed connection. The canvas shows a reference architecture, not a claim of verified support for a named third-party platform.

npx -y @okki-global/okki-go-taroball
OKKI Go runtime architecture with input, research, review, and output nodes
Input contractScoped toolsHuman reviewControlled output

Runtime matrix

Describe connections by behavior, permission, and status

Do not mistake a decorative logo wall for an integration contract. Confirm each connection in the environment where the skill runs, and label unverified routes honestly.

01

Input sources

Natural-language briefScope: market, roles, exclusions, evidence
Native input
Approved account filePermission: read selected file
Config-dependent
CRM contextPermission: define read scope first
Verify locally
02

Research agent

Company research toolContract: fields, sources, rate limits
Config-dependent
Contact context toolContract: lawful use and freshness
Config-dependent
Review checkpointPermission: accept, reject, investigate
Workflow state
03

Output destinations

Structured resultScope: approved fields and review notes
Native output
Spreadsheet or filePermission: write selected destination
Config-dependent
CRM write-backPermission: field-level write scope
Verify locally
Evidence level 1

Declared

A connection is named in configuration, but no successful request has been observed in the current environment.

Evidence level 2

Observed

A dated, read-only test records the runtime version, provider, permission scope, request ID, latency, returned fields, and failure state.

Evidence level 3

Revalidated

The same fixture passes after a package, runtime, provider API, permission, or schema change. Any one of those changes invalidates the earlier status until retested.

Inspectable handoff

A result should carry its review context

This SAMPLE illustrates the fields a team may use to understand an agent result. It does not represent a real company, person, source provider, or integration.

SAMPLE RESULT

Structured candidate

Company
Example Meridian
Fit rationale
Selected attributes align; trigger remains unconfirmed.
Contact context
Role evidence available; channel freshness unresolved.
Review state
Investigate further
MINIMUM RUN MANIFEST

Make one result reproducible enough to challenge

Environmentobserved_at_utc
os_version
node_version
agent_runtime
runtime_version
Packagepackage_name
resolved_version
installer_exit_code
install_seconds
configuration_hash
Connectionprovider_name
endpoint_or_tool
permission_scope
request_id
latency_ms
Decisionfixture_id
source_checked_at
review_state
reviewer_reason
failure_code

Never place API keys, access tokens, personal email addresses, or raw customer records in this manifest. Hash the non-secret configuration, keep secrets in the runtime store, and preserve the denominator behind every measured rate.

Connection boundaries

Four checks before production data enters the workflow

Security posture cannot be inferred from a page design. Use published documentation, package inspection, runtime configuration, provider terms, and your own technical review to confirm actual behavior.

API keys

Store outside prompts

Use the secret mechanism supported by your chosen runtime. Scope, rotate, and revoke credentials through the provider process.

Package execution

Read what the installer does

Review package output, requested access, network behavior, update path, and uninstall procedure before allowing sensitive workflows.

Data retention

Map every storage location

Account for agent history, logs, provider retention, generated files, exports, and downstream destinations. Assign deletion ownership.

Failure recovery

Stop on ambiguity

Rate limits, authentication errors, conflicting fields, and missing evidence should produce visible failure states instead of plausible guesses.

Install reference

Move through four distinct runtime states

CopyClipboard contains the exact command.
RunInstaller finishes in a terminal you control.
ConfigureOnly required tools and scoped credentials respond.
First resultA reviewer can trace, challenge, and classify the output.
npx -y @okki-global/okki-go-taroball

Copying does not execute the package or authorize a connection.