Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add footprintjs -- npx -y footprintjs@12.2.0รันในเทอร์มินัล
{ "mcpServers": { "footprintjs": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
FootPrint is the flowchart pattern for inspectable workflows. Write your logic as named stages, tracked state, and explicit decisions. As the workflow executes, FootPrint captures connected evidence of its data activity, execution path, and evaluated decisions.
The evidence is captured during execution—not reconstructed by an LLM afterward. People and AI agents can investigate the same recorded run. No model is required to generate the record.
TypeScript workflow engine that records each run's stages, state changes and decision evidence, so AI agents and people can explain and debug what happened.
An image export is rejected. The application did not crash. It produced an outcome somebody needs to investigate.
Messages such as “Image loaded,” “Resolution checked,” and “Export rejected” leave questions unanswered: which width was checked, where did it come from, and which rule selected rejection?
FootPrint records tracked data activity and evaluated decision evidence as the flow executes. Its control-dependency recorder connects executed branches to their governing decisions. Later queries follow that evidence; they do not ask a model to invent the connections.
This example uses synthetic image metadata and performs no real export. The execution output below comes from the reviewed run with footprintjs 10.0.0 and foottrace 1.0.3.
Requires Node.js 22 or newer. To use the same library versions:
npm install [email protected] [email protected]
Save the following as example.mts and run it with your TypeScript runner, for example npx tsx example.mts.
Why two import paths? Recorders belong to the execution engine (footprintjs/trace); querying the captured record belongs to foottrace.
import { flowChart, decide, FlowChartExecutor } from 'footprintjs';
import { controlDepRecorder } from 'footprintjs/trace';
type ExportState = {
width: number;
status: 'exported' | 'rejected';
};
const chart = flowChart<ExportState>('LoadImage', (scope) => {
scope.width = 640; // Example data; no image service is called.
}, 'load-image')
.addDeciderFunction('CheckResolution', (scope) => decide(scope, [
{
when: { width: { gte: 1280 } },
then: 'export',
label: 'Image is wide enough',
},
], 'reject'), 'check-resolution')
.addFunctionBranch('export', 'ExportImage', (scope) => {
scope.status = 'exported';
})
.addFunctionBranch('reject', 'RejectExport', (scope) => {
scope.status = 'rejected';
})
.setDefault('reject')
.end()
.build();
const executor = new FlowChartExecutor(chart);
const control = controlDepRecorder();
// Enable before execution: collect the narrative and governing decisions.
executor.setReadTracking('full');
executor.enableNarrative();
executor.attachCombinedRecorder(control);
await executor.run();
const snapshot = executor.getSnapshot();
console.log(snapshot.sharedState.status); // Expected: "rejected".
console.log(executor.getNarrativeEntries().map(e => e.text).join('\n'));
console.dir(control.getDecisions(), { depth: null });
import {
causalChain,
findLastWriter,
formatCausalChain,
keysReadFromExecutionTree,
} from 'foottrace';
// Continue from the completed run above.
const writer = findLastWriter(snapshot.commitLog, 'status');
if (!writer) throw new Error('No recorded writer for status.');
const reads = keysReadFromExecutionTree(snapshot.executionTree);
const chain = causalChain(
snapshot.commitLog,
writer.runtimeStageId,
reads.lookup,
{ controlDeps: control.asLookup() },
);
if (!chain) throw new Error('No causal chain.');
console.log(formatCausalChain(chain));
Narrative excerpt from the reviewed run:
Stage 1: The process began with LoadImage.
Step 1: Write width = 640
Stage 2: Next, it moved on to CheckResolution.
Step 1: Read width = 640
[Condition]: No rules matched, fell back to default: RejectExport.
Stage 3: Next, it moved on to RejectExport.
Step 1: Write status = "rejected"
The structured decision record also reports the evaluated condition: width, operator gte, threshold 1280, observed value 640, result false. That evidence comes from the rule evaluation—not from an LLM describing it afterward.
The dependency query prints:
RejectExport (reject#2) [wrote: status]
CheckResolution (check-resolution#1) ← [control]
LoadImage (load-image#0) ← via width [wrote: width]
The rejection is connected to the decision; the decision is connected to the value's producer. RejectExport writes a constant status without reading width, so data dependencies alone would miss the governing decision. The controlDeps lookup supplies that connection.
The next question might be: “Did LoadImage load a thumbnail instead of the original?” That remains a hypothesis to investigate. The record establishes the observed path, not whether 1280 is the right requirement or whether the correct source was loaded.
FootPrint works in ordinary applications that have no LLM at runtime. Your coding agent can use the recorded run while it builds and debugs the application.
The development loop is straightforward:
Send the relevant trace slice to the coding agent. A focused slice can reduce the log context you need to provide; actual token use and development speed depend on the model, tooling, and workflow. The record gives the agent evidence to work from, while missing evidence stays unknown.
Give your coding agent this instruction:
Build this workflow with FootPrint. Track relevant state, use explicit decision helpers, and attach the required recorders before execution. When an outcome is wrong, inspect its recorded producer, inputs, and governing decisions. Separate established evidence from hypotheses, keep missing evidence unknown, and verify each repair with a regression test and a new run.
Start with the AI instruction files and AGENTS.md.
A running agent can consume workflow results and their evidence to investigate or explain an outcome. AgentFootprint applies this approach to agent workflows, including context and tool activity. In both uses, the model reads evidence; it does not create the execution history.
FootPrint can be the execution foundation for a reusable library, as well as an application. Use it at meaningful workflow boundaries, not necessarily around every helper function. A library can expose a focused API while retaining the recorded steps and decisions behind its results.
These libraries have different dependencies and maturity. They do not all require AgentFootprint: StoryReel and Datapipeline use FootPrint directly, Smallbusiness builds on Blueprint, and StoryDeck makes its FootPrint integration optional. StoryReel's pipeline is a concrete example beyond agent applications.
When those workflows capture the required evidence, a person or coding agent can follow a result back through the library's recorded execution instead of working from disconnected messages. Evidence that was not captured remains unknown.
Foottrace reads supported saved records without the original flowchart engine or an AI provider. Its foottrace/write entry also owns record-writing primitives. Import it directly when using its queries.
For offline investigation, persist the evidence each reader needs—not just the final result. This example queries one live run; storage, retention, access control, and preservation of control relationships across recording boundaries require application design.
Use addRetryLoop when an outside operation may happen even though its response is lost. It puts the attempt, reconciliation, decision and wait into ordinary chart nodes. Each logical execution keeps one operation key; another send requires an authoritative none result. An uncertain reconciliation stops by default.
See the builder rule and in-memory example and the runnable keyed-retry example. Physical call outcomes remain unchanged; separate retryLoop metadata records the workflow pass and decision.
attempts() from footprintjs/recorders collects payload-free attempt facts during traversal. Use byTarget(),
byRun(), bounded slowest() exemplars and series() to follow native calls and explicit retry decisions; optional
AttemptStore adapters support cross-run queries. Row/exemplar/I/O limits disclose omitted or pending evidence.
toOTel() returns histogram/sum JSON without sending it anywhere. Durations are summed work time; orchestration
completion is not provider confirmation. See the metric guide and
the stored-trace navigation example.
For provenance, European governance terminology, disclosure controls, OpenTelemetry, vocabulary, and recording boundaries, read Provenance, governance and limits.
Capture the connections during execution. Let people and agents investigate the evidence.
TypeScript workflow engine that records each run's stages, state changes and decision evidence, so AI agents and people can explain and debug what happened.
{ "mcpServers": { "footprintjs": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Footprintjs ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-14 TypeScript workflow engine that records each run's stages, state changes and decision evidence, so AI agents and people can explain and debug what happened.